@devicechain/widgets 0.23.0 → 0.24.0

package/dist/index.js

@@ -1,24 +1,30 @@
 import {
   Table
 } from "./chunks/chunk-USRYKW2J.js";
+import {
+  ChunkLoadingFrame,
+  lazyChunk
+} from "./chunks/chunk-BMFQOTYG.js";
 import {
   alarmSubscription,
   commandSubscription,
+  groupsAlarmsByDeviceType,
+  measurementIsMembersOnly,
   measurementSpan,
   measurementWindow,
-  membersMode
-} from "./chunks/chunk-2D7JNKFE.js";
-import {
-  accessStrings
-} from "./chunks/chunk-BRH66T5F.js";
+  membersMode,
+  presenceMode,
+  wantsEventMarkers
+} from "./chunks/chunk-JFH4QMLA.js";
 import {
   AlarmCount,
+  AlarmSeverity,
   AlarmTable,
   highestSeverity,
   severityColor,
   severityLabel,
   severityRank
-} from "./chunks/chunk-6OGI4UFJ.js";
+} from "./chunks/chunk-546TK2QG.js";
 import {
   CommandButton,
   buildPayload,
@@ -30,6 +36,12 @@ import {
   parseParameterSchema,
   validateParams
 } from "./chunks/chunk-XSLFHCNI.js";
+import {
+  useHeld
+} from "./chunks/chunk-XNEBAY4J.js";
+import {
+  accessStrings
+} from "./chunks/chunk-BRH66T5F.js";
 import {
   EntitySelector
 } from "./chunks/chunk-FM7OI5TQ.js";
@@ -64,7 +76,7 @@ import {
   WidgetTimeRangeProvider,
   WidgetTokenStyles
 } from "@devicechain/widget-sdk";
-import { Fragment, useCallback as useCallback2, useEffect as useEffect4, useLayoutEffect, useMemo as useMemo5, useRef as useRef2, useState as useState6 } from "react";
+import { Fragment, useCallback as useCallback2, useEffect as useEffect3, useLayoutEffect, useMemo as useMemo5, useRef as useRef2, useState as useState4 } from "react";
 
 // src/connected-widget.tsx
 import {
@@ -79,22 +91,7 @@ import {
   useWidgetTimeRange as useWidgetTimeRange2
 } from "@devicechain/widget-sdk";
 import { isForbiddenError } from "@devicechain/client";
-import { useEffect as useEffect3, useMemo as useMemo4, useState as useState5 } from "react";
-
-// src/use-held.ts
-import { useState } from "react";
-function useHeld(value, hold, ready) {
-  const [held, setHeld] = useState(void 0);
-  if (!hold) {
-    if (held !== void 0) setHeld(void 0);
-    return value;
-  }
-  if (held === void 0 || ready(held.value) !== ready(value)) {
-    setHeld({ value });
-    return value;
-  }
-  return held.value;
-}
+import { useEffect as useEffect2, useMemo as useMemo4, useState as useState3 } from "react";
 
 // src/builtin-registry.ts
 import { createWidgetRegistry } from "@devicechain/widget-sdk";
@@ -108,15 +105,14 @@ import {
   createWidgetCatalog,
   defineWidgetDescriptor
 } from "@devicechain/dashboards";
+var defineRuntimeDescriptor = defineWidgetDescriptor;
 var TITLE = {
   kind: "string",
-  labelId: "widgetLabelTitle",
-  doc: "Heading shown in the widget frame. Blank hides the frame heading."
+  labelId: "widgetLabelTitle"
 };
 var TITLE_OR_MEASUREMENT = {
   kind: "string",
-  labelId: "widgetLabelTitle",
-  doc: "Heading shown in the widget frame. Defaults to the displayed measurement name."
+  labelId: "widgetLabelTitle"
 };
 var PRECISION = {
   kind: "number",
@@ -124,21 +120,18 @@ var PRECISION = {
   min: 0,
   max: 100,
   labelId: "widgetLabelPrecision",
-  helpId: "widgetHintPrecision",
-  doc: "Decimal places to round displayed values to. Unset rounds to at most 3 decimals (4 significant digits under 1)."
+  helpId: "widgetHintPrecision"
 };
 var THRESHOLDS = {
   kind: "list",
   maxItems: 12,
   labelId: "widgetLabelThresholds",
   helpId: "widgetHintThresholds",
-  doc: "Severity bands over the value. Each entry starts a band at its value that runs to the next entry; below the first, and in a normal band, the widget keeps its own colour.",
   item: {
     value: {
       kind: "number",
       required: true,
-      labelId: "widgetLabelThresholdValue",
-      doc: "The value at which this band starts."
+      labelId: "widgetLabelThresholdValue"
     },
     level: {
       kind: "enum",
@@ -152,91 +145,78 @@ var THRESHOLDS = {
         major: "widgetSeverityMajor",
         critical: "widgetSeverityCritical"
       },
-      placeholderId: "widgetPlaceholderThresholdLevel",
-      doc: "The severity of this band. The theme decides the colour; normal has none."
+      placeholderId: "widgetPlaceholderThresholdLevel"
     },
     label: {
       kind: "string",
-      labelId: "widgetLabelThresholdLabel",
-      doc: "Text shown on the chart line for this threshold. Defaults to its value."
+      labelId: "widgetLabelThresholdLabel"
     }
   }
 };
 var FLASH_ON_CHANGE = {
   kind: "boolean",
   labelId: "widgetFlashOnChange",
-  helpId: "widgetFlashOnChangeHint",
-  doc: "Briefly tint a value green on a rise and red on a fall when it changes."
+  helpId: "widgetFlashOnChangeHint"
 };
 var WINDOW = {
   kind: "number",
   integer: true,
   min: 1,
   labelId: "widgetLabelWindow",
-  helpId: "widgetHintWindow",
-  doc: "Samples retained across ALL of the widget's measurements before the oldest are dropped. Bounds memory; only the chart draws them. Default 300."
+  helpId: "widgetHintWindow"
 };
 var STALE_AFTER_SECONDS = {
   kind: "number",
   integer: true,
   min: 1,
   labelId: "widgetLabelStaleAfter",
-  helpId: "widgetHintStaleAfter",
-  doc: "Seconds after which the newest sample is called stale: the value is greyed out and badged. Unset shows the sample age only and never marks the widget stale."
+  helpId: "widgetHintStaleAfter"
 };
 var UNIT = {
   kind: "string",
-  labelId: "widgetLabelUnit",
-  doc: "Unit suffix shown beside the value."
+  labelId: "widgetLabelUnit"
 };
 var SCALE_MIN = {
   kind: "number",
   required: true,
   labelId: "widgetLabelMin",
-  helpId: "widgetHintScaleMin",
-  doc: "Value at the empty end of the scale. Required: the widget does not guess a range."
+  helpId: "widgetHintScaleMin"
 };
 var SCALE_MAX = {
   kind: "number",
   required: true,
   labelId: "widgetLabelMax",
-  helpId: "widgetHintScaleMax",
-  doc: "Value at the full end of the scale. Required, and above min."
+  helpId: "widgetHintScaleMax"
 };
 var CONTROL_COMMAND_NAME = {
   kind: "string",
   required: true,
   labelId: "widgetCommandHeading",
   helpId: "widgetCommandFieldHint",
-  control: "command-vocabulary",
-  doc: "Command key issued to the target device. Without it the control cannot send."
+  control: "command-vocabulary"
 };
 var CONTROL_COMMAND_LABEL = {
   kind: "string",
   labelId: "widgetCommandHeading",
   helpId: "widgetCommandFieldHint",
-  control: "command-vocabulary",
-  doc: "Name of the control for assistive technology. Defaults to the command key."
+  control: "command-vocabulary"
 };
 var CONTROL_PARAMETER_SCHEMA = {
   kind: "string",
   format: "json",
   labelId: "widgetCommandHeading",
   helpId: "widgetCommandFieldHint",
-  control: "command-vocabulary",
-  doc: "The command's parameter descriptors, baked in as JSON at author time. Gives the control its range and its refusals."
+  control: "command-vocabulary"
 };
 var CONTROL_PARAMETER = {
   kind: "string",
   labelId: "widgetLabelParameter",
-  helpId: "widgetHintControlParameter",
-  doc: "Which parameter of the command this control sets. May be left blank when the command has exactly one parameter of the right type."
+  helpId: "widgetHintControlParameter"
 };
 var MEASUREMENT = {
   kind: "string",
   labelId: "widgetLabelMeasurement",
-  helpId: "widgetHintMeasurement",
-  doc: "Which measurement to display. Defaults to the first the datasource selects."
+  helpId: "widgetHintMeasurement"
 };
 var ALARM_STATE = {
   kind: "enum",
@@ -244,8 +224,7 @@ var ALARM_STATE = {
   labelId: "widgetLabelState",
   helpId: "widgetStateHint",
   valueLabelIds: { ACTIVE: "widgetAlarmStateActive", CLEARED: "widgetAlarmStateCleared" },
-  placeholderId: "widgetPlaceholderAny",
-  doc: "Show only alarms in this state. Unset shows every state."
+  placeholderId: "widgetPlaceholderAny"
 };
 var ALARM_SEVERITY = {
   kind: "enum",
@@ -253,8 +232,7 @@ var ALARM_SEVERITY = {
   labelId: "widgetLabelSeverity",
   helpId: "widgetSeverityHint",
   valueLabelIds: { CRITICAL: "widgetAlarmSeverityCritical", MAJOR: "widgetAlarmSeverityMajor", MINOR: "widgetAlarmSeverityMinor", WARNING: "widgetAlarmSeverityWarning", INDETERMINATE: "widgetAlarmSeverityIndeterminate" },
-  placeholderId: "widgetPlaceholderAny",
-  doc: "Show only alarms at this severity. Unset shows every severity."
+  placeholderId: "widgetPlaceholderAny"
 };
 var ALARM_ACKNOWLEDGED = {
   kind: "enum",
@@ -262,15 +240,13 @@ var ALARM_ACKNOWLEDGED = {
   labelId: "widgetLabelAcknowledged",
   helpId: "widgetAcknowledgedHint",
   valueLabelIds: { true: "widgetAlarmAckAcknowledged", false: "widgetAlarmAckUnacknowledged" },
-  placeholderId: "widgetPlaceholderAny",
-  doc: "Show only acknowledged ('true') or unacknowledged ('false') alarms. Unset shows both."
+  placeholderId: "widgetPlaceholderAny"
 };
 var SELECTION_TARGET = {
   kind: "string",
   labelId: "widgetLabelTargetSlot",
   helpId: "widgetTargetSlotHint",
-  control: "slot-target",
-  doc: "Name of the slot this widget re-points when the viewer picks an entity."
+  control: "slot-target"
 };
 var VERSION = "1.0.0";
 var ALL_SELECTORS = ["device", "anchor", "slot"];
@@ -281,38 +257,69 @@ var ALARM_FILTERS = {
   severity: { option: "severity" },
   acknowledged: { option: "acknowledged" }
 };
+var MARK_ALARMS = {
+  kind: "boolean",
+  labelId: "widgetLabelMarkAlarms",
+  helpId: "widgetHintMarkAlarms"
+};
+var MARK_ALARMS_SCOPE = {
+  kind: "enum",
+  values: ["series", "device"],
+  labelId: "widgetLabelMarkAlarmsScope",
+  helpId: "widgetHintMarkAlarmsScope",
+  valueLabelIds: { series: "widgetMarkAlarmsScopeSeries", device: "widgetMarkAlarmsScopeDevice" },
+  placeholderId: "widgetPlaceholderWholeDevice"
+};
+var MARK_COMMANDS = {
+  kind: "boolean",
+  labelId: "widgetLabelMarkCommands",
+  helpId: "widgetHintMarkCommands"
+};
+var CHART_AXIS_MIN = {
+  kind: "number",
+  labelId: "widgetLabelMin",
+  helpId: "widgetHintChartAxisMin"
+};
+var CHART_AXIS_MAX = {
+  kind: "number",
+  labelId: "widgetLabelMax",
+  helpId: "widgetHintChartAxisMax"
+};
+var MAX_SERIES = {
+  kind: "number",
+  integer: true,
+  min: 1,
+  labelId: "widgetLabelMaxSeries",
+  helpId: "widgetHintMaxSeries"
+};
 var WINDOW_SECONDS = {
   kind: "number",
   integer: true,
   min: 60,
   max: 604800,
   labelId: "widgetLabelWindowSeconds",
-  helpId: "widgetHintWindowSeconds",
-  doc: "Seconds of history the widget covers, back from now. Leave unset to follow the board\u2019s time range; set it to pin this widget to a fixed span that the viewer\u2019s range picker does not change. 60 to 604800."
+  helpId: "widgetHintWindowSeconds"
 };
 var CATEGORY_SORT = {
   kind: "enum",
   values: ["none", "ascending", "descending"],
   labelId: "widgetLabelSort",
   valueLabelIds: { none: "widgetSortNone", ascending: "widgetSortAscending", descending: "widgetSortDescending" },
-  placeholderId: "widgetPlaceholderDefault",
-  doc: "Order of the categories. Default: as the data source lists them."
+  placeholderId: "widgetPlaceholderDefault"
 };
 var FLEET_MEASUREMENT = {
   kind: "string",
   required: true,
-  labelId: "widgetLabelMeasurement",
-  doc: "The measurement column this entry applies to."
+  labelId: "widgetLabelMeasurement"
 };
 var FLEET_COLUMNS = {
   kind: "list",
   maxItems: 24,
   labelId: "widgetLabelColumns",
   helpId: "widgetHintColumns",
-  doc: "Heading, unit and precision per measurement column; a column with none shows its name.",
   item: {
     measurement: FLEET_MEASUREMENT,
-    label: { kind: "string", labelId: "widgetLabelColumnHeading", doc: "Column heading. Defaults to the measurement name." },
+    label: { kind: "string", labelId: "widgetLabelColumnHeading" },
     unit: { ...UNIT },
     precision: { ...PRECISION }
   }
@@ -325,29 +332,47 @@ var FLEET_THRESHOLDS = {
   }
 };
 var builtinWidgetDescriptors = {
-  "timeseries-chart": defineWidgetDescriptor({
+  "timeseries-chart": defineRuntimeDescriptor({
     id: "timeseries-chart",
     version: VERSION,
     sdkApiVersion: 1,
     optionsVersion: 2,
     display: { title: "Timeseries chart", category: "Telemetry", titleId: "widgetTypeTimeseriesChart", categoryId: "widgetCategoryTelemetry" },
     channel: "measurement",
-    datasource: { mode: "required", selectors: ONE_DEVICE },
-    binding: { windowSeconds: { option: "windowSeconds" } },
+    // ALL_SELECTORS because of the compare mode (groupBy device): a group bound with the default mode
+    // is refused in words at runtime, exactly as for the bar chart.
+    datasource: { mode: "required", selectors: ALL_SELECTORS },
+    binding: { windowSeconds: { option: "windowSeconds" }, members: { option: "groupBy", equals: "device" } },
     options: {
       title: TITLE,
       unit: UNIT,
       precision: PRECISION,
       thresholds: THRESHOLDS,
       staleAfterSeconds: STALE_AFTER_SECONDS,
-      windowSeconds: WINDOW_SECONDS
+      windowSeconds: WINDOW_SECONDS,
+      groupBy: {
+        kind: "enum",
+        values: ["measurement", "device"],
+        labelId: "widgetLabelSeriesBy",
+        helpId: "widgetHintSeriesBy",
+        valueLabelIds: { measurement: "widgetGroupByMeasurement", device: "widgetGroupByDevice" },
+        placeholderId: "widgetPlaceholderDefault"
+      },
+      measurement: MEASUREMENT,
+      maxSeries: MAX_SERIES,
+      markAlarms: MARK_ALARMS,
+      markAlarmsScope: MARK_ALARMS_SCOPE,
+      markCommands: MARK_COMMANDS,
+      min: CHART_AXIS_MIN,
+      max: CHART_AXIS_MAX
     },
-    defaults: { title: "Timeseries chart" },
+    constraints: [{ kind: "greater-than", key: "max", than: "min" }],
+    defaults: { title: "Timeseries chart", markAlarmsScope: "series" },
     interactions: {},
     freshness: true,
     layout: { defaultSpan: { cols: 6, rows: 4 }, minSpan: { cols: 4, rows: 3 } }
   }),
-  "latest-card": defineWidgetDescriptor({
+  "latest-card": defineRuntimeDescriptor({
     id: "latest-card",
     version: VERSION,
     sdkApiVersion: 1,
@@ -361,8 +386,7 @@ var builtinWidgetDescriptors = {
       measurement: {
         kind: "string",
         labelId: "widgetLabelMeasurement",
-        helpId: "widgetHintMeasurement",
-        doc: "Which measurement to display. Defaults to the first the datasource selects."
+        helpId: "widgetHintMeasurement"
       },
       unit: UNIT,
       precision: PRECISION,
@@ -376,7 +400,7 @@ var builtinWidgetDescriptors = {
     freshness: true,
     layout: { defaultSpan: { cols: 3, rows: 2 }, minSpan: { cols: 3, rows: 2 }, maxSpan: { cols: 6, rows: 4 } }
   }),
-  gauge: defineWidgetDescriptor({
+  gauge: defineRuntimeDescriptor({
     id: "gauge",
     version: VERSION,
     sdkApiVersion: 1,
@@ -390,18 +414,15 @@ var builtinWidgetDescriptors = {
       measurement: {
         kind: "string",
         labelId: "widgetLabelMeasurement",
-        helpId: "widgetHintMeasurement",
-        doc: "Which measurement to display. Defaults to the first the datasource selects."
+        helpId: "widgetHintMeasurement"
       },
       min: {
         kind: "number",
-        labelId: "widgetLabelMin",
-        doc: "Low end of the gauge scale. Default 0."
+        labelId: "widgetLabelMin"
       },
       max: {
         kind: "number",
-        labelId: "widgetLabelMax",
-        doc: "High end of the gauge scale. Default 100."
+        labelId: "widgetLabelMax"
       },
       unit: UNIT,
       precision: PRECISION,
@@ -416,7 +437,7 @@ var builtinWidgetDescriptors = {
     freshness: true,
     layout: { defaultSpan: { cols: 3, rows: 3 }, minSpan: { cols: 3, rows: 3 }, maxSpan: { cols: 6, rows: 6 } }
   }),
-  table: defineWidgetDescriptor({
+  table: defineRuntimeDescriptor({
     id: "table",
     version: VERSION,
     sdkApiVersion: 1,
@@ -439,7 +460,7 @@ var builtinWidgetDescriptors = {
   }),
   // label and image are static: the `none` channel, no datasource, no subscription and no
   // history seed.
-  label: defineWidgetDescriptor({
+  label: defineRuntimeDescriptor({
     id: "label",
     version: VERSION,
     sdkApiVersion: 1,
@@ -453,30 +474,27 @@ var builtinWidgetDescriptors = {
       text: {
         kind: "string",
         required: true,
-        labelId: "widgetLabelText",
-        doc: "The text to show. Rendered as plain text \u2014 markup is never interpreted."
+        labelId: "widgetLabelText"
       },
       align: {
         kind: "enum",
         values: ["left", "center", "right"],
         labelId: "widgetLabelAlign",
         valueLabelIds: { left: "widgetAlignLeft", center: "widgetAlignCenter", right: "widgetAlignRight" },
-        placeholderId: "widgetPlaceholderDefault",
-        doc: "Horizontal alignment of the text. Default center."
+        placeholderId: "widgetPlaceholderDefault"
       },
       fontSize: {
         kind: "number",
         min: 1,
         labelId: "widgetLabelFontSize",
-        helpId: "widgetHintFontSize",
-        doc: "Text size in pixels at the comfortable density; it scales with the board density. Default 16."
+        helpId: "widgetHintFontSize"
       }
     },
     defaults: { text: "New label" },
     interactions: {},
     layout: { defaultSpan: { cols: 3, rows: 1 }, minSpan: { cols: 1, rows: 1 }, maxSpan: { cols: 24, rows: 3 } }
   }),
-  image: defineWidgetDescriptor({
+  image: defineRuntimeDescriptor({
     id: "image",
     version: VERSION,
     sdkApiVersion: 1,
@@ -490,28 +508,25 @@ var builtinWidgetDescriptors = {
       url: {
         kind: "string",
         required: true,
-        labelId: "widgetLabelImageUrl",
-        doc: "Source URL of the image."
+        labelId: "widgetLabelImageUrl"
       },
       alt: {
         kind: "string",
-        labelId: "widgetLabelAltText",
-        doc: "Alternative text describing the image for assistive technology."
+        labelId: "widgetLabelAltText"
       },
       fit: {
         kind: "enum",
         values: ["contain", "cover", "fill"],
         labelId: "widgetLabelFit",
         valueLabelIds: { contain: "widgetFitContain", cover: "widgetFitCover", fill: "widgetFitFill" },
-        placeholderId: "widgetPlaceholderDefault",
-        doc: "How the image fills its box. Default contain."
+        placeholderId: "widgetPlaceholderDefault"
       }
     },
     defaults: { title: "Image" },
     interactions: {},
     layout: { defaultSpan: { cols: 3, rows: 2 }, minSpan: { cols: 1, rows: 1 } }
   }),
-  "alarm-table": defineWidgetDescriptor({
+  "alarm-table": defineRuntimeDescriptor({
     id: "alarm-table",
     version: VERSION,
     sdkApiVersion: 1,
@@ -519,19 +534,37 @@ var builtinWidgetDescriptors = {
     display: { title: "Alarm table", category: "Alarms", titleId: "widgetTypeAlarmTable", categoryId: "widgetCategoryAlarms" },
     channel: "alarm",
     datasource: { mode: "optional", selectors: ALL_SELECTORS },
-    binding: { pageSize: { option: "maxRows", default: 50, min: 1 }, ...ALARM_FILTERS },
+    // groupBy 'deviceType' turns the table into one tab per device type (plus All).
+    binding: { pageSize: { option: "maxRows", default: 50, min: 1 }, ...ALARM_FILTERS, groupBy: { option: "groupBy", equals: "deviceType" } },
     options: {
       title: TITLE,
       state: ALARM_STATE,
       severity: ALARM_SEVERITY,
       acknowledged: ALARM_ACKNOWLEDGED,
+      groupBy: {
+        kind: "enum",
+        values: ["none", "deviceType"],
+        labelId: "widgetLabelAlarmGroupBy",
+        helpId: "widgetHintAlarmGroupBy",
+        valueLabelIds: { none: "widgetAlarmGroupByNone", deviceType: "widgetAlarmGroupByDeviceType" },
+        placeholderId: "widgetPlaceholderDefault"
+      },
+      deviceTypes: {
+        kind: "list",
+        maxItems: 24,
+        ordered: true,
+        labelId: "widgetLabelAlarmDeviceTypes",
+        helpId: "widgetHintAlarmDeviceTypes",
+        item: {
+          token: { kind: "string", control: "device-type", labelId: "widgetLabelAlarmDeviceTypeToken" }
+        }
+      },
       maxRows: {
         kind: "number",
         integer: true,
         min: 1,
         labelId: "widgetLabelMaxRows",
-        helpId: "widgetMaxRowsAlarmHint",
-        doc: "Alarms loaded into the table. Default 50."
+        helpId: "widgetMaxRowsAlarmHint"
       },
       precision: PRECISION,
       flashOnChange: FLASH_ON_CHANGE,
@@ -543,7 +576,7 @@ var builtinWidgetDescriptors = {
   }),
   // The count shows the SERVER total and reads a page only to sample the worst loaded
   // severity, so its page size is a constant rather than an authorable option.
-  "alarm-count": defineWidgetDescriptor({
+  "alarm-count": defineRuntimeDescriptor({
     id: "alarm-count",
     version: VERSION,
     sdkApiVersion: 1,
@@ -565,7 +598,45 @@ var builtinWidgetDescriptors = {
     interactions: {},
     layout: { defaultSpan: { cols: 3, rows: 2 }, minSpan: { cols: 2, rows: 2 }, maxSpan: { cols: 6, rows: 4 } }
   }),
-  "command-button": defineWidgetDescriptor({
+  // Alarms by severity, from ONE grouped count read (device-management's per-severity counts, every
+  // originator, exact past any page). Not a mode of alarm-count: a different shape and size, and no
+  // severity filter. `deviceType` narrows it to the alarms on one type's devices.
+  "alarm-severity": defineRuntimeDescriptor({
+    id: "alarm-severity",
+    version: VERSION,
+    sdkApiVersion: 1,
+    optionsVersion: 1,
+    display: {
+      title: "Alarm severity",
+      category: "Alarms",
+      titleId: "widgetTypeAlarmSeverity",
+      categoryId: "widgetCategoryAlarms"
+    },
+    channel: "alarm",
+    datasource: { mode: "optional", selectors: ALL_SELECTORS },
+    binding: {
+      pageSize: { const: 1 },
+      state: { option: "state" },
+      acknowledged: { option: "acknowledged" },
+      countBySeverity: { const: true },
+      deviceType: { option: "deviceType" }
+    },
+    options: {
+      title: TITLE,
+      state: ALARM_STATE,
+      acknowledged: ALARM_ACKNOWLEDGED,
+      deviceType: {
+        kind: "string",
+        control: "device-type",
+        labelId: "widgetLabelAlarmSeverityType",
+        helpId: "widgetHintAlarmSeverityType"
+      }
+    },
+    defaults: { title: "Alarm severity", state: "ACTIVE" },
+    interactions: {},
+    layout: { defaultSpan: { cols: 4, rows: 2 }, minSpan: { cols: 3, rows: 2 }, maxSpan: { cols: 12, rows: 4 } }
+  }),
+  "command-button": defineRuntimeDescriptor({
     id: "command-button",
     version: VERSION,
     sdkApiVersion: 1,
@@ -581,38 +652,34 @@ var builtinWidgetDescriptors = {
         required: true,
         labelId: "widgetCommandHeading",
         helpId: "widgetCommandFieldHint",
-        control: "command-vocabulary",
-        doc: "Command key issued to the target device. Without it the widget cannot send."
+        control: "command-vocabulary"
       },
       commandLabel: {
         kind: "string",
         labelId: "widgetCommandHeading",
         helpId: "widgetCommandFieldHint",
-        control: "command-vocabulary",
-        doc: "Text on the send button. Defaults to the command key."
+        control: "command-vocabulary"
       },
       parameterSchema: {
         kind: "string",
         format: "json",
         labelId: "widgetCommandHeading",
         helpId: "widgetCommandFieldHint",
-        control: "command-vocabulary",
-        doc: "The command's parameter descriptors, baked in as JSON at author time. Drives the typed form."
+        control: "command-vocabulary"
       },
       maxRows: {
         kind: "number",
         integer: true,
         min: 1,
         labelId: "widgetLabelMaxRows",
-        helpId: "widgetMaxRowsCommandHint",
-        doc: "Recent commands shown in the history. Default 20."
+        helpId: "widgetMaxRowsCommandHint"
       }
     },
     defaults: { title: "Command button" },
     interactions: { commandSend: true },
     layout: { defaultSpan: { cols: 3, rows: 3 }, minSpan: { cols: 3, rows: 2 }, maxSpan: { cols: 6, rows: 6 } }
   }),
-  "entity-selector": defineWidgetDescriptor({
+  "entity-selector": defineRuntimeDescriptor({
     id: "entity-selector",
     version: VERSION,
     sdkApiVersion: 1,
@@ -630,7 +697,7 @@ var builtinWidgetDescriptors = {
     // A select control is one line high, so its rows are pinned; it widens to fit long names.
     layout: { defaultSpan: { cols: 3, rows: 1 }, minSpan: { cols: 3, rows: 1 }, maxSpan: { cols: 12, rows: 1 }, resize: "horizontal" }
   }),
-  map: defineWidgetDescriptor({
+  map: defineRuntimeDescriptor({
     id: "map",
     version: VERSION,
     sdkApiVersion: 1,
@@ -652,25 +719,26 @@ var builtinWidgetDescriptors = {
         kind: "string",
         labelId: "widgetLabelTileUrl",
         helpId: "widgetTileUrlHint",
-        control: "basemap",
-        doc: "Raster tile URL template, e.g. https://tiles.example.com/{z}/{x}/{y}.png. Leave empty to inherit the tenant's basemap; setting one overrides it for this board only."
+        control: "basemap"
       },
       attribution: {
         kind: "string",
         labelId: "widgetLabelAttribution",
         helpId: "widgetAttributionHint",
-        control: "basemap",
-        doc: "Credit line the tile source requires, shown on the map. Set whatever the provider you chose asks for."
-      }
+        control: "basemap"
+      },
+      // Optional and additive: unset, a marker is only a mark. Set, clicking a marker re-points
+      // that slot at the device, exactly as a fleet-table row does.
+      selectionTarget: SELECTION_TARGET
     },
     defaults: { title: "Map" },
-    interactions: {},
+    interactions: { selection: true },
     layout: { defaultSpan: { cols: 6, rows: 4 }, minSpan: { cols: 4, rows: 3 } }
   }),
   // ---- Levels and indicators ------------------------------------------------
   // DOM/SVG single-value widgets on the measurement channel. A threshold band colours the fill
   // or lamp; `normal` keeps the widget's neutral accent.
-  "linear-gauge": defineWidgetDescriptor({
+  "linear-gauge": defineRuntimeDescriptor({
     id: "linear-gauge",
     version: VERSION,
     sdkApiVersion: 1,
@@ -689,16 +757,14 @@ var builtinWidgetDescriptors = {
         values: ["bar", "thermometer"],
         labelId: "widgetLabelLinearStyle",
         valueLabelIds: { bar: "widgetLinearStyleBar", thermometer: "widgetLinearStyleThermometer" },
-        placeholderId: "widgetPlaceholderDefault",
-        doc: "A plain bar (default) or a thermometer: a vertical tube with a bulb. A thermometer is always vertical."
+        placeholderId: "widgetPlaceholderDefault"
       },
       orientation: {
         kind: "enum",
         values: ["horizontal", "vertical"],
         labelId: "widgetLabelOrientation",
         valueLabelIds: { horizontal: "widgetOrientationHorizontal", vertical: "widgetOrientationVertical" },
-        placeholderId: "widgetPlaceholderDefault",
-        doc: "Direction of a bar: horizontal (default) or vertical. Ignored by a thermometer."
+        placeholderId: "widgetPlaceholderDefault"
       },
       unit: UNIT,
       precision: PRECISION,
@@ -712,7 +778,7 @@ var builtinWidgetDescriptors = {
     freshness: true,
     layout: { defaultSpan: { cols: 4, rows: 3 }, minSpan: { cols: 3, rows: 3 }, maxSpan: { cols: 8, rows: 8 } }
   }),
-  "level-gauge": defineWidgetDescriptor({
+  "level-gauge": defineRuntimeDescriptor({
     id: "level-gauge",
     version: VERSION,
     sdkApiVersion: 1,
@@ -731,8 +797,7 @@ var builtinWidgetDescriptors = {
         values: ["value", "percent"],
         labelId: "widgetLabelReadout",
         valueLabelIds: { value: "widgetReadoutValue", percent: "widgetReadoutPercent" },
-        placeholderId: "widgetPlaceholderDefault",
-        doc: "What the readout shows: the value with its unit (default) or the percent of the scale."
+        placeholderId: "widgetPlaceholderDefault"
       },
       unit: UNIT,
       precision: PRECISION,
@@ -746,7 +811,7 @@ var builtinWidgetDescriptors = {
     freshness: true,
     layout: { defaultSpan: { cols: 3, rows: 4 }, minSpan: { cols: 2, rows: 3 }, maxSpan: { cols: 6, rows: 8 } }
   }),
-  battery: defineWidgetDescriptor({
+  battery: defineRuntimeDescriptor({
     id: "battery",
     version: VERSION,
     sdkApiVersion: 1,
@@ -761,14 +826,12 @@ var builtinWidgetDescriptors = {
       min: {
         kind: "number",
         labelId: "widgetLabelMin",
-        helpId: "widgetHintBatteryRange",
-        doc: "Value of an empty battery. Default 0 (the scale is percent unless you set min and max)."
+        helpId: "widgetHintBatteryRange"
       },
       max: {
         kind: "number",
         labelId: "widgetLabelMax",
-        helpId: "widgetHintBatteryRange",
-        doc: "Value of a full battery. Default 100 (the scale is percent unless you set min and max)."
+        helpId: "widgetHintBatteryRange"
       },
       unit: UNIT,
       precision: PRECISION,
@@ -782,7 +845,7 @@ var builtinWidgetDescriptors = {
     freshness: true,
     layout: { defaultSpan: { cols: 3, rows: 2 }, minSpan: { cols: 2, rows: 2 }, maxSpan: { cols: 6, rows: 4 } }
   }),
-  "status-light": defineWidgetDescriptor({
+  "status-light": defineRuntimeDescriptor({
     id: "status-light",
     version: VERSION,
     sdkApiVersion: 1,
@@ -797,8 +860,7 @@ var builtinWidgetDescriptors = {
       onAt: {
         kind: "number",
         labelId: "widgetLabelOnAt",
-        helpId: "widgetHintOnAt",
-        doc: "For an on/off signal: the lamp is lit at or above this value and dark below it. Unset keeps the lamp lit while a value is present, coloured by its threshold band."
+        helpId: "widgetHintOnAt"
       },
       unit: UNIT,
       precision: PRECISION,
@@ -811,7 +873,7 @@ var builtinWidgetDescriptors = {
     freshness: true,
     layout: { defaultSpan: { cols: 2, rows: 2 }, minSpan: { cols: 2, rows: 2 }, maxSpan: { cols: 4, rows: 4 } }
   }),
-  "signal-bars": defineWidgetDescriptor({
+  "signal-bars": defineRuntimeDescriptor({
     id: "signal-bars",
     version: VERSION,
     sdkApiVersion: 1,
@@ -830,8 +892,7 @@ var builtinWidgetDescriptors = {
         ...THRESHOLDS,
         maxItems: 8,
         required: true,
-        helpId: "widgetHintSignalThresholds",
-        doc: "The steps of the signal, lowest first: one bar per entry, lit once the value reaches it and coloured by its level. At least two, at most eight."
+        helpId: "widgetHintSignalThresholds"
       },
       staleAfterSeconds: STALE_AFTER_SECONDS,
       window: WINDOW
@@ -844,7 +905,7 @@ var builtinWidgetDescriptors = {
   // ---- Radial family ----------------------------------------------------------
   // A heading on a full turn, and a ring filled between a configured min and max. The compass
   // draws on the registered gauge series; the ring is SVG. Both put their number in DOM text.
-  compass: defineWidgetDescriptor({
+  compass: defineRuntimeDescriptor({
     id: "compass",
     version: VERSION,
     sdkApiVersion: 1,
@@ -857,12 +918,10 @@ var builtinWidgetDescriptors = {
       title: TITLE_OR_MEASUREMENT,
       measurement: MEASUREMENT,
       precision: {
-        ...PRECISION,
-        doc: "Decimal places of the heading. Default 0 (whole degrees). The heading is rounded first, then folded onto 0 to 360, so it never reads 360."
+        ...PRECISION
       },
       thresholds: {
-        ...THRESHOLDS,
-        doc: "Severity bands over the heading in degrees (0 to 360, after folding). Each entry starts a band at its value that runs to the next entry; below the first, and in a normal band, the needle keeps its own colour."
+        ...THRESHOLDS
       },
       staleAfterSeconds: STALE_AFTER_SECONDS,
       window: WINDOW
@@ -872,7 +931,7 @@ var builtinWidgetDescriptors = {
     freshness: true,
     layout: { defaultSpan: { cols: 4, rows: 4 }, minSpan: { cols: 3, rows: 3 }, maxSpan: { cols: 8, rows: 8 } }
   }),
-  "progress-ring": defineWidgetDescriptor({
+  "progress-ring": defineRuntimeDescriptor({
     id: "progress-ring",
     version: VERSION,
     sdkApiVersion: 1,
@@ -891,8 +950,7 @@ var builtinWidgetDescriptors = {
         values: ["percent", "value"],
         labelId: "widgetLabelReadout",
         valueLabelIds: { percent: "widgetReadoutPercent", value: "widgetReadoutValue" },
-        placeholderId: "widgetPlaceholderDefault",
-        doc: "What the middle of the ring shows: the percent of the scale (default) or the value with its unit."
+        placeholderId: "widgetPlaceholderDefault"
       },
       unit: UNIT,
       precision: PRECISION,
@@ -906,7 +964,7 @@ var builtinWidgetDescriptors = {
     freshness: true,
     layout: { defaultSpan: { cols: 3, rows: 3 }, minSpan: { cols: 2, rows: 2 }, maxSpan: { cols: 6, rows: 6 } }
   }),
-  "command-slider": defineWidgetDescriptor({
+  "command-slider": defineRuntimeDescriptor({
     id: "command-slider",
     version: VERSION,
     sdkApiVersion: 1,
@@ -925,21 +983,25 @@ var builtinWidgetDescriptors = {
       min: {
         kind: "number",
         labelId: "widgetLabelMin",
-        helpId: "widgetHintSliderRange",
-        doc: "Lowest value, used only when the command's parameter declares no minimum."
+        helpId: "widgetHintSliderRange"
       },
       max: {
         kind: "number",
         labelId: "widgetLabelMax",
-        helpId: "widgetHintSliderRange",
-        doc: "Highest value, used only when the command's parameter declares no maximum."
+        helpId: "widgetHintSliderRange"
       },
       step: {
         kind: "number",
         min: 0,
         labelId: "widgetLabelStep",
-        helpId: "widgetHintSliderStep",
-        doc: "Distance between values. Defaults to 1 for a whole-number parameter, else a hundredth of the range."
+        helpId: "widgetHintSliderStep"
+      },
+      mode: {
+        kind: "enum",
+        values: ["slider", "stepper"],
+        labelId: "widgetLabelControlMode",
+        valueLabelIds: { slider: "widgetControlModeSlider", stepper: "widgetControlModeStepper" },
+        placeholderId: "widgetPlaceholderDefault"
       }
     },
     constraints: [{ kind: "greater-than", key: "max", than: "min" }],
@@ -947,7 +1009,7 @@ var builtinWidgetDescriptors = {
     interactions: { commandSend: true },
     layout: { defaultSpan: { cols: 4, rows: 2 }, minSpan: { cols: 3, rows: 2 }, maxSpan: { cols: 8, rows: 3 } }
   }),
-  "command-toggle": defineWidgetDescriptor({
+  "command-toggle": defineRuntimeDescriptor({
     id: "command-toggle",
     version: VERSION,
     sdkApiVersion: 1,
@@ -967,7 +1029,7 @@ var builtinWidgetDescriptors = {
     interactions: { commandSend: true },
     layout: { defaultSpan: { cols: 3, rows: 2 }, minSpan: { cols: 2, rows: 2 }, maxSpan: { cols: 6, rows: 3 } }
   }),
-  "stat-card": defineWidgetDescriptor({
+  "stat-card": defineRuntimeDescriptor({
     id: "stat-card",
     version: VERSION,
     sdkApiVersion: 1,
@@ -992,19 +1054,23 @@ var builtinWidgetDescriptors = {
           count: "widgetStatCount",
           last: "widgetStatLast"
         },
-        placeholderId: "widgetPlaceholderDefault",
-        doc: "Which figure to show. Default average."
+        placeholderId: "widgetPlaceholderDefault"
       },
       unit: UNIT,
       precision: PRECISION,
       thresholds: THRESHOLDS,
+      sparkline: {
+        kind: "boolean",
+        labelId: "widgetLabelSparkline",
+        helpId: "widgetHintSparkline"
+      },
       windowSeconds: WINDOW_SECONDS
     },
     defaults: { title: "Stat card" },
     interactions: {},
     layout: { defaultSpan: { cols: 3, rows: 3 }, minSpan: { cols: 3, rows: 2 }, maxSpan: { cols: 6, rows: 4 } }
   }),
-  "bar-chart": defineWidgetDescriptor({
+  "bar-chart": defineRuntimeDescriptor({
     id: "bar-chart",
     version: VERSION,
     sdkApiVersion: 1,
@@ -1022,8 +1088,7 @@ var builtinWidgetDescriptors = {
         labelId: "widgetLabelGroupBy",
         helpId: "widgetHintGroupBy",
         valueLabelIds: { measurement: "widgetGroupByMeasurement", device: "widgetGroupByDevice" },
-        placeholderId: "widgetPlaceholderDefault",
-        doc: "One bar per measurement (the default), or per device of the group for the measurement set below."
+        placeholderId: "widgetPlaceholderDefault"
       },
       measurement: MEASUREMENT,
       unit: UNIT,
@@ -1034,7 +1099,7 @@ var builtinWidgetDescriptors = {
     interactions: {},
     layout: { defaultSpan: { cols: 6, rows: 4 }, minSpan: { cols: 4, rows: 3 } }
   }),
-  "pie-chart": defineWidgetDescriptor({
+  "pie-chart": defineRuntimeDescriptor({
     id: "pie-chart",
     version: VERSION,
     sdkApiVersion: 1,
@@ -1051,7 +1116,7 @@ var builtinWidgetDescriptors = {
   // A new widget rather than a mode of `table`: that one is one device's measurements as rows, on a
   // channel that keys its values by name; this one is a fleet, a row per member and a column per
   // measurement, and reads its data by device.
-  "fleet-table": defineWidgetDescriptor({
+  "fleet-table": defineRuntimeDescriptor({
     id: "fleet-table",
     version: VERSION,
     sdkApiVersion: 1,
@@ -1070,23 +1135,20 @@ var builtinWidgetDescriptors = {
         integer: true,
         min: 1,
         labelId: "widgetLabelAgeLag",
-        helpId: "widgetHintAgeLag",
-        doc: "Show a reading's age under it only when the reading is at least this many seconds older than the newest reading in the table (or stale). Unset shows every reading's age."
+        helpId: "widgetHintAgeLag"
       },
       sortBy: {
         kind: "string",
         labelId: "widgetLabelSortBy",
-        helpId: "widgetHintSortBy",
-        doc: "The measurement the table is ordered by. Blank orders by device name."
+        helpId: "widgetHintSortBy"
       },
-      sortDescending: { kind: "boolean", labelId: "widgetLabelSortDescending", doc: "Largest first." },
+      sortDescending: { kind: "boolean", labelId: "widgetLabelSortDescending" },
       pageSize: {
         kind: "number",
         integer: true,
         min: 5,
         max: 100,
-        labelId: "widgetLabelPageSize",
-        doc: "Devices per page. Default 20."
+        labelId: "widgetLabelPageSize"
       },
       selectionTarget: SELECTION_TARGET,
       windowSeconds: WINDOW_SECONDS
@@ -1096,44 +1158,82 @@ var builtinWidgetDescriptors = {
     freshness: true,
     interactions: { selection: true },
     layout: { defaultSpan: { cols: 12, rows: 6 }, minSpan: { cols: 6, rows: 3 } }
+  }),
+  // Counts a fleet rather than listing it: how many of its devices are in an abnormal band of one
+  // measurement ("3 of 21"), or how many devices it has. A new widget rather than a mode of the
+  // fleet table, which is a grid; this is the figure above one.
+  "fleet-count": defineRuntimeDescriptor({
+    id: "fleet-count",
+    version: VERSION,
+    sdkApiVersion: 1,
+    optionsVersion: 1,
+    display: { title: "Fleet count", category: "Telemetry", titleId: "widgetTypeFleetCount", categoryId: "widgetCategoryTelemetry" },
+    channel: "measurement",
+    datasource: { mode: "required", selectors: ALL_SELECTORS },
+    binding: { windowSeconds: { option: "windowSeconds" }, members: { const: true } },
+    options: {
+      title: TITLE,
+      show: {
+        kind: "enum",
+        values: ["attention", "devices"],
+        labelId: "widgetLabelFleetShow",
+        helpId: "widgetHintFleetShow",
+        valueLabelIds: { attention: "widgetFleetShowAttention", devices: "widgetFleetShowDevices" },
+        placeholderId: "widgetPlaceholderDefault"
+      },
+      measurement: {
+        ...MEASUREMENT
+      },
+      thresholds: THRESHOLDS,
+      staleAfterSeconds: STALE_AFTER_SECONDS,
+      windowSeconds: WINDOW_SECONDS
+    },
+    defaults: { title: "Fleet count" },
+    freshness: true,
+    interactions: {},
+    layout: { defaultSpan: { cols: 3, rows: 3 }, minSpan: { cols: 3, rows: 3 }, maxSpan: { cols: 6, rows: 4 } }
+  }),
+  // One device's connectivity: Online or Offline, and when it was last seen. It reads device-state
+  // (`binding.presence`), not the device's readings, and shows one device, so it takes no group.
+  "device-status": defineRuntimeDescriptor({
+    id: "device-status",
+    version: VERSION,
+    sdkApiVersion: 1,
+    optionsVersion: 1,
+    display: { title: "Device status", category: "Telemetry", titleId: "widgetTypeDeviceStatus", categoryId: "widgetCategoryTelemetry" },
+    channel: "measurement",
+    datasource: { mode: "required", selectors: ONE_DEVICE },
+    binding: { presence: { const: true } },
+    options: { title: TITLE, staleAfterSeconds: STALE_AFTER_SECONDS },
+    defaults: { title: "Device status" },
+    // The frame's age is the status's: when device-state was last read, not the device's last activity.
+    freshness: true,
+    interactions: {},
+    layout: { defaultSpan: { cols: 3, rows: 3 }, minSpan: { cols: 3, rows: 3 }, maxSpan: { cols: 6, rows: 4 } }
+  }),
+  // How many of a group's devices are online: a ring of online, offline and no status yet. A new
+  // widget rather than a mode of the pie chart, which is shares of readings; this reads device-state.
+  "online-doughnut": defineRuntimeDescriptor({
+    id: "online-doughnut",
+    version: VERSION,
+    sdkApiVersion: 1,
+    optionsVersion: 1,
+    display: { title: "Online doughnut", category: "Telemetry", titleId: "widgetTypeOnlineDoughnut", categoryId: "widgetCategoryTelemetry" },
+    channel: "measurement",
+    datasource: { mode: "required", selectors: ALL_SELECTORS },
+    binding: { presence: { const: true } },
+    options: { title: TITLE, staleAfterSeconds: STALE_AFTER_SECONDS },
+    defaults: { title: "Online doughnut" },
+    // The frame's age is the status's: when device-state was last read for the group.
+    freshness: true,
+    interactions: {},
+    layout: { defaultSpan: { cols: 4, rows: 4 }, minSpan: { cols: 3, rows: 3 }, maxSpan: { cols: 8, rows: 8 } }
   })
 };
 var builtinWidgetCatalog = createWidgetCatalog(Object.values(builtinWidgetDescriptors));
 
-// src/widgets/lazy-chunk.tsx
-import { useEffect, useState as useState2 } from "react";
-import { jsx } from "react/jsx-runtime";
-function lazyChunk(importer) {
-  let loaded;
-  let loading;
-  const load = () => loading ?? (loading = importer().then(
-    (m) => loaded = m,
-    (err) => {
-      loading = void 0;
-      throw err;
-    }
-  ));
-  function component(name, alsoPreload) {
-    function LazyChunkWidget(props) {
-      const [mod, setMod] = useState2(loaded);
-      const [error, setError] = useState2();
-      useEffect(() => {
-        if (!mod) load().then(setMod, setError);
-      }, [mod]);
-      if (error !== void 0) throw error;
-      if (!mod) return null;
-      const Component2 = mod[name];
-      return /* @__PURE__ */ jsx(Component2, { ...props });
-    }
-    LazyChunkWidget.displayName = `Lazy(${name})`;
-    LazyChunkWidget.preload = alsoPreload ? () => Promise.all([load(), alsoPreload()]).then(([m]) => m) : load;
-    return LazyChunkWidget;
-  }
-  return { load, component };
-}
-
 // src/widgets/aggregate-lazy.tsx
-var chunk = lazyChunk(() => import("./chunks/aggregate-widgets-HZQI5HTX.js"));
+var chunk = lazyChunk(() => import("./chunks/aggregate-widgets-2ZQBW3YF.js"));
 var loadAggregateWidgets = chunk.load;
 var statCardWidget = defineWidget({
   descriptor: builtinWidgetDescriptors["stat-card"],
@@ -1147,6 +1247,10 @@ var pieChartWidget = defineWidget({
   descriptor: builtinWidgetDescriptors["pie-chart"],
   implementation: { kind: "trusted-react", component: chunk.component("PieChart") }
 });
+var fleetCountWidget = defineWidget({
+  descriptor: builtinWidgetDescriptors["fleet-count"],
+  implementation: { kind: "trusted-react", component: chunk.component("FleetCount") }
+});
 var fleetTableWidget = defineWidget({
   descriptor: builtinWidgetDescriptors["fleet-table"],
   implementation: { kind: "trusted-react", component: chunk.component("FleetTable") }
@@ -1154,12 +1258,16 @@ var fleetTableWidget = defineWidget({
 
 // src/widgets/alarm-lazy.tsx
 import { defineWidget as defineWidget2 } from "@devicechain/widget-sdk";
-var chunk2 = lazyChunk(() => import("./chunks/alarm-widgets-7UY6MIYZ.js"));
+var chunk2 = lazyChunk(() => import("./chunks/alarm-widgets-X4PX5MYJ.js"));
 var loadAlarmWidgets = chunk2.load;
 var alarmTableWidget = defineWidget2({
   descriptor: builtinWidgetDescriptors["alarm-table"],
   implementation: { kind: "trusted-react", component: chunk2.component("AlarmTable") }
 });
+var alarmSeverityWidget = defineWidget2({
+  descriptor: builtinWidgetDescriptors["alarm-severity"],
+  implementation: { kind: "trusted-react", component: chunk2.component("AlarmSeverity") }
+});
 var alarmCountWidget = defineWidget2({
   descriptor: builtinWidgetDescriptors["alarm-count"],
   implementation: { kind: "trusted-react", component: chunk2.component("AlarmCount") }
@@ -1167,7 +1275,7 @@ var alarmCountWidget = defineWidget2({
 
 // src/widgets/control-lazy.tsx
 import { defineWidget as defineWidget3 } from "@devicechain/widget-sdk";
-var chunk3 = lazyChunk(() => import("./chunks/control-widgets-3V2LSSRF.js"));
+var chunk3 = lazyChunk(() => import("./chunks/control-widgets-UCTJJJ2D.js"));
 var loadControlWidgets = chunk3.load;
 var commandSliderWidget = defineWidget3({
   descriptor: builtinWidgetDescriptors["command-slider"],
@@ -1182,19 +1290,32 @@ var commandButtonWidget = defineWidget3({
   implementation: { kind: "trusted-react", component: chunk3.component("CommandButton") }
 });
 
-// src/widgets/selection-lazy.tsx
+// src/widgets/presence-lazy.tsx
 import { defineWidget as defineWidget4 } from "@devicechain/widget-sdk";
-var chunk4 = lazyChunk(() => import("./chunks/entity-selector-3JJFI4DT.js"));
-var loadSelectionWidgets = chunk4.load;
-var entitySelectorWidget = defineWidget4({
+var chunk4 = lazyChunk(() => import("./chunks/presence-widgets-2LIUKN4Y.js"));
+var loadPresenceWidgets = chunk4.load;
+var deviceStatusWidget = defineWidget4({
+  descriptor: builtinWidgetDescriptors["device-status"],
+  implementation: { kind: "trusted-react", component: chunk4.component("DeviceStatus") }
+});
+var onlineDoughnutWidget = defineWidget4({
+  descriptor: builtinWidgetDescriptors["online-doughnut"],
+  implementation: { kind: "trusted-react", component: chunk4.component("OnlineDoughnut") }
+});
+
+// src/widgets/selection-lazy.tsx
+import { defineWidget as defineWidget5 } from "@devicechain/widget-sdk";
+var chunk5 = lazyChunk(() => import("./chunks/entity-selector-3JJFI4DT.js"));
+var loadSelectionWidgets = chunk5.load;
+var entitySelectorWidget = defineWidget5({
   descriptor: builtinWidgetDescriptors["entity-selector"],
-  implementation: { kind: "trusted-react", component: chunk4.component("EntitySelector") }
+  implementation: { kind: "trusted-react", component: chunk5.component("EntitySelector") }
 });
 
 // src/widgets/gauge.tsx
 import { useMemo } from "react";
 import {
-  defineWidget as defineWidget5,
+  defineWidget as defineWidget6,
   flashBackgroundStyle,
   formatValue,
   optBoolean,
@@ -1208,11 +1329,11 @@ import {
   WidgetFrame
 } from "@devicechain/widget-sdk";
 import { buildGaugeOption, EChart, gaugeReadoutBox, loadChartEngine, useChartTheme } from "@devicechain/widget-sdk/echarts";
-import { jsx as jsx2, jsxs } from "react/jsx-runtime";
+import { jsx, jsxs } from "react/jsx-runtime";
 function Gauge({ widget, data }) {
   const name = primaryMeasurementName(widget);
   const sample = pickSample(data.latest, name);
-  return /* @__PURE__ */ jsx2(WidgetFrame, { title: optString(widget.options, "title") ?? name, sampleTime: sample?.occurredTime ?? null, flush: true, children: /* @__PURE__ */ jsx2(GaugeBody, { widget, data }) });
+  return /* @__PURE__ */ jsx(WidgetFrame, { title: optString(widget.options, "title") ?? name, sampleTime: sample?.occurredTime ?? null, flush: true, children: /* @__PURE__ */ jsx(GaugeBody, { widget, data }) });
 }
 function GaugeBody({ widget, data }) {
   const theme = useChartTheme();
@@ -1244,8 +1365,8 @@ function GaugeBody({ widget, data }) {
     "aria-valuetext": `${formatValue(value, precision)}${unit ? ` ${unit}` : ""}`
   } : {};
   return /* @__PURE__ */ jsxs("div", { style: { position: "relative", width: "100%", height: "100%", ...flashBackgroundStyle(flashDirection) }, ...meter, children: [
-    /* @__PURE__ */ jsx2(EChart, { option }),
-    /* @__PURE__ */ jsx2(
+    /* @__PURE__ */ jsx(EChart, { option }),
+    /* @__PURE__ */ jsx(
       "div",
       {
         style: {
@@ -1259,7 +1380,7 @@ function GaugeBody({ widget, data }) {
           justifyContent: "center",
           pointerEvents: "none"
         },
-        children: /* @__PURE__ */ jsx2(
+        children: /* @__PURE__ */ jsx(
           LevelReadout,
           {
             text: formatValue(value, precision),
@@ -1273,7 +1394,7 @@ function GaugeBody({ widget, data }) {
   ] });
 }
 Gauge.preload = loadChartEngine;
-var gaugeWidget = defineWidget5({
+var gaugeWidget = defineWidget6({
   descriptor: builtinWidgetDescriptors["gauge"],
   implementation: { kind: "trusted-react", component: Gauge }
 });
@@ -1281,19 +1402,19 @@ var gaugeWidget = defineWidget5({
 // src/widgets/image.tsx
 import {
   css,
-  defineWidget as defineWidget6,
+  defineWidget as defineWidget7,
   fontVar,
   optString as optString2,
   WidgetFrame as WidgetFrame2
 } from "@devicechain/widget-sdk";
-import { jsx as jsx3 } from "react/jsx-runtime";
+import { jsx as jsx2 } from "react/jsx-runtime";
 var FITS = /* @__PURE__ */ new Set(["contain", "cover", "fill"]);
 function Image({ widget }) {
   const url = optString2(widget.options, "url");
   const alt = optString2(widget.options, "alt") ?? "";
   const fitOption = optString2(widget.options, "fit");
   const objectFit = fitOption && FITS.has(fitOption) ? fitOption : "contain";
-  return /* @__PURE__ */ jsx3(WidgetFrame2, { title: optString2(widget.options, "title"), flush: true, children: url ? /* @__PURE__ */ jsx3("img", { src: url, alt, style: { width: "100%", height: "100%", objectFit, display: "block" } }) : /* @__PURE__ */ jsx3(
+  return /* @__PURE__ */ jsx2(WidgetFrame2, { title: optString2(widget.options, "title"), flush: true, children: url ? /* @__PURE__ */ jsx2("img", { src: url, alt, style: { width: "100%", height: "100%", objectFit, display: "block" } }) : /* @__PURE__ */ jsx2(
     "div",
     {
       style: {
@@ -1308,7 +1429,7 @@ function Image({ widget }) {
     }
   ) });
 }
-var imageWidget = defineWidget6({
+var imageWidget = defineWidget7({
   descriptor: builtinWidgetDescriptors["image"],
   implementation: { kind: "trusted-react", component: Image }
 });
@@ -1316,14 +1437,14 @@ var imageWidget = defineWidget6({
 // src/widgets/label.tsx
 import {
   css as css2,
-  defineWidget as defineWidget7,
+  defineWidget as defineWidget8,
   fontVar as fontVar2,
   spaceVar,
   optNumber as optNumber2,
   optString as optString3,
   WidgetFrame as WidgetFrame3
 } from "@devicechain/widget-sdk";
-import { jsx as jsx4 } from "react/jsx-runtime";
+import { jsx as jsx3 } from "react/jsx-runtime";
 var justify = {
   left: "flex-start",
   center: "center",
@@ -1334,7 +1455,7 @@ function Label({ widget }) {
   const align = optString3(widget.options, "align") ?? "center";
   const authored = optNumber2(widget.options, "fontSize");
   const fontSize = authored !== void 0 ? `calc(${authored}px * var(--dc-scale, 1))` : fontVar2("lg");
-  return /* @__PURE__ */ jsx4(WidgetFrame3, { title: optString3(widget.options, "title"), flush: true, children: /* @__PURE__ */ jsx4(
+  return /* @__PURE__ */ jsx3(WidgetFrame3, { title: optString3(widget.options, "title"), flush: true, children: /* @__PURE__ */ jsx3(
     "div",
     {
       style: {
@@ -1348,7 +1469,7 @@ function Label({ widget }) {
         // height or less, so it keeps a slim vertical inset and the usual side inset.
         padding: `${spaceVar(1)} ${spaceVar(3)}`
       },
-      children: /* @__PURE__ */ jsx4(
+      children: /* @__PURE__ */ jsx3(
         "span",
         {
           style: {
@@ -1363,7 +1484,7 @@ function Label({ widget }) {
     }
   ) });
 }
-var labelWidget = defineWidget7({
+var labelWidget = defineWidget8({
   descriptor: builtinWidgetDescriptors["label"],
   implementation: { kind: "trusted-react", component: Label }
 });
@@ -1373,7 +1494,7 @@ import { useMemo as useMemo2 } from "react";
 import {
   bandAt,
   css as css3,
-  defineWidget as defineWidget8,
+  defineWidget as defineWidget9,
   fitValueFont,
   fitValueFontCss,
   FIT_MIN_FONT_PX,
@@ -1395,7 +1516,7 @@ import {
   useWidgetTimeZone,
   WidgetFrame as WidgetFrame4
 } from "@devicechain/widget-sdk";
-import { jsx as jsx5, jsxs as jsxs2 } from "react/jsx-runtime";
+import { jsx as jsx4, jsxs as jsxs2 } from "react/jsx-runtime";
 var TIMESTAMP_ROOM_PX = 18;
 function LatestCard({ widget, data }) {
   const severity = useSeverityColors();
@@ -1415,7 +1536,7 @@ function LatestCard({ widget, data }) {
     sample && `${sample.deviceToken}:${sample.name}`
   );
   const chars = useStickyChars(display.length + (sample?.value != null && unit ? Math.ceil(unit.length / 2) + 1 : 0));
-  return /* @__PURE__ */ jsx5(WidgetFrame4, { title, sampleTime: sample?.occurredTime ?? null, children: ({ size, scale }) => {
+  return /* @__PURE__ */ jsx4(WidgetFrame4, { title, sampleTime: sample?.occurredTime ?? null, children: ({ size, scale }) => {
     const floor = Math.round(FIT_MIN_FONT_PX * scale);
     const measured = size.width > 0 && size.height > 0;
     const valuePx = measured ? fitValueFont(size, chars, { floor }) : void 0;
@@ -1451,7 +1572,7 @@ function LatestCard({ widget, data }) {
               },
               children: [
                 display,
-                sample?.value != null && unit ? /* @__PURE__ */ jsx5(
+                sample?.value != null && unit ? /* @__PURE__ */ jsx4(
                   "span",
                   {
                     style: {
@@ -1465,65 +1586,65 @@ function LatestCard({ widget, data }) {
               ]
             }
           ),
-          sample?.occurredTime && showTimestamp ? /* @__PURE__ */ jsx5("div", { style: { fontSize: fontVar3("xs"), color: css3("muted-foreground"), marginTop: spaceVar2(1) }, children: formatTimestamp(sample.occurredTime, timeZone) }) : null
+          sample?.occurredTime && showTimestamp ? /* @__PURE__ */ jsx4("div", { style: { fontSize: fontVar3("xs"), color: css3("muted-foreground"), marginTop: spaceVar2(1) }, children: formatTimestamp(sample.occurredTime, timeZone) }) : null
         ]
       }
     );
   } });
 }
-var latestCardWidget = defineWidget8({
+var latestCardWidget = defineWidget9({
   descriptor: builtinWidgetDescriptors["latest-card"],
   implementation: { kind: "trusted-react", component: LatestCard }
 });
 
 // src/widgets/level-lazy.tsx
-import { defineWidget as defineWidget9 } from "@devicechain/widget-sdk";
+import { defineWidget as defineWidget10 } from "@devicechain/widget-sdk";
 import { loadChartEngine as loadChartEngine2 } from "@devicechain/widget-sdk/echarts";
-var chunk5 = lazyChunk(() => import("./chunks/level-widgets-MJB7TOLU.js"));
-var loadLevelWidgets = chunk5.load;
-var lazyComponent = chunk5.component;
-var linearGaugeWidget = defineWidget9({
+var chunk6 = lazyChunk(() => import("./chunks/level-widgets-MJB7TOLU.js"));
+var loadLevelWidgets = chunk6.load;
+var lazyComponent = chunk6.component;
+var linearGaugeWidget = defineWidget10({
   descriptor: builtinWidgetDescriptors["linear-gauge"],
   implementation: { kind: "trusted-react", component: lazyComponent("LinearGauge") }
 });
-var levelGaugeWidget = defineWidget9({
+var levelGaugeWidget = defineWidget10({
   descriptor: builtinWidgetDescriptors["level-gauge"],
   implementation: { kind: "trusted-react", component: lazyComponent("LevelGauge") }
 });
-var batteryWidget = defineWidget9({
+var batteryWidget = defineWidget10({
   descriptor: builtinWidgetDescriptors["battery"],
   implementation: { kind: "trusted-react", component: lazyComponent("Battery") }
 });
-var statusLightWidget = defineWidget9({
+var statusLightWidget = defineWidget10({
   descriptor: builtinWidgetDescriptors["status-light"],
   implementation: { kind: "trusted-react", component: lazyComponent("StatusLight") }
 });
-var signalBarsWidget = defineWidget9({
+var signalBarsWidget = defineWidget10({
   descriptor: builtinWidgetDescriptors["signal-bars"],
   implementation: { kind: "trusted-react", component: lazyComponent("SignalBars") }
 });
-var compassWidget = defineWidget9({
+var compassWidget = defineWidget10({
   descriptor: builtinWidgetDescriptors["compass"],
   implementation: { kind: "trusted-react", component: lazyComponent("Compass", loadChartEngine2) }
 });
-var progressRingWidget = defineWidget9({
+var progressRingWidget = defineWidget10({
   descriptor: builtinWidgetDescriptors["progress-ring"],
   implementation: { kind: "trusted-react", component: lazyComponent("ProgressRing") }
 });
 
 // src/widgets/map.tsx
-import { useEffect as useEffect2, useRef, useState as useState3 } from "react";
+import { useEffect, useRef, useState } from "react";
 import { renderableBasemap, resolveBasemap } from "@devicechain/client";
 
 // src/basemap-context.tsx
 import { createContext, useContext } from "react";
-import { jsx as jsx6 } from "react/jsx-runtime";
+import { jsx as jsx5 } from "react/jsx-runtime";
 var TenantBasemapContext = createContext(null);
 function TenantBasemapProvider({
   basemap,
   children
 }) {
-  return /* @__PURE__ */ jsx6(TenantBasemapContext.Provider, { value: basemap, children });
+  return /* @__PURE__ */ jsx5(TenantBasemapContext.Provider, { value: basemap, children });
 }
 function useTenantBasemap() {
   return useContext(TenantBasemapContext);
@@ -1531,13 +1652,13 @@ function useTenantBasemap() {
 
 // src/map-runtime-context.tsx
 import { createContext as createContext2, useContext as useContext2 } from "react";
-import { jsx as jsx7 } from "react/jsx-runtime";
+import { jsx as jsx6 } from "react/jsx-runtime";
 var MapRuntimeContext = createContext2(null);
 function MapRuntimeProvider({
   runtime,
   children
 }) {
-  return /* @__PURE__ */ jsx7(MapRuntimeContext.Provider, { value: runtime, children });
+  return /* @__PURE__ */ jsx6(MapRuntimeContext.Provider, { value: runtime, children });
 }
 function useMapRuntime() {
   return useContext2(MapRuntimeContext);
@@ -1547,8 +1668,9 @@ function useMapRuntime() {
 import {
   css as css4,
   fontVar as fontVar4,
-  defineWidget as defineWidget10,
+  defineWidget as defineWidget11,
   optString as optString5,
+  useWidgetSelect,
   WidgetFrame as WidgetFrame5
 } from "@devicechain/widget-sdk";
 
@@ -1645,7 +1767,7 @@ function loadLandStyle() {
 }
 
 // src/widgets/map.tsx
-import { jsx as jsx8, jsxs as jsxs3 } from "react/jsx-runtime";
+import { jsx as jsx7, jsxs as jsxs3 } from "react/jsx-runtime";
 var mapLibrePromise;
 function loadMapLibre(runtime) {
   if (!mapLibrePromise) {
@@ -1664,6 +1786,9 @@ function MapWidget({ widget, data }) {
   const title = optString5(widget.options, "title");
   const positions = placeable(data.locations);
   const runtime = useMapRuntime();
+  const select = useWidgetSelect();
+  const selectionTarget = optString5(widget.options, "selectionTarget");
+  const pick = select && selectionTarget ? (deviceToken) => select({ slot: selectionTarget, binding: { kind: "device", deviceToken } }) : void 0;
   const basemap = renderableBasemap(
     resolveBasemap(
       {
@@ -1674,7 +1799,7 @@ function MapWidget({ widget, data }) {
     )
   );
   if (data.forbidden) {
-    return /* @__PURE__ */ jsx8(WidgetFrame5, { title, children: /* @__PURE__ */ jsx8(
+    return /* @__PURE__ */ jsx7(WidgetFrame5, { title, children: /* @__PURE__ */ jsx7(
       MapNotice,
       {
         glyph: "\u{1F512}",
@@ -1684,7 +1809,7 @@ function MapWidget({ widget, data }) {
     ) });
   }
   if (!runtime) {
-    return /* @__PURE__ */ jsx8(WidgetFrame5, { title, children: /* @__PURE__ */ jsx8(
+    return /* @__PURE__ */ jsx7(WidgetFrame5, { title, children: /* @__PURE__ */ jsx7(
       MapNotice,
       {
         glyph: "\u{1F9E9}",
@@ -1694,10 +1819,10 @@ function MapWidget({ widget, data }) {
     ) });
   }
   if (data.loading && positions.length === 0) {
-    return /* @__PURE__ */ jsx8(WidgetFrame5, { title, children: /* @__PURE__ */ jsx8(MapNotice, { heading: "Loading\u2026" }) });
+    return /* @__PURE__ */ jsx7(WidgetFrame5, { title, children: /* @__PURE__ */ jsx7(MapNotice, { heading: "Loading\u2026" }) });
   }
   if (positions.length === 0) {
-    return /* @__PURE__ */ jsx8(WidgetFrame5, { title, children: /* @__PURE__ */ jsx8(
+    return /* @__PURE__ */ jsx7(WidgetFrame5, { title, children: /* @__PURE__ */ jsx7(
       MapNotice,
       {
         heading: data.deviceTokens.length === 0 ? "No devices selected" : "No positions reported",
@@ -1705,9 +1830,13 @@ function MapWidget({ widget, data }) {
       }
     ) });
   }
-  return /* @__PURE__ */ jsx8(WidgetFrame5, { title, flush: true, children: /* @__PURE__ */ jsx8(LiveMap, { basemap, positions, runtime }) });
+  return /* @__PURE__ */ jsx7(WidgetFrame5, { title, flush: true, children: /* @__PURE__ */ jsx7(LiveMap, { basemap, positions, runtime, pick }) });
 }
-function PlainPanel({ positions, note }) {
+function PlainPanel({
+  positions,
+  note,
+  pick
+}) {
   const points = projectToPanel(positions);
   return /* @__PURE__ */ jsxs3(
     "div",
@@ -1721,10 +1850,11 @@ function PlainPanel({ positions, note }) {
         background: css4("muted")
       },
       children: [
-        positions.map((position, i) => /* @__PURE__ */ jsx8(
+        positions.map((position, i) => /* @__PURE__ */ jsx7(
           Marker,
           {
             position,
+            pick,
             style: {
               position: "absolute",
               left: `${points[i].x * 100}%`,
@@ -1734,7 +1864,7 @@ function PlainPanel({ positions, note }) {
           },
           position.deviceToken
         )),
-        /* @__PURE__ */ jsx8(
+        /* @__PURE__ */ jsx7(
           "div",
           {
             "data-testid": "map-no-tiles-note",
@@ -1761,15 +1891,19 @@ function PlainPanel({ positions, note }) {
 function LiveMap({
   basemap,
   positions,
-  runtime
+  runtime,
+  pick
 }) {
   const containerRef = useRef(null);
   const mapRef = useRef(null);
   const markersRef = useRef([]);
-  const [status, setStatus] = useState3("loading");
+  const [status, setStatus] = useState("loading");
+  const pickRef = useRef(pick);
+  pickRef.current = pick;
+  const selectable = pick !== void 0;
   const tileUrl = basemap?.tileUrl ?? null;
   const attribution = basemap?.attribution ?? null;
-  useEffect2(() => {
+  useEffect(() => {
     let cancelled = false;
     setStatus("loading");
     Promise.all([
@@ -1797,7 +1931,7 @@ function LiveMap({
       mapRef.current = null;
     };
   }, [tileUrl, attribution, runtime.workerUrl]);
-  useEffect2(() => {
+  useEffect(() => {
     const map = mapRef.current;
     if (status !== "ready" || !map) return;
     let live = true;
@@ -1810,7 +1944,24 @@ function LiveMap({
         el.setAttribute("data-device", position.deviceToken);
         el.setAttribute("title", describePosition(position));
         el.setAttribute("aria-label", describePosition(position));
-        Object.assign(el.style, MARKER_DOT_STYLE);
+        if (selectable) {
+          Object.assign(el.style, MARKER_HIT_STYLE);
+          el.setAttribute("role", "button");
+          el.setAttribute("tabindex", "0");
+          const dot = document.createElement("div");
+          Object.assign(dot.style, MARKER_DOT_STYLE, { cursor: "inherit" });
+          el.appendChild(dot);
+          const choose = () => pickRef.current?.(position.deviceToken);
+          el.addEventListener("click", choose);
+          el.addEventListener("keydown", (e) => {
+            if (e.key === "Enter" || e.key === " ") {
+              e.preventDefault();
+              choose();
+            }
+          });
+        } else {
+          Object.assign(el.style, MARKER_DOT_STYLE);
+        }
         return new maplibre.Marker({ element: el }).setLngLat([position.longitude, position.latitude]).addTo(map);
       });
       if (positions.length === 1) {
@@ -1824,21 +1975,30 @@ function LiveMap({
     return () => {
       live = false;
     };
-  }, [status, positionsKey(positions)]);
+  }, [status, positionsKey(positions), selectable]);
   if (status === "unavailable") {
-    return /* @__PURE__ */ jsx8(
+    return /* @__PURE__ */ jsx7(
       PlainPanel,
       {
         positions,
-        note: "Map renderer unavailable \u2014 positions are shown without a basemap."
+        note: "Map renderer unavailable \u2014 positions are shown without a basemap.",
+        pick
       }
     );
   }
-  return /* @__PURE__ */ jsx8("div", { ref: containerRef, "data-testid": "map-canvas", style: { width: "100%", height: "100%" } });
+  return /* @__PURE__ */ jsx7("div", { ref: containerRef, "data-testid": "map-canvas", style: { width: "100%", height: "100%" } });
 }
 function positionsKey(positions) {
   return positions.map((p) => `${p.deviceToken}:${p.latitude}:${p.longitude}:${p.heading ?? ""}`).join("|");
 }
+var MARKER_HIT_STYLE = {
+  width: "24px",
+  height: "24px",
+  display: "flex",
+  alignItems: "center",
+  justifyContent: "center",
+  cursor: "pointer"
+};
 var MARKER_DOT_STYLE = {
   width: "12px",
   height: "12px",
@@ -1850,10 +2010,26 @@ var MARKER_DOT_STYLE = {
 };
 function Marker({
   position,
-  style
+  style,
+  pick
 }) {
   const label = describePosition(position);
-  return /* @__PURE__ */ jsx8(
+  if (pick) {
+    return /* @__PURE__ */ jsx7(
+      "button",
+      {
+        type: "button",
+        "data-testid": "map-marker",
+        "data-device": position.deviceToken,
+        title: label,
+        "aria-label": label,
+        onClick: () => pick(position.deviceToken),
+        style: { ...MARKER_HIT_STYLE, padding: 0, border: 0, background: "transparent", ...style },
+        children: /* @__PURE__ */ jsx7("span", { style: { ...MARKER_DOT_STYLE, cursor: "inherit", display: "block" } })
+      }
+    );
+  }
+  return /* @__PURE__ */ jsx7(
     "div",
     {
       "data-testid": "map-marker",
@@ -1882,25 +2058,25 @@ function MapNotice({ glyph, heading, detail }) {
         color: css4("muted-foreground")
       },
       children: [
-        glyph ? /* @__PURE__ */ jsx8("div", { style: { fontSize: fontVar4("xl"), lineHeight: 1 }, "aria-hidden": "true", children: glyph }) : null,
-        /* @__PURE__ */ jsx8("div", { style: { fontSize: fontVar4("md"), fontWeight: 600 }, children: heading }),
-        detail ? /* @__PURE__ */ jsx8("div", { style: { fontSize: fontVar4("sm"), opacity: 0.8 }, children: detail }) : null
+        glyph ? /* @__PURE__ */ jsx7("div", { style: { fontSize: fontVar4("xl"), lineHeight: 1 }, "aria-hidden": "true", children: glyph }) : null,
+        /* @__PURE__ */ jsx7("div", { style: { fontSize: fontVar4("md"), fontWeight: 600 }, children: heading }),
+        detail ? /* @__PURE__ */ jsx7("div", { style: { fontSize: fontVar4("sm"), opacity: 0.8 }, children: detail }) : null
       ]
     }
   );
 }
-var mapWidget = defineWidget10({
+var mapWidget = defineWidget11({
   descriptor: builtinWidgetDescriptors["map"],
   implementation: { kind: "trusted-react", component: MapWidget }
 });
 
 // src/widgets/table-lazy.tsx
-import { defineWidget as defineWidget11 } from "@devicechain/widget-sdk";
-var chunk6 = lazyChunk(() => import("./chunks/table-6EVV7QZH.js"));
-var loadTableWidget = chunk6.load;
-var tableWidget = defineWidget11({
+import { defineWidget as defineWidget12 } from "@devicechain/widget-sdk";
+var chunk7 = lazyChunk(() => import("./chunks/table-6EVV7QZH.js"));
+var loadTableWidget = chunk7.load;
+var tableWidget = defineWidget12({
   descriptor: builtinWidgetDescriptors["table"],
-  implementation: { kind: "trusted-react", component: chunk6.component("Table") }
+  implementation: { kind: "trusted-react", component: chunk7.component("Table") }
 });
 
 // src/widgets/time-series-chart.tsx
@@ -1908,7 +2084,7 @@ import { useMemo as useMemo3 } from "react";
 import { isValidSpanSeconds, spanLabel } from "@devicechain/dashboards";
 import {
   css as css5,
-  defineWidget as defineWidget12,
+  defineWidget as defineWidget13,
   fontVar as fontVar5,
   formatDateTime,
   formatTimestamp as formatTimestamp2,
@@ -1923,24 +2099,31 @@ import {
   WidgetFrame as WidgetFrame6
 } from "@devicechain/widget-sdk";
 import { buildLineOption, EChart as EChart2, loadChartEngine as loadChartEngine3, useChartTheme as useChartTheme2 } from "@devicechain/widget-sdk/echarts";
-import { jsx as jsx9, jsxs as jsxs4 } from "react/jsx-runtime";
-function TimeSeriesChart({ widget, data }) {
-  return /* @__PURE__ */ jsx9(WidgetFrame6, { title: optString6(widget.options, "title"), flush: true, children: /* @__PURE__ */ jsx9(TimeSeriesBody, { widget, data }) });
+import { jsx as jsx8, jsxs as jsxs4 } from "react/jsx-runtime";
+function TimeSeriesChart({ widget, data, markers }) {
+  return /* @__PURE__ */ jsx8(WidgetFrame6, { title: optString6(widget.options, "title"), flush: true, children: /* @__PURE__ */ jsx8(TimeSeriesBody, { widget, data, markers }) });
 }
-function TimeSeriesBody({ widget, data }) {
+function TimeSeriesBody({ widget, data, markers }) {
   const theme = useChartTheme2();
   const { size, scale } = useWidgetScale2();
   const measurements = widget.datasource?.measurements;
   const unit = optString6(widget.options, "unit");
   const precision = optNumber4(widget.options, "precision");
   const thresholds = useMemo3(() => optThresholds3(widget.options, "thresholds"), [widget.options]);
-  const option = useMemo3(
-    () => buildLineOption(data.samples, theme, { measurements, unit, precision, thresholds, scale, gaps: data.gaps }, size),
-    [data.samples, data.gaps, theme, measurements, unit, precision, thresholds, scale, size]
-  );
-  return /* @__PURE__ */ jsxs4("div", { style: { position: "relative", width: "100%", height: "100%" }, children: [
-    /* @__PURE__ */ jsx9(EChart2, { option }),
-    /* @__PURE__ */ jsx9(SpanBadge, { widget, data })
+  const min = optNumber4(widget.options, "min");
+  const max = optNumber4(widget.options, "max");
+  const option = useMemo3(() => {
+    const base = buildLineOption(data.samples, theme, { measurements, unit, precision, thresholds, scale, gaps: data.gaps, min, max }, size);
+    return markers ? markers.decorate(base, size) : base;
+  }, [data.samples, data.gaps, theme, measurements, unit, precision, thresholds, scale, size, markers, min, max]);
+  const chart = /* @__PURE__ */ jsxs4("div", { style: { position: "relative", width: "100%", height: "100%" }, children: [
+    /* @__PURE__ */ jsx8(EChart2, { option }),
+    /* @__PURE__ */ jsx8(SpanBadge, { widget, data })
+  ] });
+  if (!markers) return chart;
+  return /* @__PURE__ */ jsxs4("div", { style: { display: "flex", flexDirection: "column", width: "100%", height: "100%" }, children: [
+    /* @__PURE__ */ jsx8("div", { style: { flex: 1, minHeight: 0 }, children: chart }),
+    markers.footer
   ] });
 }
 var SPAN_STRINGS = {
@@ -1970,7 +2153,7 @@ function SpanBadge({ widget, data }) {
   const time = cutAt ? end - Date.parse(cutAt) > DAY_MS ? formatDateTime(cutAt, timeZone) : formatTimestamp2(cutAt, timeZone) : "";
   const text = [showSpan ? label : "", cutAt ? words.from(time) : ""].filter(Boolean).join(" \xB7 ");
   const title = [showSpan ? words.pinned(label) : "", cutAt ? words.cut(time, label) : ""].filter(Boolean).join(" ");
-  return /* @__PURE__ */ jsx9(
+  return /* @__PURE__ */ jsx8(
     "span",
     {
       "data-chart-span": showSpan ? label : "",
@@ -1993,7 +2176,7 @@ function SpanBadge({ widget, data }) {
   );
 }
 TimeSeriesChart.preload = loadChartEngine3;
-var timeSeriesChartWidget = defineWidget12({
+var timeSeriesChartWidget = defineWidget13({
   descriptor: builtinWidgetDescriptors["timeseries-chart"],
   implementation: { kind: "trusted-react", component: TimeSeriesChart }
 });
@@ -2008,6 +2191,7 @@ var builtinWidgetDefinitions = [
   imageWidget,
   alarmTableWidget,
   alarmCountWidget,
+  alarmSeverityWidget,
   commandButtonWidget,
   entitySelectorWidget,
   mapWidget,
@@ -2023,7 +2207,10 @@ var builtinWidgetDefinitions = [
   statCardWidget,
   barChartWidget,
   pieChartWidget,
-  fleetTableWidget
+  fleetTableWidget,
+  fleetCountWidget,
+  deviceStatusWidget,
+  onlineDoughnutWidget
 ];
 function createBuiltinWidgetRegistry() {
   return createWidgetRegistry(builtinWidgetDefinitions);
@@ -2045,12 +2232,12 @@ import {
   useLocationStream,
   useMeasurementStream,
   useWidgetCandidates,
-  useWidgetSelect,
+  useWidgetSelect as useWidgetSelect2,
   WidgetFrame as WidgetFrame8
 } from "@devicechain/widget-sdk";
 
 // src/widget-containment.tsx
-import { Component, createContext as createContext3, useCallback, useContext as useContext3, useState as useState4 } from "react";
+import { Component, createContext as createContext3, useCallback, useContext as useContext3, useState as useState2 } from "react";
 import { WidgetFrame as WidgetFrame7 } from "@devicechain/widget-sdk";
 
 // src/widget-host.ts
@@ -2109,7 +2296,7 @@ function narrowCandidates(candidates, descriptor, report) {
 }
 
 // src/widget-containment.tsx
-import { jsx as jsx10, jsxs as jsxs5 } from "react/jsx-runtime";
+import { jsx as jsx9, jsxs as jsxs5 } from "react/jsx-runtime";
 var MESSAGE_STYLE = {
   display: "flex",
   flexDirection: "column",
@@ -2153,22 +2340,22 @@ var WidgetErrorBoundary = class extends Component {
   render() {
     const { error } = this.state;
     if (!error) return this.props.children;
-    return /* @__PURE__ */ jsx10(WidgetFrame7, { title: this.props.title, children: /* @__PURE__ */ jsxs5("div", { style: MESSAGE_STYLE, role: "alert", children: [
-      /* @__PURE__ */ jsx10("div", { style: { fontSize: 20, lineHeight: 1 }, "aria-hidden": "true", children: "\u26A0" }),
-      /* @__PURE__ */ jsx10("div", { style: { fontSize: 13, fontWeight: 600 }, children: "This widget failed to render" }),
-      /* @__PURE__ */ jsx10("div", { style: { fontSize: 11, opacity: 0.8, wordBreak: "break-word" }, children: error.message }),
-      /* @__PURE__ */ jsx10("button", { type: "button", style: BUTTON_STYLE, onClick: this.reset, children: "Reset widget" })
+    return /* @__PURE__ */ jsx9(WidgetFrame7, { title: this.props.title, children: /* @__PURE__ */ jsxs5("div", { style: MESSAGE_STYLE, role: "alert", children: [
+      /* @__PURE__ */ jsx9("div", { style: { fontSize: 20, lineHeight: 1 }, "aria-hidden": "true", children: "\u26A0" }),
+      /* @__PURE__ */ jsx9("div", { style: { fontSize: 13, fontWeight: 600 }, children: "This widget failed to render" }),
+      /* @__PURE__ */ jsx9("div", { style: { fontSize: 11, opacity: 0.8, wordBreak: "break-word" }, children: error.message }),
+      /* @__PURE__ */ jsx9("button", { type: "button", style: BUTTON_STYLE, onClick: this.reset, children: "Reset widget" })
     ] }) });
   }
 };
 function WidgetContainment({ title, resetKey, children }) {
-  const [messages, setMessages] = useState4([]);
+  const [messages, setMessages] = useState2([]);
   const report = useCallback((message) => {
     setMessages((prev) => prev.includes(message) ? prev : [...prev, message].slice(-3));
   }, []);
   const clear = useCallback(() => setMessages([]), []);
   return /* @__PURE__ */ jsxs5("div", { style: { position: "relative", width: "100%", height: "100%" }, children: [
-    /* @__PURE__ */ jsx10(ReportContext.Provider, { value: report, children: /* @__PURE__ */ jsx10(WidgetErrorBoundary, { title, resetKey, onReset: clear, children }) }),
+    /* @__PURE__ */ jsx9(ReportContext.Provider, { value: report, children: /* @__PURE__ */ jsx9(WidgetErrorBoundary, { title, resetKey, onReset: clear, children }) }),
     messages.length > 0 && /* @__PURE__ */ jsxs5(
       "div",
       {
@@ -2188,8 +2375,8 @@ function WidgetContainment({ title, resetKey, children }) {
           alignItems: "center"
         },
         children: [
-          /* @__PURE__ */ jsx10("span", { style: { flex: 1, wordBreak: "break-word" }, children: messages.join(" \xB7 ") }),
-          /* @__PURE__ */ jsx10("button", { type: "button", "aria-label": "Dismiss", onClick: clear, style: { cursor: "pointer" }, children: "\xD7" })
+          /* @__PURE__ */ jsx9("span", { style: { flex: 1, wordBreak: "break-word" }, children: messages.join(" \xB7 ") }),
+          /* @__PURE__ */ jsx9("button", { type: "button", "aria-label": "Dismiss", onClick: clear, style: { cursor: "pointer" }, children: "\xD7" })
         ]
       }
     )
@@ -2197,12 +2384,12 @@ function WidgetContainment({ title, resetKey, children }) {
 }
 
 // src/connected-widget.tsx
-import { jsx as jsx11, jsxs as jsxs6 } from "react/jsx-runtime";
+import { jsx as jsx10, jsxs as jsxs6 } from "react/jsx-runtime";
 function ConnectedWidget(props) {
   const { widget } = props;
   const registry = props.registry ?? defaultWidgetRegistry();
   const resetKey = JSON.stringify([widget.type, widget.options ?? null, widget.datasource ?? null]);
-  return /* @__PURE__ */ jsx11(WidgetContainment, { title: optString7(widget.options, "title"), resetKey, children: /* @__PURE__ */ jsx11(ConnectedWidgetBody, { ...props, registry }) });
+  return /* @__PURE__ */ jsx10(WidgetContainment, { title: optString7(widget.options, "title"), resetKey, children: /* @__PURE__ */ jsx10(ConnectedWidgetBody, { ...props, registry }) });
 }
 function ConnectedWidgetBody({ widget, hub, registry, actions, initialSamples, initialSamplesAsOf, onReconnect }) {
   const unresolved = widget.type === UNKNOWN_WIDGET_TYPE;
@@ -2212,16 +2399,16 @@ function ConnectedWidgetBody({ widget, hub, registry, actions, initialSamples, i
   const availability = useDatasourceAvailability(hub, readsDatasource ? widget.datasource : void 0);
   const supported = useDatasourceSupported(hub, readsDatasource ? widget.datasource : void 0);
   if (!supported) {
-    return /* @__PURE__ */ jsx11(WidgetNotForCustomerUsersFrame, { widget });
+    return /* @__PURE__ */ jsx10(WidgetNotForCustomerUsersFrame, { widget });
   }
   if (availability === "unavailable") {
-    return /* @__PURE__ */ jsx11(WidgetUnavailableFrame, { widget });
+    return /* @__PURE__ */ jsx10(WidgetUnavailableFrame, { widget });
   }
   if (widget.type === UNKNOWN_WIDGET_TYPE) {
-    return /* @__PURE__ */ jsx11(UnresolvedWidgetFrame, { storedType: widget.raw.type, reason: widget.reason });
+    return /* @__PURE__ */ jsx10(UnresolvedWidgetFrame, { storedType: widget.raw.type, reason: widget.reason });
   }
   if (!descriptor || !implementation) {
-    return /* @__PURE__ */ jsx11(
+    return /* @__PURE__ */ jsx10(
       UnresolvedWidgetFrame,
       {
         storedType: widget.type,
@@ -2229,7 +2416,7 @@ function ConnectedWidgetBody({ widget, hub, registry, actions, initialSamples, i
       }
     );
   }
-  return /* @__PURE__ */ jsx11(HostScope, { descriptor, actions, children: (hostActions) => /* @__PURE__ */ jsx11(
+  return /* @__PURE__ */ jsx10(HostScope, { descriptor, actions, children: (hostActions) => /* @__PURE__ */ jsx10(
     ChannelBody,
     {
       widget,
@@ -2245,8 +2432,8 @@ function ConnectedWidgetBody({ widget, hub, registry, actions, initialSamples, i
 }
 function useDatasourceSupported(hub, datasource) {
   const key = datasource ? JSON.stringify(datasource) : null;
-  const [refused, setRefused] = useState5(null);
-  useEffect3(() => {
+  const [refused, setRefused] = useState3(null);
+  useEffect2(() => {
     if (!datasource || !hub.isDatasourceSupported) return;
     let cancelled = false;
     hub.isDatasourceSupported(datasource).then(
@@ -2269,7 +2456,7 @@ function HostScope({
   children
 }) {
   const report = useReportRejection();
-  const select = useWidgetSelect();
+  const select = useWidgetSelect2();
   const candidates = useWidgetCandidates();
   const narrowed = useMemo4(() => narrowActions(actions, descriptor, report), [actions, descriptor, report]);
   const narrowedSelect = useMemo4(() => narrowSelect(select, descriptor), [select, descriptor]);
@@ -2277,36 +2464,40 @@ function HostScope({
     () => narrowCandidates(candidates, descriptor, report),
     [candidates, descriptor, report]
   );
-  return /* @__PURE__ */ jsx11(WidgetSelectProvider, { select: narrowedSelect, children: /* @__PURE__ */ jsx11(WidgetCandidatesProvider, { candidates: narrowedCandidates, children: children(narrowed) }) });
+  return /* @__PURE__ */ jsx10(WidgetSelectProvider, { select: narrowedSelect, children: /* @__PURE__ */ jsx10(WidgetCandidatesProvider, { candidates: narrowedCandidates, children: children(narrowed) }) });
 }
 function ChannelBody(props) {
   switch (props.descriptor.channel) {
     case "alarm":
-      return /* @__PURE__ */ jsx11(AlarmConnectedWidget, { ...props });
+      return /* @__PURE__ */ jsx10(AlarmConnectedWidget, { ...props });
     case "control":
-      return /* @__PURE__ */ jsx11(ControlConnectedWidget, { ...props });
+      return /* @__PURE__ */ jsx10(ControlConnectedWidget, { ...props });
     case "location":
-      return /* @__PURE__ */ jsx11(LocationConnectedWidget, { ...props });
+      return /* @__PURE__ */ jsx10(LocationConnectedWidget, { ...props });
     case "aggregate":
-      return /* @__PURE__ */ jsx11(AggregateConnectedWidget, { ...props });
+      return /* @__PURE__ */ jsx10(AggregateConnectedWidget, { ...props });
     case "selection":
     case "none":
-      return /* @__PURE__ */ jsx11(StaticConnectedWidget, { ...props });
+      return /* @__PURE__ */ jsx10(StaticConnectedWidget, { ...props });
     case "measurement":
-      return /* @__PURE__ */ jsx11(MeasurementConnectedWidget, { ...props });
+      return /* @__PURE__ */ jsx10(MeasurementConnectedWidget, { ...props });
   }
 }
 function StaticConnectedWidget({ widget, Component: Component2, actions }) {
-  return /* @__PURE__ */ jsx11(Component2, { widget, data: null, actions });
+  return /* @__PURE__ */ jsx10(Component2, { widget, data: null, actions });
 }
-var FleetFeed = lazyChunk(() => import("./chunks/fleet-feed-5QGDLOV5.js")).component("default");
+var FleetFeed = lazyChunk(() => import("./chunks/fleet-feed-2SKDR6ZQ.js")).component("default", void 0, ChunkLoadingFrame);
+var PresenceFeed = lazyChunk(() => import("./chunks/presence-widgets-2LIUKN4Y.js")).component("PresenceFeed");
 function MeasurementConnectedWidget(props) {
+  if (presenceMode(props.descriptor)) {
+    return /* @__PURE__ */ jsx10(PresenceFeed, { hub: props.hub, widget: props.widget, descriptor: props.descriptor, Component: props.Component, actions: props.actions, ErrorFrame: WidgetErrorFrame });
+  }
   const { widget, hub, descriptor, Component: Component2, actions } = props;
   const members = membersMode(descriptor, widget);
   if (members || widget.datasource?.kind === "anchor") {
-    return /* @__PURE__ */ jsx11(FleetFeed, { hub, widget, descriptor, Component: Component2, actions, ErrorFrame: WidgetErrorFrame, refuse: !members });
+    return /* @__PURE__ */ jsx10(FleetFeed, { hub, widget, descriptor, Component: Component2, actions, ErrorFrame: WidgetErrorFrame, refuse: !members });
   }
-  return /* @__PURE__ */ jsx11(StreamConnectedWidget, { ...props });
+  return /* @__PURE__ */ jsx10(StreamConnectedWidget, { ...props });
 }
 function StreamConnectedWidget({ widget, hub, descriptor, Component: Component2, actions, initialSamples, initialSamplesAsOf, onReconnect }) {
   const range = useWidgetTimeRange2();
@@ -2322,42 +2513,58 @@ function StreamConnectedWidget({ widget, hub, descriptor, Component: Component2,
   });
   const freshness = useMemo4(() => {
     if (descriptor.freshness !== true) return void 0;
-    const pinned = optString7(widget.options, "measurement");
+    const pinned = measurementIsMembersOnly(descriptor) ? void 0 : optString7(widget.options, "measurement");
     const names = pinned ? [pinned] : widget.datasource?.measurements;
     return {
       at: newestSampleTime(data.latest, names),
       staleAfterSeconds: resolveStaleAfterSeconds(widget.options)
     };
   }, [descriptor, widget.options, widget.datasource, data.latest]);
-  if (data.error) return /* @__PURE__ */ jsx11(WidgetErrorFrame, { widget, error: data.error });
-  return /* @__PURE__ */ jsx11(WidgetFreshnessProvider, { freshness, children: /* @__PURE__ */ jsx11(Component2, { widget, data, actions }) });
+  if (data.error) return /* @__PURE__ */ jsx10(WidgetErrorFrame, { widget, error: data.error });
+  return /* @__PURE__ */ jsx10(WidgetFreshnessProvider, { freshness, children: wantsEventMarkers(descriptor, widget) ? /* @__PURE__ */ jsx10(EventMarkersFeed, { hub, widget, descriptor, data, Component: Component2, actions }) : /* @__PURE__ */ jsx10(Component2, { widget, data, actions }) });
 }
-var AggregateFeed = lazyChunk(() => import("./chunks/aggregate-feed-BD3CHNFU.js")).component("default");
+var EventMarkersFeed = lazyChunk(() => import("./chunks/event-markers-feed-GEGTIHXT.js")).component("default");
+var AggregateFeed = lazyChunk(() => import("./chunks/aggregate-feed-4FSBQYJL.js")).component("default");
 function AggregateConnectedWidget({ widget, hub, descriptor, Component: Component2, actions }) {
   const props = { hub, widget, descriptor, Component: Component2, actions, ErrorFrame: WidgetErrorFrame };
-  return widget.datasource?.kind === "anchor" ? /* @__PURE__ */ jsx11(FleetFeed, { ...props, refuse: true }) : /* @__PURE__ */ jsx11(AggregateFeed, { ...props });
+  return widget.datasource?.kind === "anchor" ? /* @__PURE__ */ jsx10(FleetFeed, { ...props, refuse: true }) : /* @__PURE__ */ jsx10(AggregateFeed, { ...props });
 }
-function AlarmConnectedWidget({ widget, hub, descriptor, Component: Component2, actions }) {
+var GroupedAlarm = lazyChunk(() => import("./chunks/alarm-widgets-X4PX5MYJ.js")).component("GroupedAlarm");
+function AlarmConnectedWidget(props) {
+  return groupsAlarmsByDeviceType(props.descriptor, props.widget) ? /* @__PURE__ */ jsx10(
+    GroupedAlarm,
+    {
+      hub: props.hub,
+      widget: props.widget,
+      base: alarmSubscription(props.descriptor, props.widget),
+      useHeld,
+      Component: props.Component,
+      actions: props.actions,
+      ErrorFrame: WidgetErrorFrame
+    }
+  ) : /* @__PURE__ */ jsx10(PlainAlarmConnectedWidget, { ...props });
+}
+function PlainAlarmConnectedWidget({ widget, hub, descriptor, Component: Component2, actions }) {
   const range = useWidgetTimeRange2();
   const live = useAlarmStream(hub, alarmSubscription(descriptor, widget));
   const data = useHeld(live, range?.paused === true, (s) => !s.loading);
   if (data.error && data.alarms.length === 0 && data.total === 0) {
-    return /* @__PURE__ */ jsx11(WidgetErrorFrame, { widget, error: data.error });
+    return /* @__PURE__ */ jsx10(WidgetErrorFrame, { widget, error: data.error });
   }
-  return /* @__PURE__ */ jsx11(Component2, { widget, data, actions });
+  return /* @__PURE__ */ jsx10(Component2, { widget, data, actions });
 }
 function ControlConnectedWidget({ widget, hub, descriptor, Component: Component2, actions }) {
   const data = useCommandStream(hub, commandSubscription(descriptor, widget));
-  return /* @__PURE__ */ jsx11(Component2, { widget, data, actions });
+  return /* @__PURE__ */ jsx10(Component2, { widget, data, actions });
 }
 function LocationConnectedWidget({ widget, hub, Component: Component2, actions }) {
   const range = useWidgetTimeRange2();
   const live = useLocationStream(hub, { datasource: widget.datasource });
   const data = useHeld(live, range?.paused === true, (s) => !s.loading);
   if (data.error && data.locations.length === 0) {
-    return /* @__PURE__ */ jsx11(WidgetErrorFrame, { widget, error: data.error });
+    return /* @__PURE__ */ jsx10(WidgetErrorFrame, { widget, error: data.error });
   }
-  return /* @__PURE__ */ jsx11(Component2, { widget, data, actions });
+  return /* @__PURE__ */ jsx10(Component2, { widget, data, actions });
 }
 var STATE_STYLE = {
   display: "flex",
@@ -2378,64 +2585,64 @@ function UnresolvedWidgetFrame({
 }) {
   const storedType = typeof stored === "string" ? stored : "";
   const heading = (reason?.code ?? "unregistered") === "unregistered" ? "This widget needs a newer viewer" : "This widget cannot be shown here";
-  return /* @__PURE__ */ jsx11(WidgetFrame8, { children: /* @__PURE__ */ jsxs6(
+  return /* @__PURE__ */ jsx10(WidgetFrame8, { children: /* @__PURE__ */ jsxs6(
     "div",
     {
       style: STATE_STYLE,
       children: [
-        /* @__PURE__ */ jsx11("div", { style: { fontSize: 13, fontWeight: 600 }, children: heading }),
+        /* @__PURE__ */ jsx10("div", { style: { fontSize: 13, fontWeight: 600 }, children: heading }),
         storedType && !reason?.message.includes(storedType) && /* @__PURE__ */ jsxs6("div", { style: { fontSize: 11, opacity: 0.8 }, children: [
           "Widget type: ",
           storedType
         ] }),
-        reason && /* @__PURE__ */ jsx11("div", { style: { fontSize: 11, opacity: 0.8, wordBreak: "break-word" }, children: reason.message })
+        reason && /* @__PURE__ */ jsx10("div", { style: { fontSize: 11, opacity: 0.8, wordBreak: "break-word" }, children: reason.message })
       ]
     }
   ) });
 }
 function WidgetForbiddenFrame({ widget }) {
-  return /* @__PURE__ */ jsx11(WidgetFrame8, { title: optString7(widget.options, "title"), children: /* @__PURE__ */ jsxs6("div", { role: "status", style: STATE_STYLE, children: [
-    /* @__PURE__ */ jsx11("div", { style: { fontSize: 20, lineHeight: 1 }, "aria-hidden": "true", children: "\u2298" }),
-    /* @__PURE__ */ jsx11("div", { style: { fontSize: 13, fontWeight: 600 }, children: accessStrings().forbidden })
+  return /* @__PURE__ */ jsx10(WidgetFrame8, { title: optString7(widget.options, "title"), children: /* @__PURE__ */ jsxs6("div", { role: "status", style: STATE_STYLE, children: [
+    /* @__PURE__ */ jsx10("div", { style: { fontSize: 20, lineHeight: 1 }, "aria-hidden": "true", children: "\u2298" }),
+    /* @__PURE__ */ jsx10("div", { style: { fontSize: 13, fontWeight: 600 }, children: accessStrings().forbidden })
   ] }) });
 }
 function WidgetUnavailableFrame({ widget }) {
-  return /* @__PURE__ */ jsx11(WidgetFrame8, { title: optString7(widget.options, "title"), children: /* @__PURE__ */ jsxs6(
+  return /* @__PURE__ */ jsx10(WidgetFrame8, { title: optString7(widget.options, "title"), children: /* @__PURE__ */ jsxs6(
     "div",
     {
       style: STATE_STYLE,
       children: [
-        /* @__PURE__ */ jsx11("div", { style: { fontSize: 20, lineHeight: 1 }, "aria-hidden": "true", children: "\u2298" }),
-        /* @__PURE__ */ jsx11("div", { style: { fontSize: 13, fontWeight: 600 }, children: "Device unavailable" }),
-        /* @__PURE__ */ jsx11("div", { style: { fontSize: 11, opacity: 0.8 }, children: "The bound device no longer exists." })
+        /* @__PURE__ */ jsx10("div", { style: { fontSize: 20, lineHeight: 1 }, "aria-hidden": "true", children: "\u2298" }),
+        /* @__PURE__ */ jsx10("div", { style: { fontSize: 13, fontWeight: 600 }, children: "Device unavailable" }),
+        /* @__PURE__ */ jsx10("div", { style: { fontSize: 11, opacity: 0.8 }, children: "The bound device no longer exists." })
       ]
     }
   ) });
 }
 function WidgetNotForCustomerUsersFrame({ widget }) {
-  return /* @__PURE__ */ jsx11(WidgetFrame8, { title: optString7(widget.options, "title"), children: /* @__PURE__ */ jsxs6(
+  return /* @__PURE__ */ jsx10(WidgetFrame8, { title: optString7(widget.options, "title"), children: /* @__PURE__ */ jsxs6(
     "div",
     {
       role: "status",
       style: STATE_STYLE,
       children: [
-        /* @__PURE__ */ jsx11("div", { style: { fontSize: 20, lineHeight: 1 }, "aria-hidden": "true", children: "\u2298" }),
-        /* @__PURE__ */ jsx11("div", { style: { fontSize: 13, fontWeight: 600 }, children: "Not available for customer users" }),
-        /* @__PURE__ */ jsx11("div", { style: { fontSize: 11, opacity: 0.8 }, children: "This widget is bound to an area or an asset, which customer users cannot view." })
+        /* @__PURE__ */ jsx10("div", { style: { fontSize: 20, lineHeight: 1 }, "aria-hidden": "true", children: "\u2298" }),
+        /* @__PURE__ */ jsx10("div", { style: { fontSize: 13, fontWeight: 600 }, children: "Not available for customer users" }),
+        /* @__PURE__ */ jsx10("div", { style: { fontSize: 11, opacity: 0.8 }, children: "This widget is bound to an area or an asset, which customer users cannot view." })
       ]
     }
   ) });
 }
 function WidgetErrorFrame({ widget, error }) {
-  if (isForbiddenError(error)) return /* @__PURE__ */ jsx11(WidgetForbiddenFrame, { widget });
-  return /* @__PURE__ */ jsx11(WidgetFrame8, { title: optString7(widget.options, "title"), children: /* @__PURE__ */ jsxs6(
+  if (isForbiddenError(error)) return /* @__PURE__ */ jsx10(WidgetForbiddenFrame, { widget });
+  return /* @__PURE__ */ jsx10(WidgetFrame8, { title: optString7(widget.options, "title"), children: /* @__PURE__ */ jsxs6(
     "div",
     {
       style: STATE_STYLE,
       children: [
-        /* @__PURE__ */ jsx11("div", { style: { fontSize: 20, lineHeight: 1 }, children: "\u26A0" }),
-        /* @__PURE__ */ jsx11("div", { style: { fontSize: 13, fontWeight: 600 }, children: "Data unavailable" }),
-        /* @__PURE__ */ jsx11("div", { style: { fontSize: 11, opacity: 0.8, wordBreak: "break-word" }, children: String(error) })
+        /* @__PURE__ */ jsx10("div", { style: { fontSize: 20, lineHeight: 1 }, children: "\u26A0" }),
+        /* @__PURE__ */ jsx10("div", { style: { fontSize: 13, fontWeight: 600 }, children: "Data unavailable" }),
+        /* @__PURE__ */ jsx10("div", { style: { fontSize: 11, opacity: 0.8, wordBreak: "break-word" }, children: String(error) })
       ]
     }
   ) });
@@ -2449,7 +2656,7 @@ import {
   WidgetThemeRootProvider,
   WidgetTimeZoneProvider
 } from "@devicechain/widget-sdk";
-import { Fragment as Fragment2, jsx as jsx12, jsxs as jsxs7 } from "react/jsx-runtime";
+import { Fragment as Fragment2, jsx as jsx11, jsxs as jsxs7 } from "react/jsx-runtime";
 function DashboardRenderer({
   definition,
   hub,
@@ -2498,8 +2705,8 @@ function DashboardRenderer({
       "data-time-paused": range.paused ? "" : void 0,
       style: { ...sizingStyle(effectiveSizing, bg), ...tokenStyle(scale) },
       children: [
-        /* @__PURE__ */ jsx12(WidgetTokenStyles, {}),
-        /* @__PURE__ */ jsx12(WidgetDensityProvider, { scale, children: /* @__PURE__ */ jsx12(WidgetThemeRootProvider, { root: themeRoot, children: /* @__PURE__ */ jsx12(WidgetTimeZoneProvider, { timeZone, children: /* @__PURE__ */ jsx12(WidgetTimeRangeProvider, { range, children: /* @__PURE__ */ jsx12(WidgetSelectProvider2, { select, children: /* @__PURE__ */ jsx12(WidgetCandidatesProvider2, { candidates, children: /* @__PURE__ */ jsx12("div", { style: { padding: lengths.padding }, children: /* @__PURE__ */ jsx12("div", { style: { containerType: "inline-size" }, children: /* @__PURE__ */ jsx12(
+        /* @__PURE__ */ jsx11(WidgetTokenStyles, {}),
+        /* @__PURE__ */ jsx11(WidgetDensityProvider, { scale, children: /* @__PURE__ */ jsx11(WidgetThemeRootProvider, { root: themeRoot, children: /* @__PURE__ */ jsx11(WidgetTimeZoneProvider, { timeZone, children: /* @__PURE__ */ jsx11(WidgetTimeRangeProvider, { range, children: /* @__PURE__ */ jsx11(WidgetSelectProvider2, { select, children: /* @__PURE__ */ jsx11(WidgetCandidatesProvider2, { candidates, children: /* @__PURE__ */ jsx11("div", { style: { padding: lengths.padding }, children: /* @__PURE__ */ jsx11("div", { style: { containerType: "inline-size" }, children: /* @__PURE__ */ jsx11(
           "div",
           {
             "data-grid": "",
@@ -2512,7 +2719,7 @@ function DashboardRenderer({
               width: "100%",
               ...{ "--dc-cell": lengths.cell }
             },
-            children: /* @__PURE__ */ jsx12(
+            children: /* @__PURE__ */ jsx11(
               PlacedWidgets,
               {
                 widgets,
@@ -2520,7 +2727,7 @@ function DashboardRenderer({
                 columns,
                 grid: layout.grid,
                 lengths,
-                render: (widget) => /* @__PURE__ */ jsx12(WidgetFrameStyleProvider, { frame: resolveFrame(canvasFrame, widgetFrame(widget)), children: /* @__PURE__ */ jsx12(WidgetSubjectProvider, { label: widgetSubjectLabel(widget), children: /* @__PURE__ */ jsx12(
+                render: (widget) => /* @__PURE__ */ jsx11(WidgetFrameStyleProvider, { frame: resolveFrame(canvasFrame, widgetFrame(widget)), children: /* @__PURE__ */ jsx11(WidgetSubjectProvider, { label: widgetSubjectLabel(widget), children: /* @__PURE__ */ jsx11(
                   ConnectedWidget,
                   {
                     widget,
@@ -2608,15 +2815,15 @@ function PlacedWidgets({
       relative(widget.id)
     ] }, widget.id)
   ));
-  return /* @__PURE__ */ jsx12(Fragment2, { children: placed.map(({ widget, placement }) => {
+  return /* @__PURE__ */ jsx11(Fragment2, { children: placed.map(({ widget, placement }) => {
     if (placement.mode !== "grid") return null;
     const style = gridItemStyle(grid.get(widget.id) ?? placement, columns);
     return /* @__PURE__ */ jsxs7(Fragment, { children: [
-      /* @__PURE__ */ jsx12("div", { "data-widget": widget.id, style, children: render(widget) }),
+      /* @__PURE__ */ jsx11("div", { "data-widget": widget.id, style, children: render(widget) }),
       dependents.has(widget.id) ? (
         // The host's area again, as a layer for its relative widgets to be positioned in.
         // It takes no pointer events itself, so the host underneath stays usable.
-        /* @__PURE__ */ jsx12("div", { style: { ...style, position: "relative", pointerEvents: "none", zIndex: RELATIVE_Z }, children: relative(widget.id) })
+        /* @__PURE__ */ jsx11("div", { style: { ...style, position: "relative", pointerEvents: "none", zIndex: RELATIVE_Z }, children: relative(widget.id) })
       ) : null
     ] }, widget.id);
   }) });
@@ -2647,7 +2854,7 @@ function widgetSubjectLabel(widget) {
 }
 function useContainerWidth(keyOf) {
   const ref = useRef2(null);
-  const [width, setWidth] = useState6(0);
+  const [width, setWidth] = useState4(0);
   const keyOfRef = useRef2(keyOf);
   const measure = useCallback2(() => {
     const el = ref.current;
@@ -2676,12 +2883,12 @@ function seedKey(widget, registry) {
   return JSON.stringify(widget.datasource ?? null);
 }
 function useWidgetHistories(widgets, enabled, registry, range) {
-  const [seeds, setSeeds] = useState6({});
+  const [seeds, setSeeds] = useState4({});
   const requested = useRef2({});
   const reseeds = useRef2({});
-  const [reseedTick, bumpReseeds] = useState6(0);
+  const [reseedTick, bumpReseeds] = useState4(0);
   const mounted = useRef2(true);
-  useEffect4(() => {
+  useEffect3(() => {
     mounted.current = true;
     return () => {
       mounted.current = false;
@@ -2699,7 +2906,7 @@ function useWidgetHistories(widgets, enabled, registry, range) {
     return [[w.id, key, span]];
   });
   const wantedKey = JSON.stringify(wanted);
-  useEffect4(() => {
+  useEffect3(() => {
     if (!enabled) {
       requested.current = {};
       setSeeds({});
@@ -2759,12 +2966,12 @@ import {
   spanLabel as spanLabel2,
   withSpan
 } from "@devicechain/dashboards";
-import { useCallback as useCallback3, useEffect as useEffect5, useMemo as useMemo6, useRef as useRef3, useState as useState7 } from "react";
-import { jsx as jsx13, jsxs as jsxs8 } from "react/jsx-runtime";
+import { useCallback as useCallback3, useEffect as useEffect4, useMemo as useMemo6, useRef as useRef3, useState as useState5 } from "react";
+import { jsx as jsx12, jsxs as jsxs8 } from "react/jsx-runtime";
 function useBoardTimeRange(defaultSeconds, link = {}) {
-  const [state, setState] = useState7(() => initialTimeRange2(defaultSeconds, link));
+  const [state, setState] = useState5(() => initialTimeRange2(defaultSeconds, link));
   const lastDefault = useRef3(defaultSeconds);
-  useEffect5(() => {
+  useEffect4(() => {
     if (lastDefault.current === defaultSeconds) return;
     lastDefault.current = defaultSeconds;
     setState((s) => withSpan(s, isValidSpanSeconds2(defaultSeconds) ? defaultSeconds : DEFAULT_TIME_RANGE_SECONDS));
@@ -2823,10 +3030,10 @@ function PausedIndicator({
         borderRadius: 4
       },
       children: [
-        /* @__PURE__ */ jsx13("span", { "aria-hidden": "true", children: "\u23F8" }),
+        /* @__PURE__ */ jsx12("span", { "aria-hidden": "true", children: "\u23F8" }),
         labels.paused,
-        time ? /* @__PURE__ */ jsx13("span", { style: { fontWeight: 400, textTransform: "none" }, children: ` ${time}` }) : null,
-        /* @__PURE__ */ jsx13("span", { "data-time-range-actions-live": "", style: { fontWeight: 400, textTransform: "none" }, children: `\xB7 ${labels.actionsLive}` })
+        time ? /* @__PURE__ */ jsx12("span", { style: { fontWeight: 400, textTransform: "none" }, children: ` ${time}` }) : null,
+        /* @__PURE__ */ jsx12("span", { "data-time-range-actions-live": "", style: { fontWeight: 400, textTransform: "none" }, children: `\xB7 ${labels.actionsLive}` })
       ]
     }
   );
@@ -2846,8 +3053,8 @@ function TimeRangeBar({
       "aria-label": labels.range,
       style: { display: "inline-flex", alignItems: "center", gap: 6, flexWrap: "wrap" },
       children: [
-        preset === void 0 ? /* @__PURE__ */ jsx13("button", { type: "button", "aria-pressed": "true", "data-range": spanLabel2(state.spanSeconds), style: button(true), children: spanLabel2(state.spanSeconds) }) : null,
-        TIME_RANGE_PRESETS.map((p) => /* @__PURE__ */ jsx13(
+        preset === void 0 ? /* @__PURE__ */ jsx12("button", { type: "button", "aria-pressed": "true", "data-range": spanLabel2(state.spanSeconds), style: button(true), children: spanLabel2(state.spanSeconds) }) : null,
+        TIME_RANGE_PRESETS.map((p) => /* @__PURE__ */ jsx12(
           "button",
           {
             type: "button",
@@ -2859,12 +3066,348 @@ function TimeRangeBar({
           },
           p.id
         )),
-        /* @__PURE__ */ jsx13("button", { type: "button", "aria-pressed": state.paused, "data-time-range-pause": "", onClick: onPause, style: button(state.paused), children: state.paused ? labels.resume : labels.pause }),
-        state.paused ? /* @__PURE__ */ jsx13(PausedIndicator, { pausedAt: state.pausedAt, labels }) : null
+        /* @__PURE__ */ jsx12("button", { type: "button", "aria-pressed": state.paused, "data-time-range-pause": "", onClick: onPause, style: button(state.paused), children: state.paused ? labels.resume : labels.pause }),
+        state.paused ? /* @__PURE__ */ jsx12(PausedIndicator, { pausedAt: state.pausedAt, labels }) : null
+      ]
+    }
+  );
+}
+
+// src/use-bound-devices.ts
+import {
+  bindParamsOf,
+  bindsToSelection,
+  parseBindParams,
+  selectionToBinds,
+  validateBinds,
+  withBindParams
+} from "@devicechain/dashboards";
+import { useCallback as useCallback4, useEffect as useEffect5, useRef as useRef4, useState as useState6 } from "react";
+var NO_PROBLEMS = { issues: [], missing: [], failed: [] };
+function hasBindParams(search, definition) {
+  const { binds, issues } = parseBindParams(search, definition);
+  return Object.keys(binds).length > 0 || issues.length > 0;
+}
+function useBoundDevices({
+  definition,
+  resolver,
+  address,
+  enabled = true
+}) {
+  const [core, setCore] = useState6(() => ({
+    selection: {},
+    synced: bindParamsOf(address.search)
+  }));
+  const { selection } = core;
+  const [phase, setPhase] = useState6(
+    () => hasBindParams(address.search, definition) ? "checking" : "ready"
+  );
+  const [problems, setProblems] = useState6(null);
+  const [okBinds, setOkBinds] = useState6({});
+  const definitionRef = useRef4(definition);
+  definitionRef.current = definition;
+  const resolverRef = useRef4(resolver);
+  resolverRef.current = resolver;
+  const replaceRef = useRef4(address.replaceSearch);
+  replaceRef.current = address.replaceSearch;
+  const seenRef = useRef4(null);
+  const generation = useRef4(0);
+  const [attempt, setAttempt] = useState6(0);
+  const search = address.search;
+  useEffect5(() => {
+    if (!enabled) return;
+    const slice = bindParamsOf(search);
+    if (seenRef.current === slice) return;
+    seenRef.current = slice;
+    const parsed = parseBindParams(search, definitionRef.current);
+    if (Object.keys(parsed.binds).length === 0 && parsed.issues.length === 0) {
+      generation.current += 1;
+      setCore({ selection: {}, synced: slice });
+      setProblems(null);
+      setPhase("ready");
+      return;
+    }
+    const gen = ++generation.current;
+    setPhase("checking");
+    void validateBinds(parsed.binds, resolverRef.current).then((check) => {
+      if (gen !== generation.current) return;
+      setOkBinds(check.ok);
+      if (parsed.issues.length === 0 && check.missing.length === 0 && check.failed.length === 0) {
+        setCore({ selection: bindsToSelection(check.ok), synced: slice });
+        setProblems(null);
+        setPhase("ready");
+      } else {
+        setProblems({ issues: parsed.issues, missing: check.missing, failed: check.failed });
+        setCore((c) => ({ ...c, synced: slice }));
+        setPhase("refused");
+      }
+    });
+  }, [search, enabled, attempt]);
+  useEffect5(() => {
+    if (!enabled || phase !== "ready") return;
+    const current = bindParamsOf(search);
+    if (current !== core.synced) return;
+    const next = withBindParams(search, selectionToBinds(core.selection, definition));
+    const nextSlice = bindParamsOf(next);
+    if (nextSlice === current) return;
+    seenRef.current = nextSlice;
+    setCore((c) => ({ ...c, synced: nextSlice }));
+    replaceRef.current(next);
+  }, [core, definition, phase, enabled, search]);
+  const select = useCallback4((t) => {
+    setCore((c) => ({ ...c, selection: { ...c.selection, [t.slot]: t.binding } }));
+  }, []);
+  const reset = useCallback4(() => setCore((c) => ({ ...c, selection: {} })), []);
+  const dismiss = useCallback4(() => {
+    setCore((c) => ({ ...c, selection: bindsToSelection(okBinds) }));
+    setProblems(null);
+    setPhase("ready");
+  }, [okBinds]);
+  const retry = useCallback4(() => {
+    seenRef.current = null;
+    setAttempt((n) => n + 1);
+  }, []);
+  return { selection, select, reset, phase, problems: phase === "refused" ? problems ?? NO_PROBLEMS : null, dismiss, retry };
+}
+
+// src/bound-devices-notice.tsx
+import { css as css6, fontVar as fontVar6 } from "@devicechain/widget-sdk";
+import { jsx as jsx13, jsxs as jsxs9 } from "react/jsx-runtime";
+function BoundDevicesNotice({ title, lines, dismissLabel, onDismiss, retryLabel, onRetry }) {
+  const button2 = {
+    minHeight: 44,
+    padding: "0 16px",
+    borderRadius: 8,
+    border: `1px solid ${css6("border")}`,
+    background: css6("card"),
+    color: css6("foreground"),
+    fontSize: fontVar6("md"),
+    cursor: "pointer"
+  };
+  return /* @__PURE__ */ jsxs9(
+    "div",
+    {
+      role: "alert",
+      "data-testid": "bound-devices-notice",
+      style: {
+        boxSizing: "border-box",
+        display: "flex",
+        flexDirection: "column",
+        alignItems: "flex-start",
+        gap: 12,
+        maxWidth: 560,
+        margin: "24px auto",
+        padding: 16,
+        borderRadius: 8,
+        border: `1px solid ${css6("border")}`,
+        background: css6("card"),
+        color: css6("foreground")
+      },
+      children: [
+        /* @__PURE__ */ jsx13("div", { style: { fontSize: fontVar6("lg"), fontWeight: 600 }, children: title }),
+        /* @__PURE__ */ jsx13("ul", { style: { margin: 0, paddingLeft: 20, display: "flex", flexDirection: "column", gap: 4, fontSize: fontVar6("md") }, children: lines.map((line, i) => /* @__PURE__ */ jsx13("li", { style: { overflowWrap: "anywhere" }, children: line }, i)) }),
+        /* @__PURE__ */ jsxs9("div", { style: { display: "flex", flexWrap: "wrap", gap: 8 }, children: [
+          retryLabel && onRetry ? /* @__PURE__ */ jsx13("button", { type: "button", style: button2, onClick: onRetry, "data-testid": "bound-devices-retry", children: retryLabel }) : null,
+          /* @__PURE__ */ jsx13("button", { type: "button", style: button2, onClick: onDismiss, "data-testid": "bound-devices-dismiss", children: dismissLabel })
+        ] })
       ]
     }
   );
 }
+var ECHO_MAX = 48;
+var echo = (s) => s.length > ECHO_MAX ? `${s.slice(0, ECHO_MAX)}\u2026` : s;
+function describeBoundDevicesProblems(problems, w) {
+  const out = [];
+  for (const i of problems.issues) {
+    const slot = echo(i.slot);
+    if (i.kind === "unknown-slot") out.push(w.unknownSlot(slot));
+    else if (i.kind === "not-a-device-slot") out.push(w.notADeviceSlot(slot));
+    else if (i.kind === "duplicate-slot") out.push(w.duplicateSlot(slot));
+    else if (i.kind === "derived-slot") out.push(w.derivedSlot(slot));
+    else if (i.kind === "invalid-token") out.push(w.invalidToken(slot, echo(i.token)));
+    else {
+      const unhandled = i;
+      throw new Error(`describeBoundDevicesProblems: unworded link issue ${JSON.stringify(unhandled)}`);
+    }
+  }
+  for (const m of problems.missing) out.push(w.missing(m.slot, m.token));
+  for (const f of problems.failed) out.push(w.failed(f.slot, f.token));
+  return out;
+}
+
+// src/documented-descriptors.ts
+import { createWidgetCatalog as createWidgetCatalog2 } from "@devicechain/dashboards";
+import { createWidgetRegistry as createWidgetRegistry2 } from "@devicechain/widget-sdk";
+
+// src/builtin-option-docs.ts
+var OPTION_DOCS = {
+  title: "Heading shown in the widget frame. Blank hides the frame heading.",
+  unit: "Unit suffix shown beside the value.",
+  precision: "Decimal places to round displayed values to. Unset rounds to at most 3 decimals (4 significant digits under 1).",
+  thresholds: "Severity bands over the value. Each entry starts a band at its value that runs to the next entry; below the first, and in a normal band, the widget keeps its own colour.",
+  "thresholds.value": "The value at which this band starts.",
+  "thresholds.level": "The severity of this band. The theme decides the colour; normal has none.",
+  "thresholds.label": "Text shown on the chart line for this threshold. Defaults to its value.",
+  staleAfterSeconds: "Seconds after which the newest sample is called stale: the value is greyed out and badged. Unset shows the sample age only and never marks the widget stale.",
+  windowSeconds: "Seconds of history the widget covers, back from now. Leave unset to follow the board\u2019s time range; set it to pin this widget to a fixed span that the viewer\u2019s range picker does not change. 60 to 604800.",
+  measurement: "Which measurement to display. Defaults to the first the datasource selects.",
+  flashOnChange: "Briefly tint a value green on a rise and red on a fall when it changes.",
+  window: "Samples retained across ALL of the widget's measurements before the oldest are dropped. Bounds memory; only the chart draws them. Default 300.",
+  min: "Value at the empty end of the scale. Required: the widget does not guess a range.",
+  max: "Value at the full end of the scale. Required, and above min.",
+  text: "The text to show. Rendered as plain text \u2014 markup is never interpreted.",
+  align: "Horizontal alignment of the text. Default center.",
+  fontSize: "Text size in pixels at the comfortable density; it scales with the board density. Default 16.",
+  url: "Source URL of the image.",
+  alt: "Alternative text describing the image for assistive technology.",
+  fit: "How the image fills its box. Default contain.",
+  state: "Show only alarms in this state. Unset shows every state.",
+  severity: "Show only alarms at this severity. Unset shows every severity.",
+  acknowledged: "Show only acknowledged ('true') or unacknowledged ('false') alarms. Unset shows both.",
+  groupBy: "deviceType: a tab per device type.",
+  deviceType: "Only alarms on devices of this type (token).",
+  deviceTypes: "Types to tab, in order; unset tabs all.",
+  "deviceTypes.token": "Type token.",
+  maxRows: "Alarms loaded into the table. Default 50.",
+  selectionTarget: "Name of the slot this widget re-points when the viewer picks an entity.",
+  commandName: "Command key issued to the target device. Without it the control cannot send.",
+  commandLabel: "Name of the control for assistive technology. Defaults to the command key.",
+  parameterSchema: "The command's parameter descriptors, baked in as JSON at author time. Gives the control its range and its refusals.",
+  tileUrl: "Raster tile URL template, e.g. https://tiles.example.com/{z}/{x}/{y}.png. Leave empty to inherit the tenant's basemap; setting one overrides it for this board only.",
+  attribution: "Credit line the tile source requires, shown on the map. Set whatever the provider you chose asks for.",
+  style: "A plain bar (default) or a thermometer: a vertical tube with a bulb. A thermometer is always vertical.",
+  markAlarms: "Mark this device\u2019s alarms on the chart, from raise to clear.",
+  markAlarmsScope: "Which alarms to mark: only those about what this chart plots (series, the default for a new chart), or every alarm on the device. An alarm with no known measurement is never marked in series mode; it is listed under the chart as another alarm on the device. A chart saved before this option marks the whole device.",
+  markCommands: "Mark the commands sent to this device on the chart.",
+  orientation: "Direction of a bar: horizontal (default) or vertical. Ignored by a thermometer.",
+  readout: "What the readout shows: the value with its unit (default) or the percent of the scale.",
+  onAt: "For an on/off signal: the lamp is lit at or above this value and dark below it. Unset keeps the lamp lit while a value is present, coloured by its threshold band.",
+  parameter: "Which parameter of the command this control sets. May be left blank when the command has exactly one parameter of the right type.",
+  step: "Distance between values. Defaults to 1 for a whole-number parameter, else a hundredth of the range.",
+  mode: "Slider (default) or stepper: \u2212 / + and Send.",
+  stat: "Which figure to show. Default average.",
+  sparkline: "Draw the measurement\u2019s trend over the span under the figure. Default off.",
+  sort: "Order of the categories. Default: as the data source lists them.",
+  columns: "Heading, unit and precision per measurement column; a column with none shows its name.",
+  "columns.measurement": "The measurement column this entry applies to.",
+  "columns.label": "Column heading. Defaults to the measurement name.",
+  "columns.unit": "Unit suffix shown beside the value.",
+  "columns.precision": "Decimal places to round displayed values to. Unset rounds to at most 3 decimals (4 significant digits under 1).",
+  "thresholds.measurement": "The measurement column this entry applies to.",
+  ageLagSeconds: "Show a reading's age under it only when the reading is at least this many seconds older than the newest reading in the table (or stale). Unset shows every reading's age.",
+  sortBy: "The measurement the table is ordered by. Blank orders by device name.",
+  sortDescending: "Largest first.",
+  pageSize: "Devices per page. Default 20.",
+  maxSeries: "Most lines drawn when the chart shows one line per device. Default 5, at most 12. Each line costs one stored-history read, and the chart colours repeat after five; a group larger than this shows the first devices of the group and says how many it left out.",
+  show: "What to count: devices in an abnormal band of the measurement (default), or all devices."
+};
+var OPTION_DOC_OVERRIDES = {
+  "latest-card": {
+    title: "Heading shown in the widget frame. Defaults to the displayed measurement name."
+  },
+  gauge: {
+    title: "Heading shown in the widget frame. Defaults to the displayed measurement name.",
+    min: "Low end of the gauge scale. Default 0.",
+    max: "High end of the gauge scale. Default 100."
+  },
+  "linear-gauge": {
+    title: "Heading shown in the widget frame. Defaults to the displayed measurement name."
+  },
+  "level-gauge": {
+    title: "Heading shown in the widget frame. Defaults to the displayed measurement name."
+  },
+  battery: {
+    title: "Heading shown in the widget frame. Defaults to the displayed measurement name.",
+    min: "Value of an empty battery. Default 0 (the scale is percent unless you set min and max).",
+    max: "Value of a full battery. Default 100 (the scale is percent unless you set min and max)."
+  },
+  "status-light": {
+    title: "Heading shown in the widget frame. Defaults to the displayed measurement name."
+  },
+  "signal-bars": {
+    title: "Heading shown in the widget frame. Defaults to the displayed measurement name.",
+    thresholds: "The steps of the signal, lowest first: one bar per entry, lit once the value reaches it and coloured by its level. At least two, at most eight."
+  },
+  compass: {
+    title: "Heading shown in the widget frame. Defaults to the displayed measurement name.",
+    precision: "Decimal places of the heading. Default 0 (whole degrees). The heading is rounded first, then folded onto 0 to 360, so it never reads 360.",
+    thresholds: "Severity bands over the heading in degrees (0 to 360, after folding). Each entry starts a band at its value that runs to the next entry; below the first, and in a normal band, the needle keeps its own colour."
+  },
+  "progress-ring": {
+    title: "Heading shown in the widget frame. Defaults to the displayed measurement name.",
+    readout: "What the middle of the ring shows: the percent of the scale (default) or the value with its unit."
+  },
+  "stat-card": {
+    title: "Heading shown in the widget frame. Defaults to the displayed measurement name."
+  },
+  "device-status": {
+    staleAfterSeconds: "Marks the card stale once its status has not been read for longer than this many seconds (it is re-read every 15 seconds, so only reads that keep failing make it stale). A device that is merely silent is not stale: whether it is online is the status itself. Unset, the age is shown and nothing is marked stale."
+  },
+  "online-doughnut": {
+    staleAfterSeconds: "Marks the ring stale once the status of its devices has not been read for longer than this many seconds (it is re-read every 15 seconds, so only reads that keep failing make it stale). Unset, the age is shown and nothing is marked stale."
+  },
+  "fleet-count": {
+    measurement: "The measurement whose bands flag a device. Defaults to the first the datasource selects."
+  },
+  "command-slider": {
+    min: "Lowest value, used only when the command's parameter declares no minimum.",
+    max: "Highest value, used only when the command's parameter declares no maximum."
+  },
+  "timeseries-chart": {
+    min: "Low end of the value axis. Unset, the axis starts where the chart picks. A reading or threshold below it still shows: the axis widens to take it in.",
+    max: "High end of the value axis, above min. Unset, the chart picks. A reading or threshold above it still shows: the axis widens to take it in.",
+    groupBy: "One line per measurement of one device (the default), or one line per device of a group for the measurement set below. Per device, stored history is drawn as the average of each time bucket (the chart says so), and thresholds are reference lines over it.",
+    measurement: "The measurement compared across the group. Defaults to the first the datasource selects. Used only with one line per device.",
+    markAlarms: "Mark this device\u2019s alarms on the chart, from raise to clear. Not drawn with one line per device.",
+    markCommands: "Mark the commands sent to this device on the chart. Not drawn with one line per device."
+  },
+  "bar-chart": {
+    groupBy: "One bar per measurement (the default), or per device of the group for the measurement set below."
+  },
+  "command-button": {
+    maxRows: "Recent commands shown in the history. Default 20.",
+    commandName: "Command key issued to the target device. Without it the widget cannot send.",
+    commandLabel: "Text on the send button. Defaults to the command key.",
+    parameterSchema: "The command's parameter descriptors, baked in as JSON at author time. Drives the typed form."
+  }
+};
+
+// src/documented-descriptors.ts
+function documentOptions(widgetId, specs, prefix) {
+  const out = {};
+  for (const [key, spec] of Object.entries(specs)) {
+    const path = `${prefix}${key}`;
+    const copy = { ...spec };
+    const doc = OPTION_DOC_OVERRIDES[widgetId]?.[path] ?? OPTION_DOCS[path];
+    if (doc !== void 0) copy.doc = doc;
+    if ("item" in spec && spec.item) copy.item = documentOptions(widgetId, spec.item, `${path}.`);
+    out[key] = copy;
+  }
+  return out;
+}
+function documentDescriptor(descriptor) {
+  return { ...descriptor, options: documentOptions(descriptor.id, descriptor.options, "") };
+}
+function documentAll(descriptors) {
+  return Object.fromEntries(Object.entries(descriptors).map(([id, d]) => [id, documentDescriptor(d)]));
+}
+var builtinWidgetDescriptors2 = /* @__PURE__ */ documentAll(builtinWidgetDescriptors);
+function catalogOf(descriptors) {
+  return createWidgetCatalog2(Object.values(descriptors));
+}
+var builtinWidgetCatalog2 = /* @__PURE__ */ catalogOf(builtinWidgetDescriptors2);
+function documentDefinitions(definitions) {
+  const byId = builtinWidgetDescriptors2;
+  return definitions.map((d) => ({ ...d, descriptor: byId[d.descriptor.id] }));
+}
+var builtinWidgetDefinitions2 = /* @__PURE__ */ documentDefinitions(builtinWidgetDefinitions);
+function createBuiltinWidgetRegistry2() {
+  return createWidgetRegistry2(builtinWidgetDefinitions2);
+}
+function optionsById(descriptors) {
+  return Object.freeze(Object.fromEntries(Object.entries(descriptors).map(([id, d]) => [id, d.options])));
+}
+var WIDGET_OPTIONS = /* @__PURE__ */ optionsById(builtinWidgetDescriptors2);
 
 // src/preload.ts
 async function preloadWidgets(registry, types) {
@@ -2895,23 +3438,23 @@ import {
   numberSpec,
   validateOptions
 } from "@devicechain/dashboards";
-var WIDGET_OPTIONS = Object.freeze(
+var WIDGET_OPTIONS2 = Object.freeze(
   Object.fromEntries(Object.entries(builtinWidgetDescriptors).map(([id, d]) => [id, d.options]))
 );
 function constraintsFor(widgetType) {
   return builtinWidgetCatalog.get(widgetType)?.constraints ?? [];
 }
 function validateWidgetOptions(widgetType, options) {
-  const specs = WIDGET_OPTIONS[widgetType];
+  const specs = WIDGET_OPTIONS2[widgetType];
   return validateOptions(specs, options, { constraints: constraintsFor(widgetType), label: widgetType }).map(
     ({ key, code, message }) => ({ widgetType, key, code, message })
   );
 }
 function numberOptionSpec(type, key) {
-  return numberSpec(WIDGET_OPTIONS[type], key);
+  return numberSpec(WIDGET_OPTIONS2[type], key);
 }
 function enumOptionValues(type, key) {
-  return enumValues(WIDGET_OPTIONS[type], key);
+  return enumValues(WIDGET_OPTIONS2[type], key);
 }
 
 // src/definition-options.ts
@@ -2963,7 +3506,7 @@ import {
   WidgetFrame as WidgetFrame9,
   WidgetSubjectProvider as WidgetSubjectProvider2,
   WidgetSelectProvider as WidgetSelectProvider3,
-  useWidgetSelect as useWidgetSelect2,
+  useWidgetSelect as useWidgetSelect3,
   WidgetTimeZoneProvider as WidgetTimeZoneProvider2,
   useWidgetTimeZone as useWidgetTimeZone3,
   WidgetThemeRootProvider as WidgetThemeRootProvider2,
@@ -2986,7 +3529,7 @@ import {
   useResolvedBindings,
   useSlotCandidates,
   useCandidates,
-  css as css6
+  css as css7
 } from "@devicechain/widget-sdk";
 import {
   EChart as EChart3,
@@ -2997,8 +3540,10 @@ import {
 } from "@devicechain/widget-sdk/echarts";
 export {
   AlarmCount,
+  AlarmSeverity,
   AlarmTable,
   BUNDLED_BASEMAP_ATTRIBUTION,
+  BoundDevicesNotice,
   CommandButton,
   ConnectedWidget,
   DEFAULT_TIME_RANGE_LABELS,
@@ -3030,15 +3575,17 @@ export {
   buildGaugeOption2 as buildGaugeOption,
   buildLineOption2 as buildLineOption,
   buildPayload,
-  builtinWidgetCatalog,
-  builtinWidgetDefinitions,
-  builtinWidgetDescriptors,
+  builtinWidgetCatalog2 as builtinWidgetCatalog,
+  builtinWidgetDefinitions2 as builtinWidgetDefinitions,
+  builtinWidgetDefinitions as builtinWidgetDefinitionsWithoutDocs,
+  builtinWidgetDescriptors2 as builtinWidgetDescriptors,
   clampNumberOption,
   commandStatusColor,
   commandStatusLabel,
-  createBuiltinWidgetRegistry,
-  css6 as css,
+  createBuiltinWidgetRegistry2 as createBuiltinWidgetRegistry,
+  css7 as css,
   defaultValues,
+  describeBoundDevicesProblems,
   describePosition,
   enumOptionValues,
   fitValueFont2 as fitValueFont,
@@ -3066,6 +3613,7 @@ export {
   stripUnknownOptions,
   useAlarmStream2 as useAlarmStream,
   useBoardTimeRange,
+  useBoundDevices,
   useCandidates,
   useChartTheme3 as useChartTheme,
   useCommandStream2 as useCommandStream,
@@ -3080,7 +3628,7 @@ export {
   useSlotCandidates,
   useTenantBasemap,
   useWidgetCandidates2 as useWidgetCandidates,
-  useWidgetSelect2 as useWidgetSelect,
+  useWidgetSelect3 as useWidgetSelect,
   useWidgetThemeRoot,
   useWidgetTimeZone3 as useWidgetTimeZone,
   validateDefinitionOptions,