@iobroker/adapter-react-v5 5.0.4 → 5.0.5

package/Components/ObjectBrowser.d.ts

@@ -4,7 +4,15 @@
  * MIT License
  *
  * */
-import React from 'react';
+import React, { Component } from 'react';
+import type Router from './Router';
+import type { ThemeType, ThemeName, IobTheme, Translate } from '../types';
+import Connection from '../Connection';
+declare module '@mui/material/Button' {
+    interface ButtonPropsColorOverrides {
+        grey: true;
+    }
+}
 declare global {
     interface Window {
         sparkline: {
@@ -12,6 +20,26 @@ declare global {
         };
     }
 }
+type ObjectEventType = 'new' | 'changed' | 'deleted';
+interface ObjectEvent {
+    id: string;
+    obj?: ioBroker.Object;
+    type: ObjectEventType;
+    oldObj?: ioBroker.Object;
+}
+interface ObjectsWorker {
+    getObjects(update?: boolean): Promise<void | Record<string, ioBroker.Object>>;
+    registerHandler(cb: (events: ObjectEvent[]) => void): void;
+    unregisterHandler(cb: (events: ObjectEvent[]) => void, doNotUnsubscribe?: boolean): void;
+}
+interface CustomAdminColumnStored {
+    path: string;
+    name: string;
+    objTypes?: ioBroker.ObjectType[];
+    width?: number;
+    edit?: boolean;
+    type?: ioBroker.CommonType;
+}
 export interface TreeItemData {
     id: string;
     name: string;
@@ -49,12 +77,19 @@ export interface TreeItemData {
     per?: boolean;
     lang?: ioBroker.Languages;
     state?: {
-        valFullRx?: React.JSX.Element[] | null;
         valTextRx?: React.JSX.Element[] | null;
         style?: React.CSSProperties;
     };
     aclTooltip?: null | React.JSX.Element;
 }
+interface ObjectBrowserCustomFilter {
+    type?: ioBroker.ObjectType | ioBroker.ObjectType[];
+    common?: {
+        type?: ioBroker.CommonType | ioBroker.CommonType[];
+        role?: string | string[];
+        custom?: '_' | '_dataSources' | true | string | string[];
+    };
+}
 export interface TreeItem {
     id?: string;
     data: TreeItemData;
@@ -62,5 +97,494 @@ export interface TreeItem {
 }
 export declare function getSelectIdIconFromObjects(objects: Record<string, ioBroker.Object>, id: string, imagePrefix?: string): string | React.JSX.Element | null;
 export declare const ITEM_IMAGES: Record<string, React.JSX.Element>;
+export interface ObjectBrowserFilter {
+    id?: string;
+    name?: string;
+    room?: string;
+    func?: string;
+    role?: string;
+    type?: string;
+    custom?: string;
+    expertMode?: boolean;
+}
+interface AdapterColumn {
+    adapter: string;
+    id: string;
+    name: string;
+    path: string[];
+    pathText: string;
+    edit?: boolean;
+    type?: 'boolean' | 'string' | 'number';
+    objTypes?: ioBroker.ObjectType[];
+    align?: 'center' | 'left' | 'right';
+}
+interface ObjectBrowserEditRoleProps {
+    classes: Record<string, string>;
+    roles: string[];
+    id: string;
+    socket: Connection;
+    onClose: (obj?: ioBroker.Object | null) => void;
+    t: Translate;
+}
+interface ObjectViewFileDialogProps {
+    t: Translate;
+    socket: Connection;
+    obj: ioBroker.AnyObject;
+    onClose: () => void;
+}
+interface DragWrapperProps {
+    item: TreeItem;
+    className: string;
+    children: React.JSX.Element | null;
+}
+interface ObjectCustomDialogProps {
+    t: Translate;
+    lang: ioBroker.Languages;
+    expertMode?: boolean;
+    objects: Record<string, ioBroker.Object>;
+    socket: Connection;
+    theme: IobTheme;
+    themeName: ThemeName;
+    themeType: ThemeType;
+    customsInstances: string[];
+    objectIDs: string[];
+    onClose: () => void;
+    reportChangedIds: (ids: string[]) => void;
+    isFloatComma: boolean;
+    classes: Record<string, string>;
+    allVisibleObjects: boolean;
+    systemConfig: ioBroker.SystemConfigObject;
+}
+interface ObjectBrowserValueProps {
+    /** Css classes */
+    classes: Record<string, string>;
+    /** State type */
+    type: 'states' | 'string' | 'number' | 'boolean' | 'json';
+    /** State role */
+    role: string;
+    /** common.states */
+    states: Record<string, string> | null;
+    /** The state value */
+    value: string | number | boolean | null;
+    /** If expert mode is enabled */
+    expertMode: boolean;
+    onClose: (newValue?: {
+        val: ioBroker.StateValue;
+        ack: boolean;
+        q: ioBroker.STATE_QUALITY[keyof ioBroker.STATE_QUALITY];
+        expire: number | undefined;
+    }) => void;
+    /** Configured theme */
+    themeType: ThemeType;
+    socket: Connection;
+    defaultHistory: string;
+    dateFormat: string;
+    object: ioBroker.StateObject;
+    isFloatComma: boolean;
+    t: Translate;
+    lang: ioBroker.Languages;
+}
+interface ObjectBrowserEditObjectProps {
+    classes: Record<string, string>;
+    socket: Connection;
+    obj: ioBroker.AnyObject;
+    roleArray: string[];
+    expertMode: boolean;
+    themeType: ThemeType;
+    aliasTab: boolean;
+    onClose: (obj?: ioBroker.AnyObject) => void;
+    dialogName?: string;
+    objects: Record<string, ioBroker.AnyObject>;
+    dateFormat: string;
+    isFloatComma: boolean;
+    onNewObject: (obj: ioBroker.AnyObject) => void;
+    t: Translate;
+}
+interface ObjectAliasEditorProps {
+    t: Translate;
+    socket: Connection;
+    objects: Record<string, ioBroker.AnyObject>;
+    onRedirect: (id: string, delay?: number) => void;
+    obj: ioBroker.AnyObject;
+    onClose: () => void;
+}
+interface ObjectBrowserProps {
+    /** where to store settings in localStorage */
+    dialogName?: string;
+    classes: Record<string, string>;
+    defaultFilters?: ObjectBrowserFilter;
+    selected?: string | string[];
+    onSelect?: (selected: string | string[], name: string, isDouble?: boolean) => void;
+    onFilterChanged?: (newFilter: ObjectBrowserFilter) => void;
+    socket: Connection;
+    showExpertButton?: boolean;
+    expertMode?: boolean;
+    imagePrefix?: string;
+    themeName: ThemeName;
+    themeType: ThemeType;
+    /** will be filled by withWidth */
+    width?: 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+    theme: IobTheme;
+    t: Translate;
+    lang: ioBroker.Languages;
+    multiSelect?: boolean;
+    notEditable?: boolean;
+    foldersFirst?: boolean;
+    disableColumnSelector?: boolean;
+    isFloatComma?: boolean;
+    dateFormat?: string;
+    levelPadding?: number;
+    objectCustomDialog?: React.FC<ObjectCustomDialogProps>;
+    objectAddBoolean?: boolean;
+    objectEditBoolean?: boolean;
+    objectStatesView?: boolean;
+    objectImportExport?: boolean;
+    objectEditOfAccessControl?: boolean;
+    /** modal add object */
+    modalNewObject?: (oBrowser: ObjectBrowserClass) => React.JSX.Element;
+    /** modal Edit Of Access Control */
+    modalEditOfAccessControl: (oBrowser: ObjectBrowserClass, data: TreeItemData) => React.JSX.Element;
+    onObjectDelete?: (id: string, hasChildren: boolean, objectExists: boolean, childrenCount: number) => void;
+    /** optional filter
+     *   `{common: {custom: true}}` - show only objects with some custom settings
+     *   `{common: {custom: 'sql.0'}}` - show only objects with sql.0 custom settings (only of the specific instance)
+     *   `{common: {custom: '_dataSources'}}` - show only objects of adapters `influxdb' or 'sql' or 'history'
+     *   `{common: {custom: 'adapterName.'}}` - show only objects of custom settings of specific adapter (all instances)
+     *   `{type: 'channel'}` - show only channels
+     *   `{type: ['channel', 'device']}` - show only channels and devices
+     *   `{common: {type: 'number'}` - show only states of type 'number
+     *   `{common: {type: ['number', 'string']}` - show only states of type 'number and string
+     *   `{common: {role: ['switch']}` - show only states with roles starting from switch
+     *   `{common: {role: ['switch', 'button']}` - show only states with roles starting from `switch` and `button`
+     */
+    customFilter: ObjectBrowserCustomFilter;
+    objectBrowserValue?: React.FC<ObjectBrowserValueProps>;
+    objectBrowserEditObject?: React.FC<ObjectBrowserEditObjectProps>;
+    /** on edit alias */
+    objectBrowserAliasEditor?: React.FC<ObjectAliasEditorProps>;
+    /** on Edit role */
+    objectBrowserEditRole?: React.FC<ObjectBrowserEditRoleProps>;
+    /** on view file state */
+    objectBrowserViewFile?: React.FC<ObjectViewFileDialogProps>;
+    router?: typeof Router;
+    types?: ioBroker.ObjectType[];
+    /** Possible columns: ['name', 'type', 'role', 'room', 'func', 'val', 'buttons'] */
+    columns?: string[];
+    /** Shows only elements of this root */
+    root?: string;
+    /** cache of objects */
+    objectsWorker?: ObjectsWorker;
+    /** function to filter out all unnecessary objects. It cannot be used together with "types"
+     * Example for function: `obj => obj.common?.type === 'boolean'` to show only boolean states
+     * */
+    filterFunc?: (obj: ioBroker.Object) => boolean;
+    /** Used for enums dragging */
+    DragWrapper?: React.FC<DragWrapperProps>;
+    /** let DragWrapper know about objects to get the icons */
+    setObjectsReference?: (objects: Record<string, ioBroker.Object>) => void;
+    dragEnabled?: boolean;
+}
+interface ObjectBrowserState {
+    loaded: boolean;
+    foldersFirst: boolean;
+    selected: string[];
+    selectedNonObject: string;
+    filter: ObjectBrowserFilter;
+    filterKey: number;
+    depth: number;
+    expandAllVisible: boolean;
+    expanded: string[];
+    toast: string;
+    scrollBarWidth: number;
+    customDialog: null | string[];
+    customDialogAll?: boolean;
+    editObjectDialog: string;
+    editObjectAlias: boolean;
+    viewFileDialog: string;
+    showAliasEditor: string;
+    enumDialog: null | {
+        item: TreeItem;
+        type: 'room' | 'func';
+        enumsOriginal: string;
+    };
+    enumDialogEnums?: null | string[];
+    roleDialog: null | string;
+    statesView: boolean;
+    /** ['name', 'type', 'role', 'room', 'func', 'val', 'buttons'] */
+    columns: string[] | null;
+    columnsForAdmin: Record<string, CustomAdminColumnStored[]> | null;
+    columnsSelectorShow: boolean;
+    columnsAuto: boolean;
+    columnsWidths: Record<string, number>;
+    columnsDialogTransparent: number;
+    columnsEditCustomDialog: null | {
+        obj: ioBroker.Object;
+        item: TreeItem;
+        it: AdapterColumn;
+    };
+    customColumnDialogValueChanged: boolean;
+    showExportDialog: false | number;
+    showAllExportOptions: boolean;
+    linesEnabled: boolean;
+    showDescription: boolean;
+    showContextMenu: {
+        item: TreeItem;
+        subItem?: string;
+        subAnchor?: HTMLLIElement;
+    } | null;
+    noStatesByExportImport: boolean;
+    beautifyJsonExport: boolean;
+    excludeSystemRepositoriesFromExport: boolean;
+    excludeTranslations: boolean;
+    updating?: boolean;
+    modalNewObj?: null | {
+        id: string;
+        initialType?: ioBroker.ObjectType;
+        initialStateType?: ioBroker.CommonType;
+    };
+    error?: undefined | any;
+    modalEditOfAccess?: boolean;
+    modalEditOfAccessObjData?: TreeItemData;
+    updateOpened?: boolean;
+    tooltipInfo: null | {
+        el: React.JSX.Element[];
+        id: string;
+    };
+}
+export declare class ObjectBrowserClass extends Component<ObjectBrowserProps, ObjectBrowserState> {
+    #private;
+    private info;
+    private localStorage;
+    private lastSelectedItems;
+    private lastAppliedFilter;
+    private readonly tableRef;
+    private readonly filterRefs;
+    private pausedSubscribes;
+    private selectedFound;
+    private root;
+    private readonly states;
+    private subscribes;
+    private unsubscribeTimer;
+    private statesUpdateTimer;
+    private objectsUpdateTimer;
+    private filterTimer;
+    private readonly visibleCols;
+    private readonly texts;
+    private readonly possibleCols;
+    private readonly imagePrefix;
+    private adapterColumns;
+    private edit;
+    private readonly levelPadding;
+    private customWidth;
+    private resizeTimeout;
+    private resizerNextName;
+    private resizerActiveName;
+    private resizerCurrentWidths;
+    private resizeLeft;
+    private resizerOldWidth;
+    private resizerMin;
+    private resizerNextMin;
+    private resizerOldWidthNext;
+    private resizerPosition;
+    private resizerActiveDiv;
+    private resizerNextDiv;
+    private storedWidths;
+    private systemConfig;
+    objects: Record<string, ioBroker.Object>;
+    private defaultHistory;
+    private columnsVisibility;
+    private changedIds;
+    private contextMenu;
+    private recordStates;
+    private customColumnDialog;
+    constructor(props: ObjectBrowserProps);
+    loadAllObjects(update?: boolean): Promise<void>;
+    /**
+     * Check if it is a non-expert id
+     */
+    static isNonExpertId(
+    /** id to test */
+    id: string): boolean;
+    private expandAllSelected;
+    /**
+     * @param isDouble is double click
+     */
+    private onAfterSelect;
+    private static getDerivedStateFromProps;
+    /**
+     * Called when component is mounted.
+     */
+    componentDidMount(): Promise<void>;
+    /**
+     * Called when component is unmounted.
+     */
+    componentWillUnmount(): void;
+    /**
+     * Show the deletion dialog for a given object
+     */
+    showDeleteDialog(options: {
+        id: string;
+        obj: ioBroker.Object;
+        item: TreeItem;
+    }): void;
+    /**
+     * Context menu handler.
+     */
+    onContextMenu: (e: MouseEvent) => void;
+    /**
+     * Called when component is mounted.
+     */
+    refreshComponent(): void;
+    /**
+     * Renders the error dialog.
+     */
+    renderErrorDialog(): React.JSX.Element | null;
+    /**
+     * Show the error dialog.
+     */
+    showError(error: any): void;
+    /**
+     * Called when an item is selected/deselected.
+     */
+    onSelect(toggleItem: string, isDouble?: boolean, cb?: () => void): void;
+    private _renderDefinedList;
+    /**
+     * Renders the columns' selector.
+     */
+    renderColumnsSelectorDialog(): React.JSX.Element | null;
+    private getAdditionalColumns;
+    private checkUnsubscribes;
+    /**
+     * Find an item.
+     */
+    findItem(id: string, _parts?: string[], _root?: TreeItem | null, _partyId?: string): TreeItem | null;
+    /**
+     * Called when a state changes.
+     */
+    onStateChange: (id: string, state?: ioBroker.State | null) => void;
+    private parseObjectForAdmins;
+    onObjectChangeFromWorker: (events: ObjectEvent[]) => void;
+    onObjectChange: (id: string, obj?: ioBroker.Object | null) => void;
+    afterObjectUpdated(): void;
+    /**
+     * Processes a single element in regard to certain filters, columns for admin and updates object dict
+     * @returns Returns an object containing the new state (if any) and whether the object was filtered.
+     */
+    processOnObjectChangeElement(
+    /** The id of the object */
+    id: string, 
+    /** The object itself */
+    obj?: ioBroker.Object | null): {
+        filtered: boolean;
+        newInnerState: null | {
+            columnsForAdmin: Record<string, CustomAdminColumnStored[]> | null;
+        };
+    };
+    private subscribe;
+    private unsubscribe;
+    private pauseSubscribe;
+    private onFilter;
+    clearFilter(): void;
+    isFilterEmpty(): boolean;
+    private getFilterInput;
+    private getFilterSelect;
+    private getFilterSelectRole;
+    private getFilterSelectRoom;
+    private getFilterSelectFunction;
+    private getFilterSelectType;
+    private getFilterSelectCustoms;
+    private onExpandAll;
+    private onCollapseAll;
+    private expandDepth;
+    private static collapseDepth;
+    private onExpandVisible;
+    private onStatesViewVisible;
+    private onCollapseVisible;
+    private getEnumsForId;
+    private _createAllEnums;
+    private loadObjects;
+    _getSelectedIdsForExport(): any[];
+    /**
+     * Exports the selected objects based on the given options and triggers file generation
+     */
+    private _exportObjects;
+    renderExportDialog(): React.JSX.Element;
+    private handleJsonUpload;
+    toolTipObjectCreating: () => string | React.JSX.Element[];
+    /**
+     * Renders the toolbar.
+     */
+    getToolbar(): React.JSX.Element;
+    private toggleExpanded;
+    private onCopy;
+    renderTooltipAccessControl: (acl: ioBroker.StateACL) => null | React.JSX.Element;
+    renderColumnButtons(id: string, item: TreeItem, classes: Record<string, string>): React.JSX.Element | React.JSX.Element[];
+    private readHistory;
+    private getTooltipInfo;
+    private renderColumnValue;
+    private _syncEnum;
+    private syncEnum;
+    private renderEnumDialog;
+    private renderEditRoleDialog;
+    private onColumnsEditCustomDialogClose;
+    private renderColumnsEditCustomDialog;
+    private static getCustomValue;
+    private static setCustomValue;
+    /**
+     * Renders a custom value.
+     */
+    renderCustomValue(obj: ioBroker.Object, it: AdapterColumn, item: TreeItem): React.JSX.Element | null;
+    /**
+     * Renders a leaf.
+     */
+    renderLeaf(item: TreeItem, isExpanded: boolean | undefined, classes: Record<string, string>, counter: {
+        count: number;
+    }): React.JSX.Element;
+    /**
+     * Renders an item.
+     */
+    renderItem(root: TreeItem, isExpanded: boolean | undefined, classes: Record<string, string>, counter?: {
+        count: number;
+    }): React.JSX.Element[];
+    private calculateColumnsVisibility;
+    resizerMouseMove: (e: MouseEvent) => void;
+    resizerMouseUp: () => void;
+    resizerMouseDown: (e: React.MouseEvent<HTMLDivElement>) => void;
+    /**
+     * Handle keyboard events for navigation
+     */
+    navigateKeyPress(event: React.KeyboardEvent): void;
+    /**
+     * Find the id from the root
+     */
+    private static getItemFromRoot;
+    resizerReset: () => void;
+    /**
+     * Render the right handle for resizing
+     */
+    renderHandleRight(): React.JSX.Element;
+    private renderHeader;
+    private renderToast;
+    /**
+     * Called when component is updated.
+     */
+    componentDidUpdate(): void;
+    scrollToItem(id: string): void;
+    private renderCustomDialog;
+    private onUpdate;
+    private renderEditObjectDialog;
+    private renderViewObjectFileDialog;
+    private renderAliasEditorDialog;
+    showAddDataPointDialog(id: string, initialType: ioBroker.ObjectType, initialStateType?: ioBroker.CommonType): void;
+    /**
+     * Renders the right mouse button context menu
+     */
+    private renderContextMenu;
+    private renderEditValueDialog;
+    /**
+     * The rendering method of this component.
+     */
+    render(): React.JSX.Element;
+}
 declare const _default: (props: Record<string, any>) => React.JSX.Element;
 export default _default;