@devicechain/widgets 0.23.0-rc.1 → 0.24.0-rc.1

package/dist/builtin-descriptors.d.ts

@@ -1,15 +1,26 @@
 import { type WidgetDescriptor } from '@devicechain/dashboards';
+type Documented<S> = S extends {
+    item: infer I;
+} ? Omit<S, 'item'> & {
+    readonly doc: string;
+    readonly item: {
+        readonly [K in keyof I]: Documented<I[K]>;
+    };
+} : S & {
+    readonly doc: string;
+};
+export type DocumentedSpecs<S> = {
+    readonly [K in keyof S]: Documented<S[K]>;
+};
 export declare const builtinWidgetDescriptors: {
-    readonly 'timeseries-chart': WidgetDescriptor<"measurement", {
+    readonly 'timeseries-chart': WidgetDescriptor<"measurement", DocumentedSpecs<{
         readonly title: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelTitle';
-            readonly doc: 'Heading shown in the widget frame. Blank hides the frame heading.';
         };
         readonly unit: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelUnit';
-            readonly doc: 'Unit suffix shown beside the value.';
         };
         readonly precision: {
             readonly kind: 'number';
@@ -18,20 +29,17 @@ export declare const builtinWidgetDescriptors: {
             readonly max: 100;
             readonly labelId: 'widgetLabelPrecision';
             readonly helpId: 'widgetHintPrecision';
-            readonly doc: 'Decimal places to round displayed values to. Unset rounds to at most 3 decimals (4 significant digits under 1).';
         };
         readonly thresholds: {
             readonly kind: 'list';
             readonly maxItems: 12;
             readonly labelId: 'widgetLabelThresholds';
             readonly helpId: 'widgetHintThresholds';
-            readonly 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.';
             readonly item: {
                 readonly value: {
                     readonly kind: 'number';
                     readonly required: true;
                     readonly labelId: 'widgetLabelThresholdValue';
-                    readonly doc: 'The value at which this band starts.';
                 };
                 readonly level: {
                     readonly kind: 'enum';
@@ -46,12 +54,10 @@ export declare const builtinWidgetDescriptors: {
                         readonly critical: 'widgetSeverityCritical';
                     };
                     readonly placeholderId: 'widgetPlaceholderThresholdLevel';
-                    readonly doc: 'The severity of this band. The theme decides the colour; normal has none.';
                 };
                 readonly label: {
                     readonly kind: 'string';
                     readonly labelId: 'widgetLabelThresholdLabel';
-                    readonly doc: 'Text shown on the chart line for this threshold. Defaults to its value.';
                 };
             };
         };
@@ -61,7 +67,6 @@ export declare const builtinWidgetDescriptors: {
             readonly min: 1;
             readonly labelId: 'widgetLabelStaleAfter';
             readonly helpId: 'widgetHintStaleAfter';
-            readonly 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.';
         };
         readonly windowSeconds: {
             readonly kind: 'number';
@@ -70,25 +75,75 @@ export declare const builtinWidgetDescriptors: {
             readonly max: 604800;
             readonly labelId: 'widgetLabelWindowSeconds';
             readonly helpId: 'widgetHintWindowSeconds';
-            readonly doc: 'Seconds of history the widget covers, back from now. Leave unset to follow the board’s time range; set it to pin this widget to a fixed span that the viewer’s range picker does not change. 60 to 604800.';
         };
-    }>;
-    readonly 'latest-card': WidgetDescriptor<"measurement", {
+        readonly groupBy: {
+            readonly kind: "enum";
+            readonly values: readonly ["measurement", "device"];
+            readonly labelId: "widgetLabelSeriesBy";
+            readonly helpId: "widgetHintSeriesBy";
+            readonly valueLabelIds: {
+                readonly measurement: "widgetGroupByMeasurement";
+                readonly device: "widgetGroupByDevice";
+            };
+            readonly placeholderId: "widgetPlaceholderDefault";
+        };
+        readonly measurement: {
+            readonly kind: 'string';
+            readonly labelId: 'widgetLabelMeasurement';
+            readonly helpId: 'widgetHintMeasurement';
+        };
+        readonly maxSeries: {
+            readonly kind: 'number';
+            readonly integer: true;
+            readonly min: 1;
+            readonly labelId: 'widgetLabelMaxSeries';
+            readonly helpId: 'widgetHintMaxSeries';
+        };
+        readonly markAlarms: {
+            readonly kind: 'boolean';
+            readonly labelId: 'widgetLabelMarkAlarms';
+            readonly helpId: 'widgetHintMarkAlarms';
+        };
+        readonly markAlarmsScope: {
+            readonly kind: 'enum';
+            readonly values: readonly ["series", "device"];
+            readonly labelId: 'widgetLabelMarkAlarmsScope';
+            readonly helpId: 'widgetHintMarkAlarmsScope';
+            readonly valueLabelIds: {
+                readonly series: 'widgetMarkAlarmsScopeSeries';
+                readonly device: 'widgetMarkAlarmsScopeDevice';
+            };
+            readonly placeholderId: 'widgetPlaceholderWholeDevice';
+        };
+        readonly markCommands: {
+            readonly kind: 'boolean';
+            readonly labelId: 'widgetLabelMarkCommands';
+            readonly helpId: 'widgetHintMarkCommands';
+        };
+        readonly min: {
+            readonly kind: 'number';
+            readonly labelId: 'widgetLabelMin';
+            readonly helpId: 'widgetHintChartAxisMin';
+        };
+        readonly max: {
+            readonly kind: 'number';
+            readonly labelId: 'widgetLabelMax';
+            readonly helpId: 'widgetHintChartAxisMax';
+        };
+    }>>;
+    readonly 'latest-card': WidgetDescriptor<"measurement", DocumentedSpecs<{
         readonly title: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelTitle';
-            readonly doc: 'Heading shown in the widget frame. Defaults to the displayed measurement name.';
         };
         readonly measurement: {
             readonly kind: "string";
             readonly labelId: "widgetLabelMeasurement";
             readonly helpId: "widgetHintMeasurement";
-            readonly doc: "Which measurement to display. Defaults to the first the datasource selects.";
         };
         readonly unit: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelUnit';
-            readonly doc: 'Unit suffix shown beside the value.';
         };
         readonly precision: {
             readonly kind: 'number';
@@ -97,20 +152,17 @@ export declare const builtinWidgetDescriptors: {
             readonly max: 100;
             readonly labelId: 'widgetLabelPrecision';
             readonly helpId: 'widgetHintPrecision';
-            readonly doc: 'Decimal places to round displayed values to. Unset rounds to at most 3 decimals (4 significant digits under 1).';
         };
         readonly thresholds: {
             readonly kind: 'list';
             readonly maxItems: 12;
             readonly labelId: 'widgetLabelThresholds';
             readonly helpId: 'widgetHintThresholds';
-            readonly 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.';
             readonly item: {
                 readonly value: {
                     readonly kind: 'number';
                     readonly required: true;
                     readonly labelId: 'widgetLabelThresholdValue';
-                    readonly doc: 'The value at which this band starts.';
                 };
                 readonly level: {
                     readonly kind: 'enum';
@@ -125,12 +177,10 @@ export declare const builtinWidgetDescriptors: {
                         readonly critical: 'widgetSeverityCritical';
                     };
                     readonly placeholderId: 'widgetPlaceholderThresholdLevel';
-                    readonly doc: 'The severity of this band. The theme decides the colour; normal has none.';
                 };
                 readonly label: {
                     readonly kind: 'string';
                     readonly labelId: 'widgetLabelThresholdLabel';
-                    readonly doc: 'Text shown on the chart line for this threshold. Defaults to its value.';
                 };
             };
         };
@@ -138,7 +188,6 @@ export declare const builtinWidgetDescriptors: {
             readonly kind: 'boolean';
             readonly labelId: 'widgetFlashOnChange';
             readonly helpId: 'widgetFlashOnChangeHint';
-            readonly doc: 'Briefly tint a value green on a rise and red on a fall when it changes.';
         };
         readonly staleAfterSeconds: {
             readonly kind: 'number';
@@ -146,7 +195,6 @@ export declare const builtinWidgetDescriptors: {
             readonly min: 1;
             readonly labelId: 'widgetLabelStaleAfter';
             readonly helpId: 'widgetHintStaleAfter';
-            readonly 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.';
         };
         readonly window: {
             readonly kind: 'number';
@@ -154,35 +202,29 @@ export declare const builtinWidgetDescriptors: {
             readonly min: 1;
             readonly labelId: 'widgetLabelWindow';
             readonly helpId: 'widgetHintWindow';
-            readonly doc: 'Samples retained across ALL of the widget\'s measurements before the oldest are dropped. Bounds memory; only the chart draws them. Default 300.';
         };
-    }>;
-    readonly gauge: WidgetDescriptor<"measurement", {
+    }>>;
+    readonly gauge: WidgetDescriptor<"measurement", DocumentedSpecs<{
         readonly title: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelTitle';
-            readonly doc: 'Heading shown in the widget frame. Defaults to the displayed measurement name.';
         };
         readonly measurement: {
             readonly kind: "string";
             readonly labelId: "widgetLabelMeasurement";
             readonly helpId: "widgetHintMeasurement";
-            readonly doc: "Which measurement to display. Defaults to the first the datasource selects.";
         };
         readonly min: {
             readonly kind: "number";
             readonly labelId: "widgetLabelMin";
-            readonly doc: "Low end of the gauge scale. Default 0.";
         };
         readonly max: {
             readonly kind: "number";
             readonly labelId: "widgetLabelMax";
-            readonly doc: "High end of the gauge scale. Default 100.";
         };
         readonly unit: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelUnit';
-            readonly doc: 'Unit suffix shown beside the value.';
         };
         readonly precision: {
             readonly kind: 'number';
@@ -191,20 +233,17 @@ export declare const builtinWidgetDescriptors: {
             readonly max: 100;
             readonly labelId: 'widgetLabelPrecision';
             readonly helpId: 'widgetHintPrecision';
-            readonly doc: 'Decimal places to round displayed values to. Unset rounds to at most 3 decimals (4 significant digits under 1).';
         };
         readonly thresholds: {
             readonly kind: 'list';
             readonly maxItems: 12;
             readonly labelId: 'widgetLabelThresholds';
             readonly helpId: 'widgetHintThresholds';
-            readonly 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.';
             readonly item: {
                 readonly value: {
                     readonly kind: 'number';
                     readonly required: true;
                     readonly labelId: 'widgetLabelThresholdValue';
-                    readonly doc: 'The value at which this band starts.';
                 };
                 readonly level: {
                     readonly kind: 'enum';
@@ -219,12 +258,10 @@ export declare const builtinWidgetDescriptors: {
                         readonly critical: 'widgetSeverityCritical';
                     };
                     readonly placeholderId: 'widgetPlaceholderThresholdLevel';
-                    readonly doc: 'The severity of this band. The theme decides the colour; normal has none.';
                 };
                 readonly label: {
                     readonly kind: 'string';
                     readonly labelId: 'widgetLabelThresholdLabel';
-                    readonly doc: 'Text shown on the chart line for this threshold. Defaults to its value.';
                 };
             };
         };
@@ -232,7 +269,6 @@ export declare const builtinWidgetDescriptors: {
             readonly kind: 'boolean';
             readonly labelId: 'widgetFlashOnChange';
             readonly helpId: 'widgetFlashOnChangeHint';
-            readonly doc: 'Briefly tint a value green on a rise and red on a fall when it changes.';
         };
         readonly staleAfterSeconds: {
             readonly kind: 'number';
@@ -240,7 +276,6 @@ export declare const builtinWidgetDescriptors: {
             readonly min: 1;
             readonly labelId: 'widgetLabelStaleAfter';
             readonly helpId: 'widgetHintStaleAfter';
-            readonly 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.';
         };
         readonly window: {
             readonly kind: 'number';
@@ -248,14 +283,12 @@ export declare const builtinWidgetDescriptors: {
             readonly min: 1;
             readonly labelId: 'widgetLabelWindow';
             readonly helpId: 'widgetHintWindow';
-            readonly doc: 'Samples retained across ALL of the widget\'s measurements before the oldest are dropped. Bounds memory; only the chart draws them. Default 300.';
         };
-    }>;
-    readonly table: WidgetDescriptor<"measurement", {
+    }>>;
+    readonly table: WidgetDescriptor<"measurement", DocumentedSpecs<{
         readonly title: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelTitle';
-            readonly doc: 'Heading shown in the widget frame. Blank hides the frame heading.';
         };
         readonly precision: {
             readonly kind: 'number';
@@ -264,13 +297,11 @@ export declare const builtinWidgetDescriptors: {
             readonly max: 100;
             readonly labelId: 'widgetLabelPrecision';
             readonly helpId: 'widgetHintPrecision';
-            readonly doc: 'Decimal places to round displayed values to. Unset rounds to at most 3 decimals (4 significant digits under 1).';
         };
         readonly flashOnChange: {
             readonly kind: 'boolean';
             readonly labelId: 'widgetFlashOnChange';
             readonly helpId: 'widgetFlashOnChangeHint';
-            readonly doc: 'Briefly tint a value green on a rise and red on a fall when it changes.';
         };
         readonly staleAfterSeconds: {
             readonly kind: 'number';
@@ -278,7 +309,6 @@ export declare const builtinWidgetDescriptors: {
             readonly min: 1;
             readonly labelId: 'widgetLabelStaleAfter';
             readonly helpId: 'widgetHintStaleAfter';
-            readonly 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.';
         };
         readonly window: {
             readonly kind: 'number';
@@ -286,20 +316,17 @@ export declare const builtinWidgetDescriptors: {
             readonly min: 1;
             readonly labelId: 'widgetLabelWindow';
             readonly helpId: 'widgetHintWindow';
-            readonly doc: 'Samples retained across ALL of the widget\'s measurements before the oldest are dropped. Bounds memory; only the chart draws them. Default 300.';
         };
-    }>;
-    readonly label: WidgetDescriptor<"none", {
+    }>>;
+    readonly label: WidgetDescriptor<"none", DocumentedSpecs<{
         readonly title: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelTitle';
-            readonly doc: 'Heading shown in the widget frame. Blank hides the frame heading.';
         };
         readonly text: {
             readonly kind: "string";
             readonly required: true;
             readonly labelId: "widgetLabelText";
-            readonly doc: "The text to show. Rendered as plain text — markup is never interpreted.";
         };
         readonly align: {
             readonly kind: "enum";
@@ -311,32 +338,27 @@ export declare const builtinWidgetDescriptors: {
                 readonly right: "widgetAlignRight";
             };
             readonly placeholderId: "widgetPlaceholderDefault";
-            readonly doc: "Horizontal alignment of the text. Default center.";
         };
         readonly fontSize: {
             readonly kind: "number";
             readonly min: 1;
             readonly labelId: "widgetLabelFontSize";
             readonly helpId: "widgetHintFontSize";
-            readonly doc: "Text size in pixels at the comfortable density; it scales with the board density. Default 16.";
         };
-    }>;
-    readonly image: WidgetDescriptor<"none", {
+    }>>;
+    readonly image: WidgetDescriptor<"none", DocumentedSpecs<{
         readonly title: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelTitle';
-            readonly doc: 'Heading shown in the widget frame. Blank hides the frame heading.';
         };
         readonly url: {
             readonly kind: "string";
             readonly required: true;
             readonly labelId: "widgetLabelImageUrl";
-            readonly doc: "Source URL of the image.";
         };
         readonly alt: {
             readonly kind: "string";
             readonly labelId: "widgetLabelAltText";
-            readonly doc: "Alternative text describing the image for assistive technology.";
         };
         readonly fit: {
             readonly kind: "enum";
@@ -348,14 +370,12 @@ export declare const builtinWidgetDescriptors: {
                 readonly fill: "widgetFitFill";
             };
             readonly placeholderId: "widgetPlaceholderDefault";
-            readonly doc: "How the image fills its box. Default contain.";
         };
-    }>;
-    readonly 'alarm-table': WidgetDescriptor<"alarm", {
+    }>>;
+    readonly 'alarm-table': WidgetDescriptor<"alarm", DocumentedSpecs<{
         readonly title: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelTitle';
-            readonly doc: 'Heading shown in the widget frame. Blank hides the frame heading.';
         };
         readonly state: {
             readonly kind: 'enum';
@@ -367,7 +387,6 @@ export declare const builtinWidgetDescriptors: {
                 readonly CLEARED: 'widgetAlarmStateCleared';
             };
             readonly placeholderId: 'widgetPlaceholderAny';
-            readonly doc: 'Show only alarms in this state. Unset shows every state.';
         };
         readonly severity: {
             readonly kind: 'enum';
@@ -382,7 +401,6 @@ export declare const builtinWidgetDescriptors: {
                 readonly INDETERMINATE: 'widgetAlarmSeverityIndeterminate';
             };
             readonly placeholderId: 'widgetPlaceholderAny';
-            readonly doc: 'Show only alarms at this severity. Unset shows every severity.';
         };
         readonly acknowledged: {
             readonly kind: 'enum';
@@ -394,7 +412,31 @@ export declare const builtinWidgetDescriptors: {
                 readonly false: 'widgetAlarmAckUnacknowledged';
             };
             readonly placeholderId: 'widgetPlaceholderAny';
-            readonly doc: "Show only acknowledged ('true') or unacknowledged ('false') alarms. Unset shows both.";
+        };
+        readonly groupBy: {
+            readonly kind: "enum";
+            readonly values: readonly ["none", "deviceType"];
+            readonly labelId: "widgetLabelAlarmGroupBy";
+            readonly helpId: "widgetHintAlarmGroupBy";
+            readonly valueLabelIds: {
+                readonly none: "widgetAlarmGroupByNone";
+                readonly deviceType: "widgetAlarmGroupByDeviceType";
+            };
+            readonly placeholderId: "widgetPlaceholderDefault";
+        };
+        readonly deviceTypes: {
+            readonly kind: "list";
+            readonly maxItems: 24;
+            readonly ordered: true;
+            readonly labelId: "widgetLabelAlarmDeviceTypes";
+            readonly helpId: "widgetHintAlarmDeviceTypes";
+            readonly item: {
+                readonly token: {
+                    readonly kind: "string";
+                    readonly control: "device-type";
+                    readonly labelId: "widgetLabelAlarmDeviceTypeToken";
+                };
+            };
         };
         readonly maxRows: {
             readonly kind: "number";
@@ -402,7 +444,6 @@ export declare const builtinWidgetDescriptors: {
             readonly min: 1;
             readonly labelId: "widgetLabelMaxRows";
             readonly helpId: "widgetMaxRowsAlarmHint";
-            readonly doc: "Alarms loaded into the table. Default 50.";
         };
         readonly precision: {
             readonly kind: 'number';
@@ -411,27 +452,23 @@ export declare const builtinWidgetDescriptors: {
             readonly max: 100;
             readonly labelId: 'widgetLabelPrecision';
             readonly helpId: 'widgetHintPrecision';
-            readonly doc: 'Decimal places to round displayed values to. Unset rounds to at most 3 decimals (4 significant digits under 1).';
         };
         readonly flashOnChange: {
             readonly kind: 'boolean';
             readonly labelId: 'widgetFlashOnChange';
             readonly helpId: 'widgetFlashOnChangeHint';
-            readonly doc: 'Briefly tint a value green on a rise and red on a fall when it changes.';
         };
         readonly selectionTarget: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelTargetSlot';
             readonly helpId: 'widgetTargetSlotHint';
             readonly control: 'slot-target';
-            readonly doc: 'Name of the slot this widget re-points when the viewer picks an entity.';
         };
-    }>;
-    readonly 'alarm-count': WidgetDescriptor<"alarm", {
+    }>>;
+    readonly 'alarm-count': WidgetDescriptor<"alarm", DocumentedSpecs<{
         readonly title: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelTitle';
-            readonly doc: 'Heading shown in the widget frame. Blank hides the frame heading.';
         };
         readonly state: {
             readonly kind: 'enum';
@@ -443,7 +480,6 @@ export declare const builtinWidgetDescriptors: {
                 readonly CLEARED: 'widgetAlarmStateCleared';
             };
             readonly placeholderId: 'widgetPlaceholderAny';
-            readonly doc: 'Show only alarms in this state. Unset shows every state.';
         };
         readonly severity: {
             readonly kind: 'enum';
@@ -458,7 +494,6 @@ export declare const builtinWidgetDescriptors: {
                 readonly INDETERMINATE: 'widgetAlarmSeverityIndeterminate';
             };
             readonly placeholderId: 'widgetPlaceholderAny';
-            readonly doc: 'Show only alarms at this severity. Unset shows every severity.';
         };
         readonly acknowledged: {
             readonly kind: 'enum';
@@ -470,14 +505,46 @@ export declare const builtinWidgetDescriptors: {
                 readonly false: 'widgetAlarmAckUnacknowledged';
             };
             readonly placeholderId: 'widgetPlaceholderAny';
-            readonly doc: "Show only acknowledged ('true') or unacknowledged ('false') alarms. Unset shows both.";
         };
-    }>;
-    readonly 'command-button': WidgetDescriptor<"control", {
+    }>>;
+    readonly 'alarm-severity': WidgetDescriptor<"alarm", DocumentedSpecs<{
+        readonly title: {
+            readonly kind: 'string';
+            readonly labelId: 'widgetLabelTitle';
+        };
+        readonly state: {
+            readonly kind: 'enum';
+            readonly values: readonly ["ACTIVE", "CLEARED"];
+            readonly labelId: 'widgetLabelState';
+            readonly helpId: 'widgetStateHint';
+            readonly valueLabelIds: {
+                readonly ACTIVE: 'widgetAlarmStateActive';
+                readonly CLEARED: 'widgetAlarmStateCleared';
+            };
+            readonly placeholderId: 'widgetPlaceholderAny';
+        };
+        readonly acknowledged: {
+            readonly kind: 'enum';
+            readonly values: readonly ["true", "false"];
+            readonly labelId: 'widgetLabelAcknowledged';
+            readonly helpId: 'widgetAcknowledgedHint';
+            readonly valueLabelIds: {
+                readonly true: 'widgetAlarmAckAcknowledged';
+                readonly false: 'widgetAlarmAckUnacknowledged';
+            };
+            readonly placeholderId: 'widgetPlaceholderAny';
+        };
+        readonly deviceType: {
+            readonly kind: "string";
+            readonly control: "device-type";
+            readonly labelId: "widgetLabelAlarmSeverityType";
+            readonly helpId: "widgetHintAlarmSeverityType";
+        };
+    }>>;
+    readonly 'command-button': WidgetDescriptor<"control", DocumentedSpecs<{
         readonly title: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelTitle';
-            readonly doc: 'Heading shown in the widget frame. Blank hides the frame heading.';
         };
         readonly commandName: {
             readonly kind: "string";
@@ -485,14 +552,12 @@ export declare const builtinWidgetDescriptors: {
             readonly labelId: "widgetCommandHeading";
             readonly helpId: "widgetCommandFieldHint";
             readonly control: "command-vocabulary";
-            readonly doc: "Command key issued to the target device. Without it the widget cannot send.";
         };
         readonly commandLabel: {
             readonly kind: "string";
             readonly labelId: "widgetCommandHeading";
             readonly helpId: "widgetCommandFieldHint";
             readonly control: "command-vocabulary";
-            readonly doc: "Text on the send button. Defaults to the command key.";
         };
         readonly parameterSchema: {
             readonly kind: "string";
@@ -500,7 +565,6 @@ export declare const builtinWidgetDescriptors: {
             readonly labelId: "widgetCommandHeading";
             readonly helpId: "widgetCommandFieldHint";
             readonly control: "command-vocabulary";
-            readonly doc: "The command's parameter descriptors, baked in as JSON at author time. Drives the typed form.";
         };
         readonly maxRows: {
             readonly kind: "number";
@@ -508,70 +572,66 @@ export declare const builtinWidgetDescriptors: {
             readonly min: 1;
             readonly labelId: "widgetLabelMaxRows";
             readonly helpId: "widgetMaxRowsCommandHint";
-            readonly doc: "Recent commands shown in the history. Default 20.";
         };
-    }>;
-    readonly 'entity-selector': WidgetDescriptor<"selection", {
+    }>>;
+    readonly 'entity-selector': WidgetDescriptor<"selection", DocumentedSpecs<{
         readonly title: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelTitle';
-            readonly doc: 'Heading shown in the widget frame. Blank hides the frame heading.';
         };
         readonly selectionTarget: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelTargetSlot';
             readonly helpId: 'widgetTargetSlotHint';
             readonly control: 'slot-target';
-            readonly doc: 'Name of the slot this widget re-points when the viewer picks an entity.';
             readonly required: true;
         };
-    }>;
-    readonly map: WidgetDescriptor<"location", {
+    }>>;
+    readonly map: WidgetDescriptor<"location", DocumentedSpecs<{
         readonly title: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelTitle';
-            readonly doc: 'Heading shown in the widget frame. Blank hides the frame heading.';
         };
         readonly tileUrl: {
             readonly kind: "string";
             readonly labelId: "widgetLabelTileUrl";
             readonly helpId: "widgetTileUrlHint";
             readonly control: "basemap";
-            readonly 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.";
         };
         readonly attribution: {
             readonly kind: "string";
             readonly labelId: "widgetLabelAttribution";
             readonly helpId: "widgetAttributionHint";
             readonly control: "basemap";
-            readonly doc: "Credit line the tile source requires, shown on the map. Set whatever the provider you chose asks for.";
         };
-    }>;
-    readonly 'linear-gauge': WidgetDescriptor<"measurement", {
+        readonly selectionTarget: {
+            readonly kind: 'string';
+            readonly labelId: 'widgetLabelTargetSlot';
+            readonly helpId: 'widgetTargetSlotHint';
+            readonly control: 'slot-target';
+        };
+    }>>;
+    readonly 'linear-gauge': WidgetDescriptor<"measurement", DocumentedSpecs<{
         readonly title: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelTitle';
-            readonly doc: 'Heading shown in the widget frame. Defaults to the displayed measurement name.';
         };
         readonly measurement: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelMeasurement';
             readonly helpId: 'widgetHintMeasurement';
-            readonly doc: 'Which measurement to display. Defaults to the first the datasource selects.';
         };
         readonly min: {
             readonly kind: 'number';
             readonly required: true;
             readonly labelId: 'widgetLabelMin';
             readonly helpId: 'widgetHintScaleMin';
-            readonly doc: 'Value at the empty end of the scale. Required: the widget does not guess a range.';
         };
         readonly max: {
             readonly kind: 'number';
             readonly required: true;
             readonly labelId: 'widgetLabelMax';
             readonly helpId: 'widgetHintScaleMax';
-            readonly doc: 'Value at the full end of the scale. Required, and above min.';
         };
         readonly style: {
             readonly kind: "enum";
@@ -582,7 +642,6 @@ export declare const builtinWidgetDescriptors: {
                 readonly thermometer: "widgetLinearStyleThermometer";
             };
             readonly placeholderId: "widgetPlaceholderDefault";
-            readonly doc: "A plain bar (default) or a thermometer: a vertical tube with a bulb. A thermometer is always vertical.";
         };
         readonly orientation: {
             readonly kind: "enum";
@@ -593,12 +652,10 @@ export declare const builtinWidgetDescriptors: {
                 readonly vertical: "widgetOrientationVertical";
             };
             readonly placeholderId: "widgetPlaceholderDefault";
-            readonly doc: "Direction of a bar: horizontal (default) or vertical. Ignored by a thermometer.";
         };
         readonly unit: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelUnit';
-            readonly doc: 'Unit suffix shown beside the value.';
         };
         readonly precision: {
             readonly kind: 'number';
@@ -607,20 +664,17 @@ export declare const builtinWidgetDescriptors: {
             readonly max: 100;
             readonly labelId: 'widgetLabelPrecision';
             readonly helpId: 'widgetHintPrecision';
-            readonly doc: 'Decimal places to round displayed values to. Unset rounds to at most 3 decimals (4 significant digits under 1).';
         };
         readonly thresholds: {
             readonly kind: 'list';
             readonly maxItems: 12;
             readonly labelId: 'widgetLabelThresholds';
             readonly helpId: 'widgetHintThresholds';
-            readonly 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.';
             readonly item: {
                 readonly value: {
                     readonly kind: 'number';
                     readonly required: true;
                     readonly labelId: 'widgetLabelThresholdValue';
-                    readonly doc: 'The value at which this band starts.';
                 };
                 readonly level: {
                     readonly kind: 'enum';
@@ -635,12 +689,10 @@ export declare const builtinWidgetDescriptors: {
                         readonly critical: 'widgetSeverityCritical';
                     };
                     readonly placeholderId: 'widgetPlaceholderThresholdLevel';
-                    readonly doc: 'The severity of this band. The theme decides the colour; normal has none.';
                 };
                 readonly label: {
                     readonly kind: 'string';
                     readonly labelId: 'widgetLabelThresholdLabel';
-                    readonly doc: 'Text shown on the chart line for this threshold. Defaults to its value.';
                 };
             };
         };
@@ -650,7 +702,6 @@ export declare const builtinWidgetDescriptors: {
             readonly min: 1;
             readonly labelId: 'widgetLabelStaleAfter';
             readonly helpId: 'widgetHintStaleAfter';
-            readonly 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.';
         };
         readonly window: {
             readonly kind: 'number';
@@ -658,34 +709,29 @@ export declare const builtinWidgetDescriptors: {
             readonly min: 1;
             readonly labelId: 'widgetLabelWindow';
             readonly helpId: 'widgetHintWindow';
-            readonly doc: 'Samples retained across ALL of the widget\'s measurements before the oldest are dropped. Bounds memory; only the chart draws them. Default 300.';
         };
-    }>;
-    readonly 'level-gauge': WidgetDescriptor<"measurement", {
+    }>>;
+    readonly 'level-gauge': WidgetDescriptor<"measurement", DocumentedSpecs<{
         readonly title: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelTitle';
-            readonly doc: 'Heading shown in the widget frame. Defaults to the displayed measurement name.';
         };
         readonly measurement: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelMeasurement';
             readonly helpId: 'widgetHintMeasurement';
-            readonly doc: 'Which measurement to display. Defaults to the first the datasource selects.';
         };
         readonly min: {
             readonly kind: 'number';
             readonly required: true;
             readonly labelId: 'widgetLabelMin';
             readonly helpId: 'widgetHintScaleMin';
-            readonly doc: 'Value at the empty end of the scale. Required: the widget does not guess a range.';
         };
         readonly max: {
             readonly kind: 'number';
             readonly required: true;
             readonly labelId: 'widgetLabelMax';
             readonly helpId: 'widgetHintScaleMax';
-            readonly doc: 'Value at the full end of the scale. Required, and above min.';
         };
         readonly readout: {
             readonly kind: "enum";
@@ -696,12 +742,10 @@ export declare const builtinWidgetDescriptors: {
                 readonly percent: "widgetReadoutPercent";
             };
             readonly placeholderId: "widgetPlaceholderDefault";
-            readonly doc: "What the readout shows: the value with its unit (default) or the percent of the scale.";
         };
         readonly unit: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelUnit';
