iobroker.devices 2.0.3 → 2.0.12

package/build/packages/dm-widgets/src/WidgetGeneric.js

@@ -0,0 +1,223 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WidgetGeneric = void 0;
+exports.isNeumorphicTheme = isNeumorphicTheme;
+exports.getTileStyles = getTileStyles;
+const react_1 = require("react");
+// ---------------------------------------------------------------------------
+// Helper functions
+// ---------------------------------------------------------------------------
+/** Check if the current theme is the neumorphic "styling-grey" preset */
+function isNeumorphicTheme(theme) {
+    return theme.wmPreset === 'styling-grey';
+}
+/** Returns tile background, border, border-radius, and transition styles */
+function getTileStyles(_theme, _isActive, _accentColor, _interactive, _inactiveColor) {
+    // Stub — replaced at runtime by the host's real implementation
+    return {};
+}
+// ---------------------------------------------------------------------------
+// Base class
+// ---------------------------------------------------------------------------
+class WidgetGeneric extends react_1.Component {
+    nameRef = { current: null };
+    // --- Static style helpers (use in outer Box sx) ---
+    static getDefaultSettings() {
+        return {
+            size: '1x1',
+            chartHours: 12,
+            name: '',
+            color: '',
+            colorActive: '',
+            showTrendArrow: false,
+            trendMinutes: 30,
+            favorite: false,
+            icon: '',
+            iconActive: '',
+            text: '',
+            textActive: '',
+        };
+    }
+    static getStyleCompact(_theme) {
+        return { position: 'relative', containerType: 'inline-size', overflow: 'hidden' };
+    }
+    static getStyleWide(theme) {
+        return { ...WidgetGeneric.getStyleCompact(theme), gridColumn: 'span 2' };
+    }
+    static getStyleWideTall(theme) {
+        return WidgetGeneric.getStyleWide(theme);
+    }
+    static getSettingButtonStyle() {
+        return {};
+    }
+    /**
+     * Override in plugin widgets to provide a settings dialog schema.
+     *
+     * Returns an `@iobroker/json-config` schema that the host renders in the
+     * widget settings dialog. The `name` field is used as the dialog title,
+     * and `schema` defines the form layout.
+     *
+     * Base fields (size, color) are automatically prepended by the host —
+     * only add plugin-specific fields here.
+     *
+     * Supported item types (see `@iobroker/json-config` docs for the full list):
+     * - `text`, `number`, `checkbox`, `color`, `select` — standard inputs
+     * - `objectId` — ioBroker state picker with browse dialog
+     * - `instance` — adapter instance selector (`adapters: ['adapterName']`)
+     * - `custom` — custom component registered via `customComponents`
+     *
+     * Use `hidden: "data.fieldName === 'value'"` (JS expression) to
+     * conditionally show/hide fields based on other field values.
+     *
+     * @returns `{ name, schema }` or `null` if no settings are needed
+     * @example
+     * ```typescript
+     * static getConfigSchema(): { name: string; schema: ConfigItemPanel } | null {
+     *     return {
+     *         name: 'My Widget Settings',
+     *         schema: {
+     *             type: 'panel',
+     *             items: {
+     *                 refreshRate: {
+     *                     type: 'number',
+     *                     label: 'Refresh rate (ms)',
+     *                     default: 1000,
+     *                     min: 100,
+     *                 },
+     *                 sensorId: {
+     *                     type: 'objectId',
+     *                     label: 'Sensor state',
+     *                 },
+     *                 mode: {
+     *                     type: 'select',
+     *                     label: 'Display mode',
+     *                     options: [
+     *                         { value: 'simple', label: 'Simple' },
+     *                         { value: 'detailed', label: 'Detailed' },
+     *                     ],
+     *                     default: 'simple',
+     *                     format: 'radio',
+     *                 },
+     *                 showUnit: {
+     *                     type: 'checkbox',
+     *                     label: 'Show unit',
+     *                     default: true,
+     *                     hidden: "data.mode === 'simple'",
+     *                 },
+     *             },
+     *         },
+     *     };
+     * }
+     * ```
+     */
+    static getConfigSchema() {
+        return null;
+    }
+    // --- Helpers available to subclasses ---
+    getText(_translated) {
+        return '';
+    }
+    getWidgetClass() {
+        return '';
+    }
+    getAccentColor() {
+        return undefined;
+    }
+    getInactiveColor() {
+        return undefined;
+    }
+    /** Format a timestamp as a localized "time ago" string using "moment" */
+    fromNow(_ts) {
+        return '';
+    }
+    // --- Override points ---
+    isTileActive() {
+        return false;
+    }
+    hasTileAction() {
+        return false;
+    }
+    hasChartAction() {
+        return false;
+    }
+    onTileClick() {
+        // override in subclass
+    }
+    getHistoryIds() {
+        return [];
+    }
+    getChartUnit() {
+        return undefined;
+    }
+    // --- Rendering override points ---
+    renderBaseIcon() {
+        return null;
+    }
+    renderTileIcon() {
+        return null;
+    }
+    renderTileStatus() {
+        return null;
+    }
+    renderTileAction() {
+        return null;
+    }
+    renderIndicators(_settingsButton, _extraStates) {
+        return null;
+    }
+    renderTrendArrow() {
+        return null;
+    }
+    renderChart() {
+        return null;
+    }
+    renderChartDialog() {
+        return null;
+    }
+    renderSettingsButton() {
+        return null;
+    }
+    renderInfoDialog() {
+        return null;
+    }
+    // --- PinPad ---
+    /** Open the PinPad dialog. On the correct PIN, `onPinPadSuccess()` is called. */
+    showPinPad(_pin) {
+        // Replaced at runtime by the host's real implementation
+    }
+    /** Called when the user enters the correct PIN. Override in subclass. */
+    onPinPadSuccess() {
+        // override in subclass
+    }
+    renderPinPad() {
+        return null;
+    }
+    // --- Confirmation Dialog ---
+    /** Open a confirmation dialog. On success, `onConfirmDialogSuccess()` is called. */
+    showConfirmDialog(_mode, _pin, _text) {
+        // Replaced at runtime by the host's real implementation
+    }
+    /** Called after successful confirmation. Override in subclass. */
+    onConfirmDialogSuccess() {
+        // override in subclass
+    }
+    renderConfirmDialog() {
+        return null;
+    }
+    // --- Size-specific rendering ---
+    renderCompact() {
+        return null;
+    }
+    renderWide() {
+        return null;
+    }
+    renderWideTall() {
+        return null;
+    }
+    render() {
+        return null;
+    }
+}
+exports.WidgetGeneric = WidgetGeneric;
+exports.default = WidgetGeneric;
+//# sourceMappingURL=WidgetGeneric.js.map

