@iobroker/gui-components 8.0.1

package/README.md

@@ -0,0 +1,1450 @@
+# Help ReactJS classes for adapter config
+
+You can find demo on https://github.com/ioBroker/adapter-react-demo
+
+## Getting started
+
+If you want to create the configuration page with ReactJS:
+
+1. Create github repo for adapter.
+2. execute `npx create-react-app src` . It will take a while.
+3. `cd src`
+4. Modify package.json file in src directory:
+    - Change `name` from `src` to `ADAPTERNAME-admin` (Of course replace `ADAPTERNAME` with yours)
+    - Add to devDependencies:
+        ```json
+        "@iobroker/adapter-react-v5": "^7.4.10",
+        ```
+        Versions can be higher.
+        So your `src/package.json` should look like:
+
+```json
+{
+    "name": "ADAPTERNAME-admin",
+    "version": "0.1.0",
+    "private": true,
+    "dependencies": {
+        "@iobroker/adapter-react-v5": "^7.4.10",
+        "@iobroker/build-tools": "^1.0.0",
+        "babel-eslint": "^10.1.0",
+        "react-scripts": "^5.0.1"
+    },
+    "scripts": {
+        "start": "react-scripts start",
+        "build": "react-scripts build",
+        "test": "react-scripts test",
+        "eject": "react-scripts eject"
+    },
+    "eslintConfig": {
+        "extends": "react-app"
+    },
+    "homepage": ".",
+    "browserslist": [">0.2%", "not dead", "not ie <= 11", "not op_mini all"]
+}
+```
+
+5. Call in `src`: `npm install`
+6. Copy `tasks.js` into `src`: `cp node_modules/@iobroker/adapter-react-v5/tasks.js tasks.js`
+7. Add scripts to your `package.json` `scripts` section:
+
+```json
+"scripts": {
+    "0-clean": "node tasks --0-clean",
+    "1-npm": "node tasks --1-npm",
+    "2-build": "node tasks --2-build",
+    "3-copy": "node tasks --3-copy",
+    "4-patch": "node tasks --4-patch",
+    "build": "node tasks"
+}
+```
+
+7. Start your dummy application `npm run start` for developing or build with `npm run build` and
+   copy files in `build` directory to `www` or to `admin`. In the admin you must rename `index.html` to `index_m.html`.
+8. You can do that with `npm` tasks: `npm run build`
+
+## Development
+
+1. Add `socket.io` to `public/index.html`.
+   After
+
+```html
+<link
+    rel="manifest"
+    href="%PUBLIC_URL%/manifest.json"
+/>
+```
+
+insert
+
+```html
+<script>
+    const script = document.createElement('script');
+    window.registerSocketOnLoad = function (cb) {
+        window.socketLoadedHandler = cb;
+    };
+    const parts = (window.location.search || '').replace(/^\?/, '').split('&');
+    const query = {};
+    parts.forEach(item => {
+        const [name, val] = item.split('=');
+        query[decodeURIComponent(name)] = val !== undefined ? decodeURIComponent(val) : true;
+    });
+    script.onload = function () {
+        typeof window.socketLoadedHandler === 'function' && window.socketLoadedHandler();
+    };
+    script.src =
+        window.location.port === '3000'
+            ? window.location.protocol +
+              '//' +
+              (query.host || window.location.hostname) +
+              ':' +
+              (query.port || 8081) +
+              '/lib/js/socket.io.js'
+            : '%PUBLIC_URL%/../../lib/js/socket.io.js';
+
+    document.head.appendChild(script);
+</script>
+```
+
+3. Add to App.js constructor initialization for I18n:
+
+```jsx
+class App extends GenericApp {
+    constructor(props) {
+        const extendedProps = { ...props };
+        extendedProps.encryptedFields = ['pass']; // this parameter will be encrypted and decrypted automatically
+        extendedProps.translations = {
+            en: require('./i18n/en'),
+            de: require('./i18n/de'),
+            ru: require('./i18n/ru'),
+            pt: require('./i18n/pt'),
+            nl: require('./i18n/nl'),
+            fr: require('./i18n/fr'),
+            it: require('./i18n/it'),
+            es: require('./i18n/es'),
+            pl: require('./i18n/pl'),
+            uk: require('./i18n/uk'),
+            'zh-cn': require('./i18n/zh-cn'),
+        };
+        // get actual admin port
+        extendedProps.socket = { port: parseInt(window.location.port, 10) };
+
+        // Only if close, save buttons are not required at the bottom (e.g. if admin tab)
+        // extendedProps.bottomButtons = false;
+
+        // only for debug purposes
+        if (extendedProps.socket.port === 3000) {
+            extendedProps.socket.port = 8081;
+        }
+
+        // allow to manage GenericApp the sentry initialisation or do not set the sentryDSN if no sentry available
+        extendedProps.sentryDSN = 'https://yyy@sentry.iobroker.net/xx';
+
+        super(extendedProps);
+    }
+    // ...
+}
+```
+
+4. Replace `index.js` with the following code to support themes:
+
+```jsx
+import React from 'react';
+import { createRoot } from 'react-dom/client';
+import * as serviceWorker from './serviceWorker';
+
+import './index.css';
+import App from './App';
+import { version } from '../package.json';
+
+console.log(`iobroker.scenes@${version}`);
+
+const container = document.getElementById('root');
+const root = createRoot(container);
+root.render(<App />);
+
+// If you want your app to work offline and load faster, you can change
+// unregister() to register() below. Note this comes with some pitfalls.
+// Learn more about service workers: http://bit.ly/CRA-PWA
+serviceWorker.unregister();
+```
+
+5. Add to App.js encoding and decoding of values:
+
+```jsx
+class App extends GenericApp {
+    // ...
+    onPrepareLoad(settings) {
+        settings.pass = this.decode(settings.pass);
+    }
+    onPrepareSave(settings) {
+        settings.pass = this.encode(settings.pass);
+    }
+}
+```
+
+6. The optional step is to validate the data to be saved:
+
+```jsx
+onPrepareSave(settings) {
+     super.onPrepareSave(settings);
+     if (DATA_INVALID) {
+         return false; // configuration will not be saved
+     } else {
+         return true;
+     }
+ }
+```
+
+## Components
+
+### Connection.tsx
+
+This is a non-React class to provide the communication for socket connection with the server.
+
+### GenericApp.tsx
+
+### i18n.ts
+
+### Theme.tsx
+
+### Dialogs
+
+Some dialogs are predefined and could be used out of the box.
+
+#### Confirm.tsx
+
+<!-- TODO: Provide screenshot here -->
+
+Usage:
+
+```jsx
+import React from 'react';
+import { I18n, Confirm as ConfirmDialog } from '@iobroker/adapter-react-v5';
+
+class ExportImportDialog extends React.Component {
+    constructor(props) {
+        super(props);
+
+        this.state = {
+            confirmDialog: false,
+        };
+    }
+
+    renderConfirmDialog() {
+        if (!this.state.confirmDialog) {
+            return null;
+        }
+        return (
+            <ConfirmDialog
+                title={I18n.t('Scene will be overwritten.')}
+                text={I18n.t('All data will be lost. Confirm?')}
+                ok={I18n.t('Yes')}
+                cancel={I18n.t('Cancel')}
+                suppressQuestionMinutes={5}
+                dialogName="myConfirmDialogThatCouldBeSuppressed"
+                suppressText={I18n.t('Suppress question for next %s minutes', 5)}
+                onClose={isYes => {
+                    this.setState({ confirmDialog: false });
+                }}
+            />
+        );
+    }
+    render() {
+        return (
+            <div>
+                <Button onClick={() => this.setState({ confirmDialog: true })}>Click</Button>
+                {this.renderConfirmDialog()}
+            </div>
+        );
+    }
+}
+
+export default ExportImportDialog;
+```
+
+#### Error.tsx
+
+<!-- TODO: Provide screenshot here -->
+
+#### Message.tsx
+
+<!-- TODO: Provide screenshot here -->
+
+```jsx
+renderMessage() {
+   if (this.state.showMessage) {
+      return <Message
+         text={this.state.showMessage}
+         onClose={() => this.setState({showMessage: false})}
+      />;
+   } else {
+      return null;
+   }
+}
+```
+
+#### SelectID.tsx
+
+![Logo](img/selectID.png)
+
+```jsx
+import { SelectID as DialogSelectID } from '@iobroker/adapter-react-v5';
+
+class MyComponent extends Component {
+    constructor(props) {
+        super(props);
+        this.state = {
+            showSelectId: false,
+        };
+    }
+
+    renderSelectIdDialog() {
+        if (this.state.showSelectId) {
+            return (
+                <DialogSelectID
+                    key="tableSelect"
+                    imagePrefix="../.."
+                    dialogName={this.props.adapterName}
+                    themeType={this.props.themeType}
+                    socket={this.props.socket}
+                    statesOnly={true}
+                    selected={this.state.selectIdValue}
+                    onClose={() => this.setState({ showSelectId: false })}
+                    onOk={(selected, name) => {
+                        this.setState({ showSelectId: false, selectIdValue: selected });
+                    }}
+                />
+            );
+        } else {
+            return null;
+        }
+    }
+    render() {
+        return renderSelectIdDialog();
+    }
+}
+```
+
+#### Cron
+
+Include `"react-text-mask": "^5.4.3",` in package.json.
+
+<!-- TODO: Provide screenshot here -->
+
+```jsx
+function renderCron() {
+    if (!showCron) {
+        return null;
+    } else {
+        return (
+            <DialogCron
+                key="dialogCron1"
+                cron={this.state.cronValue || '* * * * *'}
+                onClose={() => this.setState({ showCron: false })}
+                onOk={cronValue => {
+                    this.setState({ cronValue });
+                }}
+            />
+        );
+    }
+}
+```
+
+### Components
+
+#### Utils.tsx
+
+##### getObjectNameFromObj
+
+`getObjectNameFromObj(obj, settings, options, isDesc)`
+
+Get object name from a single object.
+
+Usage: `Utils.getObjectNameFromObj(this.objects[id], null, {language: I18n.getLanguage()})`
+
+##### getObjectIcon
+
+`getObjectIcon(id, obj)`
+
+Get icon from the object.
+
+Usage:
+
+```jsx
+const icon = Utils.getObjectIcon(id, this.objects[id]);
+return <img src={icon} />;
+```
+
+##### isUseBright
+
+`isUseBright(color, defaultValue)`
+
+Usage: `
+
+#### Loader.tsx
+
+![Logo](img/loader.png)
+
+```jsx
+render() {
+     if (!this.state.loaded) {
+         return <MuiThemeProvider theme={this.state.theme}>
+             <Loader theme={this.state.themeType}/>
+         </MuiThemeProvider>;
+     }
+     // render loaded data
+}
+
+```
+
+#### Logo.tsx
+
+![Logo](img/logo.png)
+
+```jsx
+render() {
+   return <form className={this.props.classes.tab}>
+      <Logo
+       instance={this.props.instance}
+       common={this.props.common}
+       native={this.props.native}
+       onError={text => this.setState({errorText: text})}
+       onLoad={this.props.onLoad}
+      />
+      ...
+   </form>;
+}
+```
+
+#### Router.tsx
+
+#### ObjectBrowser.js
+
+It is better to use `Dialog/SelectID`, but if you want:
+
+![Logo](img/objectBrowser.png)
+
+```jsx
+<ObjectBrowser
+    foldersFirst={this.props.foldersFirst}
+    imagePrefix={this.props.imagePrefix || this.props.prefix} // prefix is for back compatibility
+    defaultFilters={this.filters}
+    dialogName={this.dialogName}
+    showExpertButton={this.props.showExpertButton !== undefined ? this.props.showExpertButton : true}
+    style={{ width: '100%', height: '100%' }}
+    columns={this.props.columns || ['name', 'type', 'role', 'room', 'func', 'val']}
+    types={this.props.types || ['state']}
+    t={I18n.t}
+    lang={this.props.lang || I18n.getLanguage()}
+    socket={this.props.socket}
+    selected={this.state.selected}
+    multiSelect={this.props.multiSelect}
+    notEditable={this.props.notEditable === undefined ? true : this.props.notEditable}
+    name={this.state.name}
+    theme={this.props.theme}
+    themeName={this.props.themeName}
+    themeType={this.props.themeType}
+    customFilter={this.props.customFilter}
+    onFilterChanged={filterConfig => {
+        this.filters = filterConfig;
+        window.localStorage.setItem(this.dialogName, JSON.stringify(filterConfig));
+    }}
+    onSelect={(selected, name, isDouble) => {
+        if (JSON.stringify(selected) !== JSON.stringify(this.state.selected)) {
+            this.setState({ selected, name }, () => isDouble && this.handleOk());
+        } else if (isDouble) {
+            this.handleOk();
+        }
+    }}
+/>
+```
+
+#### TreeTable.ts
+
+![Logo](img/tableTree.png)
+
+```jsx
+// STYLES
+const styles = {
+    tableDiv: {
+        width: '100%',
+        overflow: 'hidden',
+        height: 'calc(100% - 48px)',
+    },
+};
+class MyComponent extends Component {
+    constructor(props) {
+        super(props);
+
+        this.state = {
+            data: [
+                {
+                    id: 'UniqueID1', // required
+                    fieldIdInData: 'Name1',
+                    myType: 'number',
+                },
+                {
+                    id: 'UniqueID2', // required
+                    fieldIdInData: 'Name12',
+                    myType: 'string',
+                },
+            ],
+        };
+
+        this.columns = [
+            {
+                title: 'Name of field', // required, else it will be "field"
+                field: 'fieldIdInData', // required
+                editable: false, // or true [default - true]
+                cellStyle: {
+                    // CSS style - // optional
+                    maxWidth: '12rem',
+                    overflow: 'hidden',
+                    wordBreak: 'break-word',
+                },
+                lookup: {
+                    // optional => edit will be automatically "SELECT"
+                    value1: 'text1',
+                    value2: 'text2',
+                },
+            },
+            {
+                title: 'Type', // required, else it will be "field"
+                field: 'myType', // required
+                editable: true, // or true [default - true]
+                lookup: {
+                    // optional => edit will be automatically "SELECT"
+                    number: 'Number',
+                    string: 'String',
+                    boolean: 'Boolean',
+                },
+                type: 'number/string/color/oid/icon/boolean', // oid=ObjectID,icon=base64-icon
+                editComponent: props => (
+                    <div>
+                        Prefix&#123; <br />
+                        <textarea
+                            rows={4}
+                            style={{ width: '100%', resize: 'vertical' }}
+                            value={props.value}
+                            onChange={e => props.onChange(e.target.value)}
+                        />
+                        Suffix
+                    </div>
+                ),
+            },
+        ];
+    }
+    // renderTable
+    render() {
+        return (
+            <div className={this.props.classes.tableDiv}>
+                <TreeTable
+                    columns={this.columns}
+                    data={this.state.data}
+                    onUpdate={(newData, oldData) => {
+                        const data = JSON.parse(JSON.stringify(this.state.data));
+
+                        // Added new line
+                        if (newData === true) {
+                            // find unique ID
+                            let i = 1;
+                            let id = 'line_' + i;
+
+                            // eslint-disable-next-line
+                            while (this.state.data.find(item => item.id === id)) {
+                                i++;
+                                id = 'line_' + i;
+                            }
+
+                            data.push({
+                                id,
+                                name: I18n.t('New resource') + '_' + i,
+                                color: '',
+                                icon: '',
+                                unit: '',
+                                price: 0,
+                            });
+                        } else {
+                            // existing line was modifed
+                            const pos = this.state.data.indexOf(oldData);
+                            if (pos !== -1) {
+                                Object.keys(newData).forEach(attr => (data[pos][attr] = newData[attr]));
+                            }
+                        }
+
+                        this.setState({ data });
+                    }}
+                    onDelete={oldData => {
+                        console.log('Delete: ' + JSON.stringify(oldData));
+                        const pos = this.state.data.indexOf(oldData);
+                        if (pos !== -1) {
+                            const data = JSON.parse(JSON.stringify(this.state.data));
+                            data.splice(pos, 1);
+                            this.setState({ data });
+                        }
+                    }}
+                />
+            </div>
+        );
+    }
+}
+```
+
+#### Toast
+
+<!-- TODO: Provide screenshot here -->
+
+Toast is not a part of `adapter-react` but it is an example how to use toast in application:
+
+```jsx
+import { Component } from 'react';
+import { Snackbar } from '@mui/material';
+
+class MyComponent extends Component {
+    constructor(props) {
+        super(props);
+        this.state = {
+            // ....
+            toast: '',
+        };
+    }
+
+    // ...
+    renderToast() {
+        if (!this.state.toast) {
+            return null;
+        }
+        return (
+            <Snackbar
+                anchorOrigin={{
+                    vertical: 'bottom',
+                    horizontal: 'left',
+                }}
+                open={true}
+                autoHideDuration={6000}
+                onClose={() => this.setState({ toast: '' })}
+                ContentProps={{ 'aria-describedby': 'message-id' }}
+                message={<span id="message-id">{this.state.toast}</span>}
+                action={[
+                    <IconButton
+                        key="close"
+                        aria-label="Close"
+                        color="inherit"
+                        className={this.props.classes.close}
+                        onClick={() => this.setState({ toast: '' })}
+                    >
+                        <IconClose />
+                    </IconButton>,
+                ]}
+            />
+        );
+    }
+
+    render() {
+        return <div>{this.renderToast()}</div>;
+    }
+}
+```
+
+## List of adapters that use adapter-react
+
+-   Admin
+-   Backitup
+-   iot
+-   echarts
+-   text2command
+-   scenes
+-   javascript
+-   devices
+-   eventlist
+-   cameras
+-   web
+-   vis-2
+-   vis-2-widgets-xxx
+-   fullcalendar
+-   openweathermap
+
+## Usability
+
+In dialogs, the OK button is first (on the left) and the cancel button is last (on the right)
+
+## Used icons
+
+This project uses icons from [Flaticon](https://www.flaticon.com/).
+
+ioBroker GmbH has a valid license for all the used icons.
+The icons may not be reused in other projects without the proper flaticon license or flaticon subscription.
+
+## Migration instructions
+
+You can find the migration instructions:
+
+-   [from adapter-react-v5@6.x to adapter-react-v5@7.x](MIGRATION_6_7.md)
+-   [from adapter-react-v5@5.x to adapter-react-v5@6.x](MIGRATION_5_6.md)
+-   [from adapter-react to adapter-react-v5@5.x](MIGRATION_4_5.md)
+
+<!--
+	Placeholder for the next version (at the beginning of the line):
+	### **WORK IN PROGRESS**
+-->
+
+## Changelog
+### 8.0.1 (2025-10-23)
+
+-   (@GermanBluefox) Split packages from mono-repo
+
+### 7.2.3 (2024-10-05)
+
+-   (@GermanBluefox) Corrected error in the simple CRON dialog
+
+### 7.2.2 (2024-10-04)
+
+-   (@GermanBluefox) Small layout change for Icon Picker
+
+### 7.2.1 (2024-09-30)
+
+-   (@GermanBluefox) Allowed using an array of elements in dialogs
+-   (@GermanBluefox) Allowed to use `socket.iob` instead of `socket.io`
+
+### 7.1.4 (2024-09-15)
+
+-   (@GermanBluefox) Updated socket classes
+
+### 7.1.3 (2024-09-15)
+
+-   (@GermanBluefox) Updated socket classes
+-   (@GermanBluefox) Added additional confirmation dialog for CRONs for every minute execution
+
+### 7.1.1 (2024-09-13)
+
+-   (@GermanBluefox) Corrected TabContainer
+
+### 7.1.0 (2024-09-12)
+
+-   (@GermanBluefox) Optimized the icon picker
+-   (@GermanBluefox) Used common eslint-config
+
+### 7.0.2 (2024-09-10)
+
+-   (@GermanBluefox) Showed the context menu under cursor position in the object browser
+-   (@GermanBluefox) Added links to aliases in the object browser
+
+### 7.0.1 (2024-08-29)
+
+-   (@GermanBluefox) Updated the object browser
+-   (@GermanBluefox) Used MUI Library 6.0
+
+### 6.1.10 (2024-08-30)
+
+-   (@GermanBluefox) Updated the object browser
+
+### 6.1.9 (2024-08-14)
+
+-   (@GermanBluefox) Updated JSON schema
+
+### 6.1.8 (2024-08-03)
+
+-   (@GermanBluefox) Added translations
+
+### 6.1.6 (2024-07-23)
+
+-   (@GermanBluefox) Optimize package
+
+### 6.1.5 (2024-07-20)
+
+-   (@GermanBluefox) Added sources to package
+
+### 6.1.3 (2024-07-20)
+
+-   (@GermanBluefox) Better typing of legacy connection
+
+### 6.1.1 (2024-07-16)
+
+-   (@GermanBluefox) Added translations
+
+### 6.1.0 (2024-07-15)
+
+-   (@GermanBluefox) Replace by CRON to text the package to `cronstrue`
+
+### 6.0.19 (2024-07-14)
+
+-   (@GermanBluefox) added some packages for federation
+
+### 6.0.17 (2024-07-14)
+
+-   (@GermanBluefox) Allowed playing mp3 files in the file browser
+-   (@GermanBluefox) Corrected jump by object selection
+
+### 6.0.14 (2024-07-07)
+
+-   (@GermanBluefox) Corrected theme type selection
+
+### 6.0.13 (2024-06-30)
+
+-   (@GermanBluefox) Corrected color picker
+
+### 6.0.12 (2024-06-29)
+
+-   (@GermanBluefox) Added support for the overrides in the theme
+
+### 6.0.10 (2024-06-27)
+
+-   (@GermanBluefox) Added translation
+-   (@GermanBluefox) Mobile object browser improved
+
+### 6.0.9 (2024-06-26)
+
+-   (@GermanBluefox) Corrected Icons
+
+### 6.0.8 (2024-06-26)
+
+-   (@GermanBluefox) Corrected types of the select ID dialog
+-   (@GermanBluefox) Made the tooltips neutral to the pointer events
+
+### 6.0.6 (2024-06-24)
+
+-   (@GermanBluefox) Synchronised with admin
+-   (@GermanBluefox) Added translations for time scheduler
+
+### 6.0.4 (2024-06-21)
+
+-   (@GermanBluefox) Removed the usage of `withStyles` in favor of `sx` and `style` properties (see [Migration from v5 to v6](#migration-from-v5-to-v6)
+-   (@GermanBluefox) (BREAKING) Higher version of `@mui/material` (5.15.20) is used
+
+### 5.0.8 (2024-06-15)
+
+-   (@GermanBluefox) Added `modulefederation.admin.config.js` for module federation
+
+### 5.0.5 (2024-06-10)
+
+-   (@GermanBluefox) Sources were synchronized with admin
+
+### 5.0.4 (2024-06-07)
+
+-   (@GermanBluefox) Added better typing
+
+### 5.0.2 (2024-05-30)
+
+-   (@GermanBluefox) Added better typing
+-   (@GermanBluefox) Json-Config is now a separate package and must be installed additionally
+
+### 5.0.0 (2024-05-29)
+
+-   (@GermanBluefox) Types are now exported
+-   (@GermanBluefox) Translator renamed to Translate
+-   (@GermanBluefox) Breaking: Theme renamed to IobTheme because of the naming conflict
+
+### 4.13.24 (2024-05-25)
+
+-   (@GermanBluefox) Updated packages
+
+-   ### 4.13.22 (2024-05-23)
+-   (@GermanBluefox) Updated packages
+
+### 4.13.20 (2024-05-22)
+
+-   (@GermanBluefox) Better types added
+-   (@GermanBluefox) updated theme definitions
+-   (@GermanBluefox) corrected dates in cron dialog
+
+### 4.13.14 (2024-05-19)
+
+-   (@GermanBluefox) Updated packages
+
+### 4.13.13 (2024-05-09)
+
+-   (@GermanBluefox) Updated ioBroker types
+
+### 4.13.12 (2024-05-06)
+
+-   (@GermanBluefox) All files are migrated to Typescript
+
+### 4.13.11 (2024-04-23)
+
+-   (@GermanBluefox) Corrected the size of icons
+
+### 4.13.10 (2024-04-22)
+
+-   (@GermanBluefox) Migrated all icons to Typescript
+
+### 4.13.9 (2024-04-20)
+
+-   (@GermanBluefox) Updated socket-client package
+
+### 4.13.8 (2024-04-19)
+
+-   (@GermanBluefox) Corrected CRON selector
+
+### 4.13.7 (2024-04-19)
+
+-   (@GermanBluefox) Migrated ColorPicker to typescript
+
+### 4.13.6 (2024-04-11)
+
+-   (@GermanBluefox) Migrated TreeTable to typescript
+-   (@GermanBluefox) corrected the object subscription
+
+### 4.13.5 (2024-04-02)
+
+-   (@GermanBluefox) used new connection classes
+-   (@GermanBluefox) Improved the `SelectID` dialog
+
+### 4.13.3 (2024-04-01)
+
+-   (@GermanBluefox) used new connection classes
+
+### 4.12.3 (2024-03-30)
+
+-   (@GermanBluefox) Migrated legacy connection to typescript
+
+### 4.12.2 (2024-03-25)
+
+-   (@GermanBluefox) Added support for remote cloud
+
+### 4.11.6 (2024-03-19)
+
+-   (@GermanBluefox) Corrected rendering of LoaderMV
+
+### 4.11.4 (2024-03-18)
+
+-   (@GermanBluefox) Corrected types of IconPicker
+
+### 4.11.3 (2024-03-17)
+
+-   (@GermanBluefox) Made filters for the file selector dialog optional
+
+### 4.11.2 (2024-03-16)
+
+-   (@GermanBluefox) Migrated GenericApp to typescript
+
+### 4.10.4 (2024-03-16)
+
+-   (@GermanBluefox) Migrated some components to typescript
+
+### 4.10.1 (2024-03-11)
+
+-   (@GermanBluefox) Migrated some components to typescript
+
+### 4.9.11 (2024-03-08)
+
+-   (foxriver76) type GenericApp socket correctly
+
+### 4.9.10 (2024-02-21)
+
+-   (@GermanBluefox) translations
+-   (@GermanBluefox) updated JSON config
+
+### 4.9.9 (2024-02-16)
+
+-   (foxriver76) also check plugin state of instance to see if Sentry is explicitly disabled
+
+### 4.9.8 (2024-02-13)
+
+-   (@GermanBluefox) allowed hiding wizard in cron dialog
+
+### 4.9.7 (2024-02-03)
+
+-   (foxriver76) allow passing down the instance number do avoid determining from url
+
+### 4.9.5 (2024-01-01)
+
+-   (foxriver76) make `copyToClipboard` event parameter optional
+
+### 4.9.4 (2024-01-01)
+
+-   (foxriver76) try to fix `SelectID` scrolling
+
+### 4.9.2 (2023-12-30)
+
+-   (foxriver76) bump version of `@iobroker/json-config`
+
+### 4.9.1 (2023-12-22)
+
+-   (foxriver76) `@iobroker/json-config` moved to real dependencies
+
+### 4.9.0 (2023-12-22)
+
+-   (foxriver76) migrate to `@iobroker/json-config` module to have a single point of truth
+-   (@GermanBluefox) Allowed using of `filterFunc` as string
+
+### 4.8.1 (2023-12-14)
+
+-   (@GermanBluefox) Added Device manager to JSON Config
+
+### 4.7.15 (2023-12-12)
+
+-   (@GermanBluefox) Corrected parsing of a text
+
+### 4.7.13 (2023-12-10)
+
+-   (@GermanBluefox) Added possibility to define the root style and embedded property
+
+### 4.7.11 (2023-12-06)
+
+-   (@GermanBluefox) Extended color picker with "noInputField" option
+
+### 4.7.9 (2023-12-04)
+
+-   (@GermanBluefox) Corrected the icon picker
+
+### 4.7.8 (2023-12-04)
+
+-   (foxriver76) port to `@iobroker/types`
+
+### 4.7.6 (2023-11-29)
+
+-   (@GermanBluefox) Added translations
+
+### 4.7.5 (2023-11-28)
+
+-   (@GermanBluefox) Corrected subscribe on objects in the legacy connection
+
+### 4.7.4 (2023-11-23)
+
+-   (@GermanBluefox) Updated packages
+-   (@GermanBluefox) Made getStates method in legacy connection compatible with new one
+
+### 4.7.3 (2023-11-08)
+
+-   (@GermanBluefox) Updated packages
+
+### 4.7.2 (2023-11-03)
+
+-   (foxriver76) fixed problem with color picker, where editing TextField was buggy
+-   (foxriver76) fixed light mode color of a path in FileBrowser
+
+### 4.7.0 (2023-10-31)
+
+-   (@GermanBluefox) Synced with admin
+-   (@GermanBluefox) Added GIF to image files
+
+### 4.6.7 (2023-10-19)
+
+-   (@GermanBluefox) Added return value for `subscribeOnInstance` for Connection class
+
+### 4.6.6 (2023-10-13)
+
+-   (@GermanBluefox) Fixed the legacy connection
+
+### 4.6.5 (2023-10-12)
+
+-   (foxriver76) fixed object browser with date
+
+### 4.6.4 (2023-10-11)
+
+-   (@GermanBluefox) Updated the packages
+
+### 4.6.3 (2023-10-09)
+
+-   (@GermanBluefox) Just updated the packages
+-   (@GermanBluefox) Synced with admin
+
+### 4.6.2 (2023-09-29)
+
+-   (@GermanBluefox) Experimental feature added: update states on re-subscribe
+
+### 4.5.5 (2023-09-27)
+
+-   (@GermanBluefox) Added export for IconNoIcon
+
+### 4.5.4 (2023-09-17)
+
+-   (@GermanBluefox) Added the restricting to folder property for select file dialog
+
+### 4.5.3 (2023-08-20)
+
+-   (foxriver76) fixed css classes of TableResize, see https://github.com/ioBroker/ioBroker.admin/issues/1860
+
+### 4.5.2 (2023-08-20)
+
+-   (foxriver76) added missing export of TableResize
+
+### 4.5.1 (2023-08-19)
+
+-   (foxriver76) fix dialog TextInput
+
+### 4.5.0 (2023-08-18)
+
+-   (@GermanBluefox) Synchronize components with admin
+
+### 4.4.8 (2023-08-17)
+
+-   (@GermanBluefox) Added translations
+
+### 4.4.7 (2023-08-10)
+
+-   (@GermanBluefox) Added `subscribeStateAsync` method to wait for answer
+-   (@GermanBluefox) Added support for arrays for un/subscriptions
+
+### 4.4.5 (2023-08-01)
+
+-   (@GermanBluefox) Updated packages
+
+### 4.3.3 (2023-07-28)
+
+-   (@GermanBluefox) Added translations
+
+### 4.3.0 (2023-07-19)
+
+-   (@GermanBluefox) Updated packages
+-   (@GermanBluefox) Added translations
+-   (@GermanBluefox) Synced object browser
+-   (@GermanBluefox) formatting
+
+### 4.2.1 (2023-07-17)
+
+-   (@GermanBluefox) Updated packages
+-   (@GermanBluefox) Added translations
+
+### 4.2.0 (2023-07-07)
+
+-   (@GermanBluefox) Updated packages
+-   (@GermanBluefox) Added new method `getObjectsById` to the socket communication
+
+### 4.1.2 (2023-06-20)
+
+-   (@GermanBluefox) Allowed setting theme name directly by theme toggle
+
+### 4.1.0 (2023-05-10)
+
+-   (@GermanBluefox) `craco-module-federation.js` was added. For node 16
+
+### 4.0.27 (2023-05-09)
+
+-   (@GermanBluefox) Allowed showing only specific root in SelectIDDialog
+
+### 4.0.26 (2023-05-08)
+
+-   (@GermanBluefox) Added IDs to the buttons in the dialog for GUI tests
+
+### 4.0.25 (2023-04-23)
+
+-   (@GermanBluefox) Extended `TextWithIcon` with defined color and icon
+
+### 4.0.24 (2023-04-03)
+
+-   (@GermanBluefox) Updated the file selector in tile mode
+
+### 4.0.23 (2023-03-27)
+
+-   (@GermanBluefox) Added translations
+
+### 4.0.22 (2023-03-22)
+
+-   (@GermanBluefox) Re-Activate legacy connection
+
+### 4.0.21 (2023-03-22)
+
+-   (@GermanBluefox) Added translations
+
+### 4.0.20 (2023-03-21)
+
+-   (@GermanBluefox) Color picker was improved
+
+### 4.0.19 (2023-03-20)
+
+-   (@GermanBluefox) Packages were updated
+-   (@GermanBluefox) Added new translations
+
+### 4.0.18 (2023-03-16)
+
+-   (@GermanBluefox) Packages were updated
+
+### 4.0.17 (2023-03-15)
+
+-   (@GermanBluefox) Added translations
+-   (@GermanBluefox) Added port controller to JSON config
+
+### 4.0.15 (2023-03-12)
+
+-   (@GermanBluefox) Updated the object browser and file browser
+
+### 4.0.14 (2023-03-03)
+
+-   (@GermanBluefox) added handler of alert messages
+
+### 4.0.13 (2023-02-15)
+
+-   (@GermanBluefox) Corrected the theme button
+
+### 4.0.12 (2023-02-15)
+
+-   (@GermanBluefox) made the fix for `echarts`
+
+### 4.0.11 (2023-02-14)
+
+-   (@GermanBluefox) Updated packages
+-   (@GermanBluefox) The `chartReady` event was omitted
+
+### 4.0.10 (2023-02-10)
+
+-   (@GermanBluefox) Updated packages
+-   (@GermanBluefox) made the fix for `material`
+
+### 4.0.9 (2023-02-02)
+
+-   (@GermanBluefox) Updated packages
+
+### 4.0.8 (2022-12-19)
+
+-   (@GermanBluefox) Extended socket with `log` command
+
+### 4.0.6 (2022-12-19)
+
+-   (@GermanBluefox) Corrected URL for the connection
+
+### 4.0.5 (2022-12-14)
+
+-   (@GermanBluefox) Added support of custom palette for color picker
+
+### 4.0.2 (2022-12-01)
+
+-   (@GermanBluefox) use `@iobroker/socket-client` instead of `Connection.tsx`
+
+### 3.5.3 (2022-11-30)
+
+-   (@GermanBluefox) Improved `renderTextWithA` function to support `<b>` and `<i>` tags
+
+### 3.5.2 (2022-11-30)
+
+-   (@GermanBluefox) updated json config component
+
+### 3.4.1 (2022-11-29)
+
+-   (@GermanBluefox) Added button text for message dialog
+
+### 3.4.0 (2022-11-29)
+
+-   (@GermanBluefox) Added file selector
+
+### 3.3.0 (2022-11-26)
+
+-   (@GermanBluefox) Added subscribe on files
+
+### 3.2.7 (2022-11-13)
+
+-   (@GermanBluefox) Added `fullWidth` property to `Dialog`
+
+### 3.2.6 (2022-11-08)
+
+-   (xXBJXx) Improved TreeTable component
+
+### 3.2.5 (2022-11-08)
+
+-   (@GermanBluefox) Added the role filter for the object browser
+
+### 3.2.4 (2022-11-03)
+
+-   (@GermanBluefox) Added support for alfa channel for `invertColor`
+
+### 3.2.3 (2022-10-26)
+
+-   (@GermanBluefox) Corrected expert mode for object browser
+
+### 3.2.2 (2022-10-25)
+
+-   (@GermanBluefox) Added support for prefixes for translations
+
+### 3.2.1 (2022-10-24)
+
+-   (@GermanBluefox) Corrected color inversion
+
+### 3.2.0 (2022-10-19)
+
+-   (@GermanBluefox) Added ukrainian translation
+
+### 3.1.35 (2022-10-17)
+
+-   (@GermanBluefox) small changes for material
+
+### 3.1.34 (2022-08-24)
+
+-   (@GermanBluefox) Implemented fallback to english by translations
+
+### 3.1.33 (2022-08-24)
+
+-   (@GermanBluefox) Added support for onchange flag
+
+### 3.1.30 (2022-08-23)
+
+-   (@GermanBluefox) Added method `getCompactSystemRepositories`
+-   (@GermanBluefox) corrected error in `ObjectBrowser`
+
+### 3.1.27 (2022-08-01)
+
+-   (@GermanBluefox) Disable file editing in FileViewer
+
+### 3.1.26 (2022-08-01)
+
+-   (@GermanBluefox) Added translations
+-   (@GermanBluefox) JSON schema was extended with missing definitions
+
+### 3.1.24 (2022-07-28)
+
+-   (@GermanBluefox) Updated file browser and object browser
+
+### 3.1.23 (2022-07-25)
+
+-   (@GermanBluefox) Extend custom filter for object selector
+
+### 3.1.22 (2022-07-22)
+
+-   (@GermanBluefox) Added i18n tools for development
+
+### 3.1.20 (2022-07-14)
+
+-   (@GermanBluefox) Allowed to show select dialog with the expert mode enabled
+
+### 3.1.19 (2022-07-08)
+
+-   (@GermanBluefox) Allowed extending translations for all languages together
+
+### 3.1.18 (2022-07-06)
+
+-   (@GermanBluefox) Added translation
+
+### 3.1.17 (2022-07-05)
+
+-   (@GermanBluefox) Deactivate JSON editor for JSONConfig because of space
+
+### 3.1.16 (2022-06-27)
+
+-   (@GermanBluefox) Update object browser
+
+### 3.1.15 (2022-06-27)
+
+-   (@GermanBluefox) Allowed using of spaces in name
+
+### 3.1.14 (2022-06-23)
+
+-   (@GermanBluefox) Added translations
+
+### 3.1.11 (2022-06-22)
+
+-   (@GermanBluefox) Added preparations for iobroker cloud
+
+### 3.1.10 (2022-06-22)
+
+-   (@GermanBluefox) Added translations
+
+### 3.1.9 (2022-06-20)
+
+-   (@GermanBluefox) Allowed working behind reverse proxy
+
+### 3.1.7 (2022-06-19)
+
+-   (@GermanBluefox) Added file select dialog
+
+### 3.1.3 (2022-06-13)
+
+-   (@GermanBluefox) Added table with resized headers
+
+### 3.1.2 (2022-06-09)
+
+-   (@GermanBluefox) Added new document icon (read only)
+
+### 3.1.1 (2022-06-09)
+
+-   (@GermanBluefox) Allowed working behind reverse proxy
+
+### 3.1.0 (2022-06-07)
+
+-   (@GermanBluefox) Some german texts were corrected
+
+### 3.0.17 (2022-06-03)
+
+-   (@GermanBluefox) Allowed calling getAdapterInstances not for admin too
+
+### 3.0.15 (2022-06-01)
+
+-   (@GermanBluefox) Updated JsonConfigComponent: password, table
+
+### 3.0.14 (2022-05-25)
+
+-   (@GermanBluefox) Added ConfigGeneric to import
+
+### 3.0.7 (2022-05-25)
+
+-   (@GermanBluefox) Made the module definitions
+
+### 3.0.6 (2022-05-25)
+
+-   (@GermanBluefox) Added JsonConfigComponent
+
+### 2.1.11 (2022-05-24)
+
+-   (@GermanBluefox) Update file browser. It supports now the file changed events.
+
+### 2.1.10 (2022-05-24)
+
+-   (@GermanBluefox) Corrected object browser
+
+### 2.1.9 (2022-05-16)
+
+-   (@GermanBluefox) Corrected expert mode in object browser
+
+### 2.1.7 (2022-05-09)
+
+-   (@GermanBluefox) Changes were synchronized with adapter-react-v5
+-   (@GermanBluefox) Added `I18n.disableWarning` method
+
+### 2.1.6 (2022-03-28)
+
+-   (@GermanBluefox) Added `log` method to connection
+-   (@GermanBluefox) Corrected translations
+
+### 2.1.1 (2022-03-27)
+
+-   (@GermanBluefox) Corrected error in TreeTable
+
+### 2.1.0 (2022-03-26)
+
+-   (@GermanBluefox) BREAKING_CHANGE: Corrected error with readFile(base64=false)
+
+### 2.0.0 (2022-03-26)
+
+-   (@GermanBluefox) Initial version
+
+### 0.1.0 (2022-03-23)
+
+-   (@GermanBluefox) Fixed theme errors
+
+### 0.0.4 (2022-03-22)
+
+-   (@GermanBluefox) Fixed eslint warnings
+
+### 0.0.3 (2022-03-19)
+
+-   (@GermanBluefox) beta version
+
+### 0.0.2 (2022-02-24)
+
+-   (@GermanBluefox) try to publish a first version
+
+### 0.0.1 (2022-02-24)
+
+-   initial commit
+
+## License
+
+The MIT License (MIT)
+
+Copyright (c) 2019-2025 @GermanBluefox <dogafox@gmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.