-            readonly doc: 'Unit suffix shown beside the value.';
         };
         readonly precision: {
             readonly kind: 'number';
@@ -710,20 +754,17 @@ export declare const builtinWidgetDescriptors: {
             readonly max: 100;
             readonly labelId: 'widgetLabelPrecision';
             readonly helpId: 'widgetHintPrecision';
-            readonly doc: 'Decimal places to round displayed values to. Unset rounds to at most 3 decimals (4 significant digits under 1).';
         };
         readonly thresholds: {
             readonly kind: 'list';
             readonly maxItems: 12;
             readonly labelId: 'widgetLabelThresholds';
             readonly helpId: 'widgetHintThresholds';
-            readonly 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.';
             readonly item: {
                 readonly value: {
                     readonly kind: 'number';
                     readonly required: true;
                     readonly labelId: 'widgetLabelThresholdValue';
-                    readonly doc: 'The value at which this band starts.';
                 };
                 readonly level: {
                     readonly kind: 'enum';
@@ -738,12 +779,10 @@ export declare const builtinWidgetDescriptors: {
                         readonly critical: 'widgetSeverityCritical';
                     };
                     readonly placeholderId: 'widgetPlaceholderThresholdLevel';
-                    readonly doc: 'The severity of this band. The theme decides the colour; normal has none.';
                 };
                 readonly label: {
                     readonly kind: 'string';
                     readonly labelId: 'widgetLabelThresholdLabel';
-                    readonly doc: 'Text shown on the chart line for this threshold. Defaults to its value.';
                 };
             };
         };
@@ -753,7 +792,6 @@ export declare const builtinWidgetDescriptors: {
             readonly min: 1;
             readonly labelId: 'widgetLabelStaleAfter';
             readonly helpId: 'widgetHintStaleAfter';
-            readonly 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.';
         };
         readonly window: {
             readonly kind: 'number';
@@ -761,37 +799,31 @@ export declare const builtinWidgetDescriptors: {
             readonly min: 1;
             readonly labelId: 'widgetLabelWindow';
             readonly helpId: 'widgetHintWindow';
-            readonly doc: 'Samples retained across ALL of the widget\'s measurements before the oldest are dropped. Bounds memory; only the chart draws them. Default 300.';
         };
-    }>;
-    readonly battery: WidgetDescriptor<"measurement", {
+    }>>;
+    readonly battery: WidgetDescriptor<"measurement", DocumentedSpecs<{
         readonly title: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelTitle';
-            readonly doc: 'Heading shown in the widget frame. Defaults to the displayed measurement name.';
         };
         readonly measurement: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelMeasurement';
             readonly helpId: 'widgetHintMeasurement';
-            readonly doc: 'Which measurement to display. Defaults to the first the datasource selects.';
         };
         readonly min: {
             readonly kind: "number";
             readonly labelId: "widgetLabelMin";
             readonly helpId: "widgetHintBatteryRange";
-            readonly doc: "Value of an empty battery. Default 0 (the scale is percent unless you set min and max).";
         };
         readonly max: {
             readonly kind: "number";
             readonly labelId: "widgetLabelMax";
             readonly helpId: "widgetHintBatteryRange";
-            readonly doc: "Value of a full battery. Default 100 (the scale is percent unless you set min and max).";
         };
         readonly unit: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelUnit';
