widget

widget.setValue(widgetId, value);
widget.getValue(widgetId);
widget.setText(widgetId, text);
widget.getText(widgetId);

// Mirror a slider's value onto a gauge, and label it
widget.on('brightnessSlider', 'change', (v) => {
  widget.setValue('brightnessGauge', v);
  widget.setText('brightnessLabel', `Brightness: ${v}%`);
});

widget.show(widgetId);
widget.hide(widgetId);

// Show advanced controls only when a toggle is on
widget.on('advancedToggle', 'toggle', (on) => {
  on ? widget.show('advancedPanel') : widget.hide('advancedPanel');
});

widget.setPosition(widgetId, x, y);
widget.getPosition(widgetId);              // { x, y } | undefined
widget.setSize(widgetId, width, height);
widget.getSize(widgetId);                  // { width, height } | undefined
widget.resize(widgetId, width, height);
widget.move(widgetId, x, y);
widget.setRotation(widgetId, degrees);
widget.getRotation(widgetId);              // number | undefined

// Rotate a compass needle to a heading value, and nudge a marker
widget.on('headingSensor', 'change', (deg) => widget.setRotation('needle', deg));
widget.move('marker', 120, 80);

widget.setConfig(widgetId, configKey, value);
widget.getConfig(widgetId, configKey);     // one key
widget.getConfig(widgetId);                // whole config object

// Recolor a gauge when a value goes critical
widget.on('tempGauge', 'change', (t) => {
  widget.setConfig('tempGauge', 'color', t > 80 ? '#ef4444' : '#22c55e');
});

const w = widget.get(widgetId);            // DashboardWidget | undefined

const g = widget.get('tempGauge');
if (g) console.log('current config:', widget.getConfig('tempGauge'));

widget.on(widgetId, event, callback);      // returns unsubscribe fn
widget.once(widgetId, event, callback);    // fires once
widget.off(widgetId, event);               // remove handlers
widget.emit(widgetId, event, value);       // emit programmatically

// React to a button, then clean up on destroy
const off = widget.on('runButton', 'click', () => {
  ws.send(context.deviceId, { command: 'START' });
});
widget.once('runButton', 'destroy', off);