package/build/packages/dm-widgets/src/WidgetGeneric.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WidgetGeneric.js","sourceRoot":"","sources":["../../../../packages/dm-widgets/src/WidgetGeneric.ts"],"names":[],"mappings":"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"}

package/build/packages/dm-widgets/src/index.js

@@ -0,0 +1,99 @@
+"use strict";
+/**
+ * @iobroker/dm-widgets — Types and base class for ioBroker Device Manager widget plugins.
+ *
+ * ## How it works
+ *
+ * **At compile time:** Plugin authors `npm install @iobroker/dm-widgets` and import
+ * types, interfaces, and the `WidgetGeneric` base class for TypeScript support.
+ *
+ * **At runtime:** The host app (ioBroker.devices) exposes the real implementation on
+ * `window.__iobrokerDmWidgets__`. This module checks for that global and re-exports
+ * the host's real classes — so plugins get the full WidgetGeneric with all rendering
+ * logic, not the compile-time stubs.
+ *
+ * ## Usage
+ *
+ * ```typescript
+ * import WidgetGeneric, {
+ *     type WidgetGenericProps,
+ *     type WidgetGenericState,
+ *     getTileStyles,
+ *     isNeumorphicTheme,
+ * } from '@iobroker/dm-widgets';
+ *
+ * interface MyWidgetState extends WidgetGenericState {
+ *     myValue: number;
+ * }
+ *
+ * export class MyWidget extends WidgetGeneric<MyWidgetState> {
+ *     // Override renderCompact(), renderTileIcon(), etc.
+ * }
+ * ```
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdapterReact = exports.moment = exports.MuiIcons = exports.MuiMaterial = exports.ReactDom = exports.React = exports.StateContext = exports.isNeumorphicTheme = exports.getTileStyles = exports.WidgetGeneric = void 0;
+const _stubs = __importStar(require("./WidgetGeneric"));
+const StateContext_1 = __importDefault(require("./StateContext"));
+// At runtime, the host provides the real implementations via window global.
+// Fall back to stubs if running outside the host (e.g. tests, SSR).
+const _host = (typeof window !== 'undefined' &&
+    window.__iobrokerDmWidgets__) || { ..._stubs, StateContext: StateContext_1.default };
+// Shared modules provided by the host via window.__iobrokerShared__
+// Plugins should import react/MUI from here instead of directly to avoid dual-instance issues
+const _shared = (typeof window !== 'undefined' && window.__iobrokerShared__) || {};
+// --- Value exports (resolved from host at runtime) ---
+exports.WidgetGeneric = _host.default || _host.WidgetGeneric || _stubs.default;
+exports.default = exports.WidgetGeneric;
+exports.getTileStyles = _host.getTileStyles || _stubs.getTileStyles;
+exports.isNeumorphicTheme = _host.isNeumorphicTheme || _stubs.isNeumorphicTheme;
+exports.StateContext = _host.StateContext || StateContext_1.default;
+/** Host's React instance — use this instead of importing 'react' directly in plugins */
+exports.React = _shared.react;
+/** Host's RactDom instance — use this instead of importing 'react-dom' directly in plugins */
+exports.ReactDom = _shared['react-dom'];
+/** Host's MUI Material — use this instead of importing '@mui/material' directly in plugins */
+exports.MuiMaterial = _shared['@mui/material'];
+/** Host's MUI Icons — use this instead of importing '@mui/icons-material' directly in plugins */
+exports.MuiIcons = _shared['@mui/icons-material'];
+/** Host's moment instance — use this instead of importing 'moment' directly in plugins */
+exports.moment = _shared.moment;
+/** Host's adapter-react-v5 instance — use this instead of importing '@iobroker/adapter-react-v5' directly in plugins */
+exports.AdapterReact = _shared['@iobroker/adapter-react-v5'];
+//# sourceMappingURL=index.js.map