-            readonly doc: 'Unit suffix shown beside the value.';
         };
         readonly precision: {
             readonly kind: 'number';
@@ -800,20 +832,17 @@ export declare const builtinWidgetDescriptors: {
             readonly max: 100;
             readonly labelId: 'widgetLabelPrecision';
             readonly helpId: 'widgetHintPrecision';
-            readonly doc: 'Decimal places to round displayed values to. Unset rounds to at most 3 decimals (4 significant digits under 1).';
         };
         readonly thresholds: {
             readonly kind: 'list';
             readonly maxItems: 12;
             readonly labelId: 'widgetLabelThresholds';
             readonly helpId: 'widgetHintThresholds';
-            readonly 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.';
             readonly item: {
                 readonly value: {
                     readonly kind: 'number';
                     readonly required: true;
                     readonly labelId: 'widgetLabelThresholdValue';
-                    readonly doc: 'The value at which this band starts.';
                 };
                 readonly level: {
                     readonly kind: 'enum';
@@ -828,12 +857,10 @@ export declare const builtinWidgetDescriptors: {
                         readonly critical: 'widgetSeverityCritical';
                     };
                     readonly placeholderId: 'widgetPlaceholderThresholdLevel';
-                    readonly doc: 'The severity of this band. The theme decides the colour; normal has none.';
                 };
                 readonly label: {
                     readonly kind: 'string';
                     readonly labelId: 'widgetLabelThresholdLabel';
-                    readonly doc: 'Text shown on the chart line for this threshold. Defaults to its value.';
                 };
             };
         };
@@ -843,7 +870,6 @@ export declare const builtinWidgetDescriptors: {
             readonly min: 1;
             readonly labelId: 'widgetLabelStaleAfter';
             readonly helpId: 'widgetHintStaleAfter';
-            readonly 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.';
         };
         readonly window: {
             readonly kind: 'number';
@@ -851,31 +877,26 @@ export declare const builtinWidgetDescriptors: {
             readonly min: 1;
             readonly labelId: 'widgetLabelWindow';
             readonly helpId: 'widgetHintWindow';
-            readonly doc: 'Samples retained across ALL of the widget\'s measurements before the oldest are dropped. Bounds memory; only the chart draws them. Default 300.';
         };
-    }>;
-    readonly 'status-light': WidgetDescriptor<"measurement", {
+    }>>;
+    readonly 'status-light': WidgetDescriptor<"measurement", DocumentedSpecs<{
         readonly title: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelTitle';
-            readonly doc: 'Heading shown in the widget frame. Defaults to the displayed measurement name.';
         };
         readonly measurement: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelMeasurement';
             readonly helpId: 'widgetHintMeasurement';
-            readonly doc: 'Which measurement to display. Defaults to the first the datasource selects.';
         };
         readonly onAt: {
             readonly kind: "number";
             readonly labelId: "widgetLabelOnAt";
             readonly helpId: "widgetHintOnAt";
-            readonly 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.";
         };
         readonly unit: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelUnit';
