@devicechain/widgets 0.21.1-rc.1 → 0.22.0-rc.1

package/dist/builtin-registry.d.ts

@@ -5,13 +5,71 @@ export declare const builtinWidgetDefinitions: readonly [import("@devicechain/wi
         readonly labelId: 'widgetLabelTitle';
         readonly doc: 'Heading shown in the widget frame. Blank hides the frame heading.';
     };
-    readonly window: {
+    readonly unit: {
+        readonly kind: 'string';
+        readonly labelId: 'widgetLabelUnit';
+        readonly doc: 'Unit suffix shown beside the value.';
+    };
+    readonly precision: {
+        readonly kind: 'number';
+        readonly integer: true;
+        readonly min: 0;
+        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';
+                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 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 staleAfterSeconds: {
         readonly kind: 'number';
         readonly integer: true;
         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 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';
+        readonly integer: true;
+        readonly min: 60;
+        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.';
     };
 }>, import("@devicechain/widget-sdk").WidgetDefinition<"measurement", {
     readonly title: {
@@ -37,7 +95,42 @@ export declare const builtinWidgetDefinitions: readonly [import("@devicechain/wi
         readonly max: 100;
         readonly labelId: 'widgetLabelPrecision';
         readonly helpId: 'widgetHintPrecision';
-        readonly doc: 'Decimal places to round displayed values to. Unset shows the raw value.';
+        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';
+                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 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 flashOnChange: {
         readonly kind: 'boolean';
@@ -45,6 +138,14 @@ export declare const builtinWidgetDefinitions: readonly [import("@devicechain/wi
         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';
+        readonly integer: true;
+        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';
         readonly integer: true;
@@ -80,12 +181,64 @@ export declare const builtinWidgetDefinitions: readonly [import("@devicechain/wi
         readonly labelId: 'widgetLabelUnit';
         readonly doc: 'Unit suffix shown beside the value.';
     };
+    readonly precision: {
+        readonly kind: 'number';
+        readonly integer: true;
+        readonly min: 0;
+        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';
+                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 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 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';
+        readonly integer: true;
+        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';
         readonly integer: true;
@@ -107,7 +260,7 @@ export declare const builtinWidgetDefinitions: readonly [import("@devicechain/wi
         readonly max: 100;
         readonly labelId: 'widgetLabelPrecision';
         readonly helpId: 'widgetHintPrecision';
-        readonly doc: 'Decimal places to round displayed values to. Unset shows the raw value.';
+        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';
@@ -115,6 +268,14 @@ export declare const builtinWidgetDefinitions: readonly [import("@devicechain/wi
         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';
+        readonly integer: true;
+        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';
         readonly integer: true;
@@ -152,7 +313,7 @@ export declare const builtinWidgetDefinitions: readonly [import("@devicechain/wi
         readonly min: 1;
         readonly labelId: "widgetLabelFontSize";
         readonly helpId: "widgetHintFontSize";
-        readonly doc: "Text size in pixels. Default 16.";
+        readonly doc: "Text size in pixels at the comfortable density; it scales with the board density. Default 16.";
     };
 }>, import("@devicechain/widget-sdk").WidgetDefinition<"none", {
     readonly title: {
@@ -243,7 +404,7 @@ export declare const builtinWidgetDefinitions: readonly [import("@devicechain/wi
         readonly max: 100;
         readonly labelId: 'widgetLabelPrecision';
         readonly helpId: 'widgetHintPrecision';
-        readonly doc: 'Decimal places to round displayed values to. Unset shows the raw value.';
+        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';
@@ -374,5 +535,1033 @@ export declare const builtinWidgetDefinitions: readonly [import("@devicechain/wi
         readonly control: "basemap";
         readonly doc: "Credit line the tile source requires, shown on the map. Set whatever the provider you chose asks for.";
     };
+}>, import("@devicechain/widget-sdk").WidgetDefinition<"measurement", {
+    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";
+        readonly values: readonly ["bar", "thermometer"];
+        readonly labelId: "widgetLabelLinearStyle";
+        readonly valueLabelIds: {
+            readonly bar: "widgetLinearStyleBar";
+            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";
+        readonly values: readonly ["horizontal", "vertical"];
+        readonly labelId: "widgetLabelOrientation";
+        readonly valueLabelIds: {
+            readonly horizontal: "widgetOrientationHorizontal";
+            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';
+        readonly integer: true;
+        readonly min: 0;
+        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';
+                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 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 staleAfterSeconds: {
+        readonly kind: 'number';
+        readonly integer: true;
+        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';
+        readonly integer: true;
+        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.';
+    };
+}>, import("@devicechain/widget-sdk").WidgetDefinition<"measurement", {
+    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";
+        readonly values: readonly ["value", "percent"];
+        readonly labelId: "widgetLabelReadout";
+        readonly valueLabelIds: {
+            readonly value: "widgetReadoutValue";
+            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';
+        readonly integer: true;
+        readonly min: 0;
+        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';
+                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 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 staleAfterSeconds: {
+        readonly kind: 'number';
+        readonly integer: true;
+        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';
+        readonly integer: true;
+        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.';
+    };
+}>, import("@devicechain/widget-sdk").WidgetDefinition<"measurement", {
+    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';
+        readonly integer: true;
+        readonly min: 0;
+        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';
+                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 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 staleAfterSeconds: {
+        readonly kind: 'number';
+        readonly integer: true;
+        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';
+        readonly integer: true;
+        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.';
+    };
+}>, import("@devicechain/widget-sdk").WidgetDefinition<"measurement", {
+    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';
+        readonly integer: true;
+        readonly min: 0;
+        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';
+                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 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 staleAfterSeconds: {
+        readonly kind: 'number';
+        readonly integer: true;
+        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';
+        readonly integer: true;
+        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.';
+    };
+}>, import("@devicechain/widget-sdk").WidgetDefinition<"measurement", {
+    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';
+        readonly integer: true;
+        readonly min: 0;
+        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 labelId: 'widgetLabelThresholds';
+        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';
+                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 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';
+        readonly integer: true;
+        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';
+        readonly integer: true;
+        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.';
+    };
+}>, import("@devicechain/widget-sdk").WidgetDefinition<"measurement", {
+    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';
+        readonly integer: true;
+        readonly min: 0;
+        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';
+        readonly maxItems: 12;
+        readonly labelId: 'widgetLabelThresholds';
+        readonly helpId: 'widgetHintThresholds';
+        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';
+                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 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';
+        readonly integer: true;
+        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';
+        readonly integer: true;
+        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.';
+    };
+}>, import("@devicechain/widget-sdk").WidgetDefinition<"measurement", {
+    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";
+        readonly values: readonly ["percent", "value"];
+        readonly labelId: "widgetLabelReadout";
+        readonly valueLabelIds: {
+            readonly percent: "widgetReadoutPercent";
+            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';
+        readonly integer: true;
+        readonly min: 0;
+        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';
+                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 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 staleAfterSeconds: {
+        readonly kind: 'number';
+        readonly integer: true;
+        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';
+        readonly integer: true;
+        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.';
+    };
+}>, import("@devicechain/widget-sdk").WidgetDefinition<"control", {
+    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';
+        readonly required: true;
+        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';
+        readonly format: 'json';
+        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.";
+    };
+}>, import("@devicechain/widget-sdk").WidgetDefinition<"control", {
+    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';
+        readonly required: true;
+        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';
+        readonly format: 'json';
+        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.';
+    };
+}>, import("@devicechain/widget-sdk").WidgetDefinition<"aggregate", {
+    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";
+        readonly values: readonly ["avg", "min", "max", "sum", "count", "last"];
+        readonly labelId: "widgetLabelStat";
+        readonly helpId: "widgetHintStat";
+        readonly valueLabelIds: {
+            readonly avg: "widgetStatAvg";
+            readonly min: "widgetStatMin";
+            readonly max: "widgetStatMax";
+            readonly sum: "widgetStatSum";
+            readonly count: "widgetStatCount";
+            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';
+        readonly integer: true;
+        readonly min: 0;
+        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';
+                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 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 windowSeconds: {
+        readonly kind: 'number';
+        readonly integer: true;
+        readonly min: 60;
+        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.';
+    };
+}>, import("@devicechain/widget-sdk").WidgetDefinition<"measurement", {
+    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";
+        readonly values: readonly ["measurement", "device"];
+        readonly labelId: "widgetLabelGroupBy";
+        readonly helpId: "widgetHintGroupBy";
+        readonly valueLabelIds: {
+            readonly measurement: "widgetGroupByMeasurement";
+            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';
+        readonly integer: true;
+        readonly min: 0;
+        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';
+        readonly values: readonly ["none", "ascending", "descending"];
+        readonly labelId: 'widgetLabelSort';
+        readonly valueLabelIds: {
+            readonly none: 'widgetSortNone';
+            readonly ascending: 'widgetSortAscending';
+            readonly descending: 'widgetSortDescending';
+        };
+        readonly placeholderId: 'widgetPlaceholderDefault';
+        readonly doc: 'Order of the categories. Default: as the data source lists them.';
+    };
+}>, import("@devicechain/widget-sdk").WidgetDefinition<"measurement", {
+    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';
+        readonly integer: true;
+        readonly min: 0;
+        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';
+        readonly values: readonly ["none", "ascending", "descending"];
+        readonly labelId: 'widgetLabelSort';
+        readonly valueLabelIds: {
+            readonly none: 'widgetSortNone';
+            readonly ascending: 'widgetSortAscending';
+            readonly descending: 'widgetSortDescending';
+        };
+        readonly placeholderId: 'widgetPlaceholderDefault';
+        readonly doc: 'Order of the categories. Default: as the data source lists them.';
+    };
+}>, import("@devicechain/widget-sdk").WidgetDefinition<"measurement", {
+    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';
+                readonly integer: true;
+                readonly min: 0;
+                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';
+                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 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.';
+            };
+        };
+    };
+    readonly staleAfterSeconds: {
+        readonly kind: 'number';
+        readonly integer: true;
+        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";
+        readonly integer: true;
+        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";
+        readonly integer: true;
+        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';
+        readonly integer: true;
+        readonly min: 60;
+        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.';
+    };
 }>];
 export declare function createBuiltinWidgetRegistry(): WidgetRegistry;