package/build/packages/dm-widgets/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/dm-widgets/src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,wDAA0C;AAC1C,kEAA+C;AAE/C,4EAA4E;AAC5E,oEAAoE;AACpE,MAAM,KAAK,GAA+D,CAAC,OAAO,MAAM,KAAK,WAAW;IACnG,MAAc,CAAC,qBAAqB,CAAC,IAAI,EAAE,GAAG,MAAM,EAAE,YAAY,EAAE,sBAAiB,EAAE,CAAC;AAE7F,oEAAoE;AACpE,8FAA8F;AAC9F,MAAM,OAAO,GAAwB,CAAC,OAAO,MAAM,KAAK,WAAW,IAAK,MAAc,CAAC,kBAAkB,CAAC,IAAI,EAAE,CAAC;AAEjH,wDAAwD;AAE3C,QAAA,aAAa,GAAG,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,aAAa,IAAI,MAAM,CAAC,OAAO,CAAC;AACpF,kBAAe,qBAAa,CAAC;AAChB,QAAA,aAAa,GAAG,KAAK,CAAC,aAAa,IAAI,MAAM,CAAC,aAAa,CAAC;AAC5D,QAAA,iBAAiB,GAAG,KAAK,CAAC,iBAAiB,IAAI,MAAM,CAAC,iBAAiB,CAAC;AACxE,QAAA,YAAY,GAAG,KAAK,CAAC,YAAY,IAAI,sBAAiB,CAAC;AAEpE,wFAAwF;AAC3E,QAAA,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;AACnC,8FAA8F;AACjF,QAAA,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;AAC7C,8FAA8F;AACjF,QAAA,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;AACpD,iGAAiG;AACpF,QAAA,QAAQ,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;AACvD,0FAA0F;AAC7E,QAAA,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;AACrC,wHAAwH;AAC3G,QAAA,YAAY,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAAC"}

package/build/packages/dm-widgets/src/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/build/packages/dm-widgets/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../packages/dm-widgets/src/types.ts"],"names":[],"mappings":""}