-            readonly doc: 'Unit suffix shown beside the value.';
         };
         readonly precision: {
             readonly kind: 'number';
@@ -884,20 +905,17 @@ export declare const builtinWidgetDescriptors: {
             readonly max: 100;
             readonly labelId: 'widgetLabelPrecision';
             readonly helpId: 'widgetHintPrecision';
-            readonly doc: 'Decimal places to round displayed values to. Unset rounds to at most 3 decimals (4 significant digits under 1).';
         };
         readonly thresholds: {
             readonly kind: 'list';
             readonly maxItems: 12;
             readonly labelId: 'widgetLabelThresholds';
             readonly helpId: 'widgetHintThresholds';
-            readonly 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.';
             readonly item: {
                 readonly value: {
                     readonly kind: 'number';
                     readonly required: true;
                     readonly labelId: 'widgetLabelThresholdValue';
-                    readonly doc: 'The value at which this band starts.';
                 };
                 readonly level: {
                     readonly kind: 'enum';
@@ -912,12 +930,10 @@ export declare const builtinWidgetDescriptors: {
                         readonly critical: 'widgetSeverityCritical';
                     };
                     readonly placeholderId: 'widgetPlaceholderThresholdLevel';
-                    readonly doc: 'The severity of this band. The theme decides the colour; normal has none.';
                 };
                 readonly label: {
                     readonly kind: 'string';
                     readonly labelId: 'widgetLabelThresholdLabel';
-                    readonly doc: 'Text shown on the chart line for this threshold. Defaults to its value.';
                 };
             };
         };
@@ -927,7 +943,6 @@ export declare const builtinWidgetDescriptors: {
             readonly min: 1;
             readonly labelId: 'widgetLabelStaleAfter';
             readonly helpId: 'widgetHintStaleAfter';
-            readonly 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.';
         };
         readonly window: {
             readonly kind: 'number';
@@ -935,25 +950,21 @@ export declare const builtinWidgetDescriptors: {
             readonly min: 1;
             readonly labelId: 'widgetLabelWindow';
             readonly helpId: 'widgetHintWindow';
-            readonly doc: 'Samples retained across ALL of the widget\'s measurements before the oldest are dropped. Bounds memory; only the chart draws them. Default 300.';
         };
-    }>;
-    readonly 'signal-bars': WidgetDescriptor<"measurement", {
+    }>>;
+    readonly 'signal-bars': WidgetDescriptor<"measurement", DocumentedSpecs<{
         readonly title: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelTitle';
-            readonly doc: 'Heading shown in the widget frame. Defaults to the displayed measurement name.';
         };
         readonly measurement: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelMeasurement';
             readonly helpId: 'widgetHintMeasurement';
-            readonly doc: 'Which measurement to display. Defaults to the first the datasource selects.';
         };
         readonly unit: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelUnit';
-            readonly doc: 'Unit suffix shown beside the value.';
         };
         readonly precision: {
             readonly kind: 'number';
@@ -962,7 +973,6 @@ export declare const builtinWidgetDescriptors: {
             readonly max: 100;
             readonly labelId: 'widgetLabelPrecision';
             readonly helpId: 'widgetHintPrecision';
-            readonly doc: 'Decimal places to round displayed values to. Unset rounds to at most 3 decimals (4 significant digits under 1).';
         };
         readonly thresholds: {
             readonly kind: 'list';
@@ -972,7 +982,6 @@ export declare const builtinWidgetDescriptors: {
                     readonly kind: 'number';
                     readonly required: true;
                     readonly labelId: 'widgetLabelThresholdValue';
-                    readonly doc: 'The value at which this band starts.';
                 };
                 readonly level: {
                     readonly kind: 'enum';
@@ -987,18 +996,15 @@ export declare const builtinWidgetDescriptors: {
                         readonly critical: 'widgetSeverityCritical';
                     };
                     readonly placeholderId: 'widgetPlaceholderThresholdLevel';
-                    readonly doc: 'The severity of this band. The theme decides the colour; normal has none.';
                 };
                 readonly label: {
                     readonly kind: 'string';
                     readonly labelId: 'widgetLabelThresholdLabel';
-                    readonly doc: 'Text shown on the chart line for this threshold. Defaults to its value.';
                 };
             };
             readonly maxItems: 8;
             readonly required: true;
             readonly helpId: "widgetHintSignalThresholds";
-            readonly 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.";
         };
         readonly staleAfterSeconds: {
             readonly kind: 'number';
@@ -1006,7 +1012,6 @@ export declare const builtinWidgetDescriptors: {
             readonly min: 1;
             readonly labelId: 'widgetLabelStaleAfter';
             readonly helpId: 'widgetHintStaleAfter';
-            readonly 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.';
         };
         readonly window: {
             readonly kind: 'number';
@@ -1014,20 +1019,17 @@ export declare const builtinWidgetDescriptors: {
             readonly min: 1;
             readonly labelId: 'widgetLabelWindow';
             readonly helpId: 'widgetHintWindow';
-            readonly doc: 'Samples retained across ALL of the widget\'s measurements before the oldest are dropped. Bounds memory; only the chart draws them. Default 300.';
         };
-    }>;
-    readonly compass: WidgetDescriptor<"measurement", {
+    }>>;
+    readonly compass: WidgetDescriptor<"measurement", DocumentedSpecs<{
         readonly title: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelTitle';
-            readonly doc: 'Heading shown in the widget frame. Defaults to the displayed measurement name.';
         };
         readonly measurement: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelMeasurement';
             readonly helpId: 'widgetHintMeasurement';
-            readonly doc: 'Which measurement to display. Defaults to the first the datasource selects.';
         };
         readonly precision: {
             readonly kind: 'number';
@@ -1036,7 +1038,6 @@ export declare const builtinWidgetDescriptors: {
             readonly max: 100;
             readonly labelId: 'widgetLabelPrecision';
             readonly helpId: 'widgetHintPrecision';
-            readonly 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.";
         };
         readonly thresholds: {
             readonly kind: 'list';
@@ -1048,7 +1049,6 @@ export declare const builtinWidgetDescriptors: {
                     readonly kind: 'number';
                     readonly required: true;
                     readonly labelId: 'widgetLabelThresholdValue';
-                    readonly doc: 'The value at which this band starts.';
                 };
                 readonly level: {
                     readonly kind: 'enum';
@@ -1063,15 +1063,12 @@ export declare const builtinWidgetDescriptors: {
                         readonly critical: 'widgetSeverityCritical';
                     };
                     readonly placeholderId: 'widgetPlaceholderThresholdLevel';
-                    readonly doc: 'The severity of this band. The theme decides the colour; normal has none.';
                 };
                 readonly label: {
                     readonly kind: 'string';
                     readonly labelId: 'widgetLabelThresholdLabel';
-                    readonly doc: 'Text shown on the chart line for this threshold. Defaults to its value.';
                 };
             };
-            readonly 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.";
         };
         readonly staleAfterSeconds: {
             readonly kind: 'number';
@@ -1079,7 +1076,6 @@ export declare const builtinWidgetDescriptors: {
             readonly min: 1;
             readonly labelId: 'widgetLabelStaleAfter';
             readonly helpId: 'widgetHintStaleAfter';
-            readonly 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.';
         };
         readonly window: {
             readonly kind: 'number';
@@ -1087,34 +1083,29 @@ export declare const builtinWidgetDescriptors: {
             readonly min: 1;
             readonly labelId: 'widgetLabelWindow';
             readonly helpId: 'widgetHintWindow';
-            readonly doc: 'Samples retained across ALL of the widget\'s measurements before the oldest are dropped. Bounds memory; only the chart draws them. Default 300.';
         };
-    }>;
-    readonly 'progress-ring': WidgetDescriptor<"measurement", {
+    }>>;
+    readonly 'progress-ring': WidgetDescriptor<"measurement", DocumentedSpecs<{
         readonly title: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelTitle';
-            readonly doc: 'Heading shown in the widget frame. Defaults to the displayed measurement name.';
         };
         readonly measurement: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelMeasurement';
             readonly helpId: 'widgetHintMeasurement';
-            readonly doc: 'Which measurement to display. Defaults to the first the datasource selects.';
         };
         readonly min: {
             readonly kind: 'number';
             readonly required: true;
             readonly labelId: 'widgetLabelMin';
             readonly helpId: 'widgetHintScaleMin';
-            readonly doc: 'Value at the empty end of the scale. Required: the widget does not guess a range.';
         };
         readonly max: {
             readonly kind: 'number';
             readonly required: true;
             readonly labelId: 'widgetLabelMax';
             readonly helpId: 'widgetHintScaleMax';
-            readonly doc: 'Value at the full end of the scale. Required, and above min.';
         };
         readonly readout: {
             readonly kind: "enum";
@@ -1125,12 +1116,10 @@ export declare const builtinWidgetDescriptors: {
                 readonly value: "widgetReadoutValue";
             };
             readonly placeholderId: "widgetPlaceholderDefault";
-            readonly doc: "What the middle of the ring shows: the percent of the scale (default) or the value with its unit.";
         };
         readonly unit: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelUnit';
-            readonly doc: 'Unit suffix shown beside the value.';
         };
         readonly precision: {
             readonly kind: 'number';
@@ -1139,20 +1128,17 @@ export declare const builtinWidgetDescriptors: {
             readonly max: 100;
             readonly labelId: 'widgetLabelPrecision';
             readonly helpId: 'widgetHintPrecision';
-            readonly doc: 'Decimal places to round displayed values to. Unset rounds to at most 3 decimals (4 significant digits under 1).';
         };
         readonly thresholds: {
             readonly kind: 'list';
             readonly maxItems: 12;
             readonly labelId: 'widgetLabelThresholds';
             readonly helpId: 'widgetHintThresholds';
-            readonly 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.';
             readonly item: {
                 readonly value: {
                     readonly kind: 'number';
                     readonly required: true;
                     readonly labelId: 'widgetLabelThresholdValue';
-                    readonly doc: 'The value at which this band starts.';
                 };
                 readonly level: {
                     readonly kind: 'enum';
@@ -1167,12 +1153,10 @@ export declare const builtinWidgetDescriptors: {
                         readonly critical: 'widgetSeverityCritical';
                     };
                     readonly placeholderId: 'widgetPlaceholderThresholdLevel';
-                    readonly doc: 'The severity of this band. The theme decides the colour; normal has none.';
                 };
                 readonly label: {
                     readonly kind: 'string';
                     readonly labelId: 'widgetLabelThresholdLabel';
-                    readonly doc: 'Text shown on the chart line for this threshold. Defaults to its value.';
                 };
             };
         };
@@ -1182,7 +1166,6 @@ export declare const builtinWidgetDescriptors: {
             readonly min: 1;
             readonly labelId: 'widgetLabelStaleAfter';
             readonly helpId: 'widgetHintStaleAfter';
-            readonly 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.';
         };
         readonly window: {
             readonly kind: 'number';
@@ -1190,14 +1173,12 @@ export declare const builtinWidgetDescriptors: {
             readonly min: 1;
             readonly labelId: 'widgetLabelWindow';
             readonly helpId: 'widgetHintWindow';
-            readonly doc: 'Samples retained across ALL of the widget\'s measurements before the oldest are dropped. Bounds memory; only the chart draws them. Default 300.';
         };
-    }>;
-    readonly 'command-slider': WidgetDescriptor<"control", {
+    }>>;
+    readonly 'command-slider': WidgetDescriptor<"control", DocumentedSpecs<{
         readonly title: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelTitle';
-            readonly doc: 'Heading shown in the widget frame. Blank hides the frame heading.';
         };
         readonly commandName: {
             readonly kind: 'string';
@@ -1205,14 +1186,12 @@ export declare const builtinWidgetDescriptors: {
             readonly labelId: 'widgetCommandHeading';
             readonly helpId: 'widgetCommandFieldHint';
             readonly control: 'command-vocabulary';
-            readonly doc: 'Command key issued to the target device. Without it the control cannot send.';
         };
         readonly commandLabel: {
             readonly kind: 'string';
             readonly labelId: 'widgetCommandHeading';
             readonly helpId: 'widgetCommandFieldHint';
             readonly control: 'command-vocabulary';
-            readonly doc: 'Name of the control for assistive technology. Defaults to the command key.';
         };
         readonly parameterSchema: {
             readonly kind: 'string';
@@ -1220,39 +1199,43 @@ export declare const builtinWidgetDescriptors: {
             readonly labelId: 'widgetCommandHeading';
             readonly helpId: 'widgetCommandFieldHint';
             readonly control: 'command-vocabulary';
-            readonly doc: "The command's parameter descriptors, baked in as JSON at author time. Gives the control its range and its refusals.";
         };
         readonly parameter: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelParameter';
             readonly helpId: 'widgetHintControlParameter';
-            readonly doc: 'Which parameter of the command this control sets. May be left blank when the command has exactly one parameter of the right type.';
         };
         readonly min: {
             readonly kind: "number";
             readonly labelId: "widgetLabelMin";
             readonly helpId: "widgetHintSliderRange";
-            readonly doc: "Lowest value, used only when the command's parameter declares no minimum.";
         };
         readonly max: {
             readonly kind: "number";
             readonly labelId: "widgetLabelMax";
             readonly helpId: "widgetHintSliderRange";
-            readonly doc: "Highest value, used only when the command's parameter declares no maximum.";
         };
         readonly step: {
             readonly kind: "number";
             readonly min: 0;
             readonly labelId: "widgetLabelStep";
             readonly helpId: "widgetHintSliderStep";
-            readonly doc: "Distance between values. Defaults to 1 for a whole-number parameter, else a hundredth of the range.";
         };
-    }>;
-    readonly 'command-toggle': WidgetDescriptor<"control", {
+        readonly mode: {
+            readonly kind: "enum";
+            readonly values: readonly ["slider", "stepper"];
+            readonly labelId: "widgetLabelControlMode";
+            readonly valueLabelIds: {
+                readonly slider: "widgetControlModeSlider";
+                readonly stepper: "widgetControlModeStepper";
+            };
+            readonly placeholderId: "widgetPlaceholderDefault";
+        };
+    }>>;
+    readonly 'command-toggle': WidgetDescriptor<"control", DocumentedSpecs<{
         readonly title: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelTitle';
-            readonly doc: 'Heading shown in the widget frame. Blank hides the frame heading.';
         };
         readonly commandName: {
             readonly kind: 'string';
@@ -1260,14 +1243,12 @@ export declare const builtinWidgetDescriptors: {
             readonly labelId: 'widgetCommandHeading';
             readonly helpId: 'widgetCommandFieldHint';
             readonly control: 'command-vocabulary';
-            readonly doc: 'Command key issued to the target device. Without it the control cannot send.';
         };
         readonly commandLabel: {
             readonly kind: 'string';
             readonly labelId: 'widgetCommandHeading';
             readonly helpId: 'widgetCommandFieldHint';
             readonly control: 'command-vocabulary';
-            readonly doc: 'Name of the control for assistive technology. Defaults to the command key.';
         };
         readonly parameterSchema: {
             readonly kind: 'string';
@@ -1275,26 +1256,22 @@ export declare const builtinWidgetDescriptors: {
             readonly labelId: 'widgetCommandHeading';
             readonly helpId: 'widgetCommandFieldHint';
             readonly control: 'command-vocabulary';
-            readonly doc: "The command's parameter descriptors, baked in as JSON at author time. Gives the control its range and its refusals.";
         };
         readonly parameter: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelParameter';
             readonly helpId: 'widgetHintControlParameter';
-            readonly doc: 'Which parameter of the command this control sets. May be left blank when the command has exactly one parameter of the right type.';
         };
-    }>;
-    readonly 'stat-card': WidgetDescriptor<"aggregate", {
+    }>>;
+    readonly 'stat-card': WidgetDescriptor<"aggregate", DocumentedSpecs<{
         readonly title: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelTitle';
-            readonly doc: 'Heading shown in the widget frame. Defaults to the displayed measurement name.';
         };
         readonly measurement: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelMeasurement';
             readonly helpId: 'widgetHintMeasurement';
-            readonly doc: 'Which measurement to display. Defaults to the first the datasource selects.';
         };
         readonly stat: {
             readonly kind: "enum";
@@ -1310,12 +1287,10 @@ export declare const builtinWidgetDescriptors: {
                 readonly last: "widgetStatLast";
             };
             readonly placeholderId: "widgetPlaceholderDefault";
-            readonly doc: "Which figure to show. Default average.";
         };
         readonly unit: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelUnit';
-            readonly doc: 'Unit suffix shown beside the value.';
         };
         readonly precision: {
             readonly kind: 'number';
@@ -1324,20 +1299,17 @@ export declare const builtinWidgetDescriptors: {
             readonly max: 100;
             readonly labelId: 'widgetLabelPrecision';
             readonly helpId: 'widgetHintPrecision';
-            readonly doc: 'Decimal places to round displayed values to. Unset rounds to at most 3 decimals (4 significant digits under 1).';
         };
         readonly thresholds: {
             readonly kind: 'list';
             readonly maxItems: 12;
             readonly labelId: 'widgetLabelThresholds';
             readonly helpId: 'widgetHintThresholds';
-            readonly 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.';
             readonly item: {
                 readonly value: {
                     readonly kind: 'number';
                     readonly required: true;
                     readonly labelId: 'widgetLabelThresholdValue';
-                    readonly doc: 'The value at which this band starts.';
                 };
                 readonly level: {
                     readonly kind: 'enum';
@@ -1352,15 +1324,18 @@ export declare const builtinWidgetDescriptors: {
                         readonly critical: 'widgetSeverityCritical';
                     };
                     readonly placeholderId: 'widgetPlaceholderThresholdLevel';
-                    readonly doc: 'The severity of this band. The theme decides the colour; normal has none.';
                 };
                 readonly label: {
                     readonly kind: 'string';
                     readonly labelId: 'widgetLabelThresholdLabel';
-                    readonly doc: 'Text shown on the chart line for this threshold. Defaults to its value.';
                 };
             };
         };
+        readonly sparkline: {
+            readonly kind: "boolean";
+            readonly labelId: "widgetLabelSparkline";
+            readonly helpId: "widgetHintSparkline";
+        };
         readonly windowSeconds: {
             readonly kind: 'number';
             readonly integer: true;
@@ -1368,14 +1343,12 @@ export declare const builtinWidgetDescriptors: {
             readonly max: 604800;
             readonly labelId: 'widgetLabelWindowSeconds';
             readonly helpId: 'widgetHintWindowSeconds';
-            readonly doc: 'Seconds of history the widget covers, back from now. Leave unset to follow the board’s time range; set it to pin this widget to a fixed span that the viewer’s range picker does not change. 60 to 604800.';
         };
-    }>;
-    readonly 'bar-chart': WidgetDescriptor<"measurement", {
+    }>>;
+    readonly 'bar-chart': WidgetDescriptor<"measurement", DocumentedSpecs<{
         readonly title: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelTitle';
-            readonly doc: 'Heading shown in the widget frame. Blank hides the frame heading.';
         };
         readonly groupBy: {
             readonly kind: "enum";
@@ -1387,18 +1360,15 @@ export declare const builtinWidgetDescriptors: {
                 readonly device: "widgetGroupByDevice";
             };
             readonly placeholderId: "widgetPlaceholderDefault";
-            readonly doc: "One bar per measurement (the default), or per device of the group for the measurement set below.";
         };
         readonly measurement: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelMeasurement';
             readonly helpId: 'widgetHintMeasurement';
-            readonly doc: 'Which measurement to display. Defaults to the first the datasource selects.';
         };
         readonly unit: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelUnit';
-            readonly doc: 'Unit suffix shown beside the value.';
         };
         readonly precision: {
             readonly kind: 'number';
@@ -1407,7 +1377,6 @@ export declare const builtinWidgetDescriptors: {
             readonly max: 100;
             readonly labelId: 'widgetLabelPrecision';
             readonly helpId: 'widgetHintPrecision';
-            readonly doc: 'Decimal places to round displayed values to. Unset rounds to at most 3 decimals (4 significant digits under 1).';
         };
         readonly sort: {
             readonly kind: 'enum';
@@ -1419,19 +1388,16 @@ export declare const builtinWidgetDescriptors: {
                 readonly descending: 'widgetSortDescending';
             };
             readonly placeholderId: 'widgetPlaceholderDefault';
-            readonly doc: 'Order of the categories. Default: as the data source lists them.';
         };
-    }>;
-    readonly 'pie-chart': WidgetDescriptor<"measurement", {
+    }>>;
+    readonly 'pie-chart': WidgetDescriptor<"measurement", DocumentedSpecs<{
         readonly title: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelTitle';
-            readonly doc: 'Heading shown in the widget frame. Blank hides the frame heading.';
         };
         readonly unit: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelUnit';
-            readonly doc: 'Unit suffix shown beside the value.';
         };
         readonly precision: {
             readonly kind: 'number';
@@ -1440,7 +1406,6 @@ export declare const builtinWidgetDescriptors: {
             readonly max: 100;
             readonly labelId: 'widgetLabelPrecision';
             readonly helpId: 'widgetHintPrecision';
-            readonly doc: 'Decimal places to round displayed values to. Unset rounds to at most 3 decimals (4 significant digits under 1).';
         };
         readonly sort: {
             readonly kind: 'enum';
@@ -1452,37 +1417,31 @@ export declare const builtinWidgetDescriptors: {
                 readonly descending: 'widgetSortDescending';
             };
             readonly placeholderId: 'widgetPlaceholderDefault';
-            readonly doc: 'Order of the categories. Default: as the data source lists them.';
         };
-    }>;
-    readonly 'fleet-table': WidgetDescriptor<"measurement", {
+    }>>;
+    readonly 'fleet-table': WidgetDescriptor<"measurement", DocumentedSpecs<{
         readonly title: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelTitle';
-            readonly doc: 'Heading shown in the widget frame. Blank hides the frame heading.';
         };
         readonly columns: {
             readonly kind: 'list';
             readonly maxItems: 24;
             readonly labelId: 'widgetLabelColumns';
             readonly helpId: 'widgetHintColumns';
-            readonly doc: 'Heading, unit and precision per measurement column; a column with none shows its name.';
             readonly item: {
                 readonly measurement: {
                     readonly kind: 'string';
                     readonly required: true;
                     readonly labelId: 'widgetLabelMeasurement';
-                    readonly doc: 'The measurement column this entry applies to.';
                 };
                 readonly label: {
                     readonly kind: 'string';
                     readonly labelId: 'widgetLabelColumnHeading';
-                    readonly doc: 'Column heading. Defaults to the measurement name.';
                 };
                 readonly unit: {
                     readonly kind: 'string';
                     readonly labelId: 'widgetLabelUnit';
-                    readonly doc: 'Unit suffix shown beside the value.';
                 };
                 readonly precision: {
                     readonly kind: 'number';
@@ -1491,7 +1450,6 @@ export declare const builtinWidgetDescriptors: {
                     readonly max: 100;
                     readonly labelId: 'widgetLabelPrecision';
                     readonly helpId: 'widgetHintPrecision';
-                    readonly doc: 'Decimal places to round displayed values to. Unset rounds to at most 3 decimals (4 significant digits under 1).';
                 };
             };
         };
@@ -1500,13 +1458,11 @@ export declare const builtinWidgetDescriptors: {
             readonly maxItems: 12;
             readonly labelId: 'widgetLabelThresholds';
             readonly helpId: 'widgetHintThresholds';
-            readonly 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.';
             readonly item: {
                 readonly value: {
                     readonly kind: 'number';
                     readonly required: true;
                     readonly labelId: 'widgetLabelThresholdValue';
-                    readonly doc: 'The value at which this band starts.';
                 };
                 readonly level: {
                     readonly kind: 'enum';
@@ -1521,18 +1477,15 @@ export declare const builtinWidgetDescriptors: {
                         readonly critical: 'widgetSeverityCritical';
                     };
                     readonly placeholderId: 'widgetPlaceholderThresholdLevel';
-                    readonly doc: 'The severity of this band. The theme decides the colour; normal has none.';
                 };
                 readonly label: {
                     readonly kind: 'string';
                     readonly labelId: 'widgetLabelThresholdLabel';
-                    readonly doc: 'Text shown on the chart line for this threshold. Defaults to its value.';
                 };
                 readonly measurement: {
                     readonly kind: 'string';
                     readonly required: true;
                     readonly labelId: 'widgetLabelMeasurement';
-                    readonly doc: 'The measurement column this entry applies to.';
                 };
             };
         };
@@ -1542,7 +1495,6 @@ export declare const builtinWidgetDescriptors: {
             readonly min: 1;
             readonly labelId: 'widgetLabelStaleAfter';
             readonly helpId: 'widgetHintStaleAfter';
-            readonly 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.';
         };
         readonly ageLagSeconds: {
             readonly kind: "number";
@@ -1550,18 +1502,15 @@ export declare const builtinWidgetDescriptors: {
             readonly min: 1;
             readonly labelId: "widgetLabelAgeLag";
             readonly helpId: "widgetHintAgeLag";
-            readonly 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.";
         };
         readonly sortBy: {
             readonly kind: "string";
             readonly labelId: "widgetLabelSortBy";
             readonly helpId: "widgetHintSortBy";
-            readonly doc: "The measurement the table is ordered by. Blank orders by device name.";
         };
         readonly sortDescending: {
             readonly kind: "boolean";
             readonly labelId: "widgetLabelSortDescending";
-            readonly doc: "Largest first.";
         };
         readonly pageSize: {
             readonly kind: "number";
@@ -1569,14 +1518,12 @@ export declare const builtinWidgetDescriptors: {
             readonly min: 5;
             readonly max: 100;
             readonly labelId: "widgetLabelPageSize";
-            readonly doc: "Devices per page. Default 20.";
         };
         readonly selectionTarget: {
             readonly kind: 'string';
             readonly labelId: 'widgetLabelTargetSlot';
             readonly helpId: 'widgetTargetSlotHint';
             readonly control: 'slot-target';
-            readonly doc: 'Name of the slot this widget re-points when the viewer picks an entity.';
         };
         readonly windowSeconds: {
             readonly kind: 'number';
@@ -1585,8 +1532,102 @@ export declare const builtinWidgetDescriptors: {
             readonly max: 604800;
             readonly labelId: 'widgetLabelWindowSeconds';
             readonly helpId: 'widgetHintWindowSeconds';
-            readonly doc: 'Seconds of history the widget covers, back from now. Leave unset to follow the board’s time range; set it to pin this widget to a fixed span that the viewer’s range picker does not change. 60 to 604800.';
         };
-    }>;
+    }>>;
+    readonly 'fleet-count': WidgetDescriptor<"measurement", DocumentedSpecs<{
+        readonly title: {
+            readonly kind: 'string';
+            readonly labelId: 'widgetLabelTitle';
+        };
+        readonly show: {
+            readonly kind: "enum";
+            readonly values: readonly ["attention", "devices"];
+            readonly labelId: "widgetLabelFleetShow";
+            readonly helpId: "widgetHintFleetShow";
+            readonly valueLabelIds: {
+                readonly attention: "widgetFleetShowAttention";
+                readonly devices: "widgetFleetShowDevices";
+            };
+            readonly placeholderId: "widgetPlaceholderDefault";
+        };
+        readonly measurement: {
+            readonly kind: 'string';
+            readonly labelId: 'widgetLabelMeasurement';
+            readonly helpId: 'widgetHintMeasurement';
+        };
+        readonly thresholds: {
+            readonly kind: 'list';
+            readonly maxItems: 12;
+            readonly labelId: 'widgetLabelThresholds';
+            readonly helpId: 'widgetHintThresholds';
+            readonly item: {
+                readonly value: {
+                    readonly kind: 'number';
+                    readonly required: true;
+                    readonly labelId: 'widgetLabelThresholdValue';
+                };
+                readonly level: {
+                    readonly kind: 'enum';
+                    readonly required: true;
+                    readonly values: readonly ["normal", "warning", "minor", "major", "critical"];
+                    readonly labelId: 'widgetLabelThresholdLevel';
+                    readonly valueLabelIds: {
+                        readonly normal: 'widgetSeverityNormal';
+                        readonly warning: 'widgetSeverityWarning';
+                        readonly minor: 'widgetSeverityMinor';
+                        readonly major: 'widgetSeverityMajor';
+                        readonly critical: 'widgetSeverityCritical';
+                    };
+                    readonly placeholderId: 'widgetPlaceholderThresholdLevel';
+                };
+                readonly label: {
+                    readonly kind: 'string';
+                    readonly labelId: 'widgetLabelThresholdLabel';
+                };
+            };
+        };
+        readonly staleAfterSeconds: {
+            readonly kind: 'number';
+            readonly integer: true;
+            readonly min: 1;
+            readonly labelId: 'widgetLabelStaleAfter';
+            readonly helpId: 'widgetHintStaleAfter';
+        };
+        readonly windowSeconds: {
+            readonly kind: 'number';
+            readonly integer: true;
+            readonly min: 60;
+            readonly max: 604800;
+            readonly labelId: 'widgetLabelWindowSeconds';
+            readonly helpId: 'widgetHintWindowSeconds';
+        };
+    }>>;
+    readonly 'device-status': WidgetDescriptor<"measurement", DocumentedSpecs<{
+        readonly title: {
+            readonly kind: 'string';
+            readonly labelId: 'widgetLabelTitle';
+        };
+        readonly staleAfterSeconds: {
+            readonly kind: 'number';
+            readonly integer: true;
+            readonly min: 1;
+            readonly labelId: 'widgetLabelStaleAfter';
+            readonly helpId: 'widgetHintStaleAfter';
+        };
+    }>>;
+    readonly 'online-doughnut': WidgetDescriptor<"measurement", DocumentedSpecs<{
+        readonly title: {
+            readonly kind: 'string';
+            readonly labelId: 'widgetLabelTitle';
+        };
+        readonly staleAfterSeconds: {
+            readonly kind: 'number';
+            readonly integer: true;
+            readonly min: 1;
+            readonly labelId: 'widgetLabelStaleAfter';
+            readonly helpId: 'widgetHintStaleAfter';
+        };
+    }>>;
 };
 export declare const builtinWidgetCatalog: import("@devicechain/dashboards").WidgetCatalog;
+export {};