@devicechain/widgets 0.22.0 → 0.23.0

package/dist/preload.d.ts

@@ -0,0 +1,2 @@
+import type { WidgetRegistry } from '@devicechain/widget-sdk';
+export declare function preloadWidgets(registry: WidgetRegistry, types: Iterable<string>): Promise<void>;

package/dist/widgets/alarm-count.d.ts

@@ -1,49 +1,3 @@
 import { type AlarmStreamState, type WidgetProps } from '@devicechain/widget-sdk';
 export declare const ALARM_COUNT_CAPTION_ROOM_PX = 20;
 export declare function AlarmCount({ widget, data }: WidgetProps<AlarmStreamState>): import("react").JSX.Element;
-export declare const alarmCountWidget: import("@devicechain/widget-sdk").WidgetDefinition<"alarm", {
-    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';
-        readonly values: readonly ["ACTIVE", "CLEARED"];
-        readonly labelId: 'widgetLabelState';
-        readonly helpId: 'widgetStateHint';
-        readonly valueLabelIds: {
-            readonly ACTIVE: 'widgetAlarmStateActive';
-            readonly CLEARED: 'widgetAlarmStateCleared';
-        };
-        readonly placeholderId: 'widgetPlaceholderAny';
-        readonly doc: 'Show only alarms in this state. Unset shows every state.';
-    };
-    readonly severity: {
-        readonly kind: 'enum';
-        readonly values: readonly ["CRITICAL", "MAJOR", "MINOR", "WARNING", "INDETERMINATE"];
-        readonly labelId: 'widgetLabelSeverity';
-        readonly helpId: 'widgetSeverityHint';
-        readonly valueLabelIds: {
-            readonly CRITICAL: 'widgetAlarmSeverityCritical';
-            readonly MAJOR: 'widgetAlarmSeverityMajor';
-            readonly MINOR: 'widgetAlarmSeverityMinor';
-            readonly WARNING: 'widgetAlarmSeverityWarning';
-            readonly INDETERMINATE: 'widgetAlarmSeverityIndeterminate';
-        };
-        readonly placeholderId: 'widgetPlaceholderAny';
-        readonly doc: 'Show only alarms at this severity. Unset shows every severity.';
-    };
-    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 doc: "Show only acknowledged ('true') or unacknowledged ('false') alarms. Unset shows both.";
-    };
-}>;

package/dist/widgets/alarm-lazy.d.ts

@@ -0,0 +1,123 @@
+export declare const loadAlarmWidgets: () => Promise<typeof import("./alarm-widgets")>;
+export declare const alarmTableWidget: import("@devicechain/widget-sdk").WidgetDefinition<"alarm", {
+    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';
+        readonly values: readonly ["ACTIVE", "CLEARED"];
+        readonly labelId: 'widgetLabelState';
+        readonly helpId: 'widgetStateHint';
+        readonly valueLabelIds: {
+            readonly ACTIVE: 'widgetAlarmStateActive';
+            readonly CLEARED: 'widgetAlarmStateCleared';
+        };
+        readonly placeholderId: 'widgetPlaceholderAny';
+        readonly doc: 'Show only alarms in this state. Unset shows every state.';
+    };
+    readonly severity: {
+        readonly kind: 'enum';
+        readonly values: readonly ["CRITICAL", "MAJOR", "MINOR", "WARNING", "INDETERMINATE"];
+        readonly labelId: 'widgetLabelSeverity';
+        readonly helpId: 'widgetSeverityHint';
+        readonly valueLabelIds: {
+            readonly CRITICAL: 'widgetAlarmSeverityCritical';
+            readonly MAJOR: 'widgetAlarmSeverityMajor';
+            readonly MINOR: 'widgetAlarmSeverityMinor';
+            readonly WARNING: 'widgetAlarmSeverityWarning';
+            readonly INDETERMINATE: 'widgetAlarmSeverityIndeterminate';
+        };
+        readonly placeholderId: 'widgetPlaceholderAny';
+        readonly doc: 'Show only alarms at this severity. Unset shows every severity.';
+    };
+    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 doc: "Show only acknowledged ('true') or unacknowledged ('false') alarms. Unset shows both.";
+    };
+    readonly maxRows: {
+        readonly kind: "number";
+        readonly integer: true;
+        readonly min: 1;
+        readonly labelId: "widgetLabelMaxRows";
+        readonly helpId: "widgetMaxRowsAlarmHint";
+        readonly doc: "Alarms loaded into the table. Default 50.";
+    };
+    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 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.';
+    };
+}>;
+export declare const alarmCountWidget: import("@devicechain/widget-sdk").WidgetDefinition<"alarm", {
+    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';
+        readonly values: readonly ["ACTIVE", "CLEARED"];
+        readonly labelId: 'widgetLabelState';
+        readonly helpId: 'widgetStateHint';
+        readonly valueLabelIds: {
+            readonly ACTIVE: 'widgetAlarmStateActive';
+            readonly CLEARED: 'widgetAlarmStateCleared';
+        };
+        readonly placeholderId: 'widgetPlaceholderAny';
+        readonly doc: 'Show only alarms in this state. Unset shows every state.';
+    };
+    readonly severity: {
+        readonly kind: 'enum';
+        readonly values: readonly ["CRITICAL", "MAJOR", "MINOR", "WARNING", "INDETERMINATE"];
+        readonly labelId: 'widgetLabelSeverity';
+        readonly helpId: 'widgetSeverityHint';
+        readonly valueLabelIds: {
+            readonly CRITICAL: 'widgetAlarmSeverityCritical';
+            readonly MAJOR: 'widgetAlarmSeverityMajor';
+            readonly MINOR: 'widgetAlarmSeverityMinor';
+            readonly WARNING: 'widgetAlarmSeverityWarning';
+            readonly INDETERMINATE: 'widgetAlarmSeverityIndeterminate';
+        };
+        readonly placeholderId: 'widgetPlaceholderAny';
+        readonly doc: 'Show only alarms at this severity. Unset shows every severity.';
+    };
+    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 doc: "Show only acknowledged ('true') or unacknowledged ('false') alarms. Unset shows both.";
+    };
+}>;

package/dist/widgets/alarm-table.d.ts

@@ -3,79 +3,3 @@ import { type AlarmStreamState, type WidgetProps } from '@devicechain/widget-sdk
 export declare const ALARM_TABLE_NARROW_PX = 480;
 export declare function hyphenBreaks(text: string): ReactNode;
 export declare function AlarmTable({ widget, data, actions }: WidgetProps<AlarmStreamState>): import("react").JSX.Element;
-export declare const alarmTableWidget: import("@devicechain/widget-sdk").WidgetDefinition<"alarm", {
-    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';
-        readonly values: readonly ["ACTIVE", "CLEARED"];
-        readonly labelId: 'widgetLabelState';
-        readonly helpId: 'widgetStateHint';
-        readonly valueLabelIds: {
-            readonly ACTIVE: 'widgetAlarmStateActive';
-            readonly CLEARED: 'widgetAlarmStateCleared';
-        };
-        readonly placeholderId: 'widgetPlaceholderAny';
-        readonly doc: 'Show only alarms in this state. Unset shows every state.';
-    };
-    readonly severity: {
-        readonly kind: 'enum';
-        readonly values: readonly ["CRITICAL", "MAJOR", "MINOR", "WARNING", "INDETERMINATE"];
-        readonly labelId: 'widgetLabelSeverity';
-        readonly helpId: 'widgetSeverityHint';
-        readonly valueLabelIds: {
-            readonly CRITICAL: 'widgetAlarmSeverityCritical';
-            readonly MAJOR: 'widgetAlarmSeverityMajor';
-            readonly MINOR: 'widgetAlarmSeverityMinor';
-            readonly WARNING: 'widgetAlarmSeverityWarning';
-            readonly INDETERMINATE: 'widgetAlarmSeverityIndeterminate';
-        };
-        readonly placeholderId: 'widgetPlaceholderAny';
-        readonly doc: 'Show only alarms at this severity. Unset shows every severity.';
-    };
-    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 doc: "Show only acknowledged ('true') or unacknowledged ('false') alarms. Unset shows both.";
-    };
-    readonly maxRows: {
-        readonly kind: "number";
-        readonly integer: true;
-        readonly min: 1;
-        readonly labelId: "widgetLabelMaxRows";
-        readonly helpId: "widgetMaxRowsAlarmHint";
-        readonly doc: "Alarms loaded into the table. Default 50.";
-    };
-    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 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.';
-    };
-}>;

package/dist/widgets/alarm-widgets.d.ts

@@ -0,0 +1,2 @@
+export { AlarmTable } from './alarm-table';
+export { AlarmCount } from './alarm-count';

package/dist/widgets/command-button.d.ts

@@ -1,40 +1,2 @@
 import { type CommandStreamState, type WidgetProps } from '@devicechain/widget-sdk';
 export declare function CommandButton({ widget, data, actions }: WidgetProps<CommandStreamState>): import("react").JSX.Element;
-export declare const commandButtonWidget: 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 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";
-        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. Drives the typed form.";
-    };
-    readonly maxRows: {
-        readonly kind: "number";
-        readonly integer: true;
-        readonly min: 1;
-        readonly labelId: "widgetLabelMaxRows";
-        readonly helpId: "widgetMaxRowsCommandHint";
-        readonly doc: "Recent commands shown in the history. Default 20.";
-    };
-}>;

package/dist/widgets/control-lazy.d.ts

@@ -90,3 +90,41 @@ export declare const commandToggleWidget: import("@devicechain/widget-sdk").Widg
         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.';
     };
 }>;
+export declare const commandButtonWidget: 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 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";
+        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. Drives the typed form.";
+    };
+    readonly maxRows: {
+        readonly kind: "number";
+        readonly integer: true;
+        readonly min: 1;
+        readonly labelId: "widgetLabelMaxRows";
+        readonly helpId: "widgetMaxRowsCommandHint";
+        readonly doc: "Recent commands shown in the history. Default 20.";
+    };
+}>;

package/dist/widgets/control-widgets.d.ts

@@ -1,2 +1,3 @@
+export { CommandButton } from './command-button';
 export { CommandSlider } from './command-slider';
 export { CommandToggle } from './command-toggle';

package/dist/widgets/entity-selector.d.ts

@@ -1,17 +1,2 @@
 import { type WidgetProps } from '@devicechain/widget-sdk';
 export declare function EntitySelector({ widget }: WidgetProps<null>): import("react").JSX.Element;
-export declare const entitySelectorWidget: import("@devicechain/widget-sdk").WidgetDefinition<"selection", {
-    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;
-    };
-}>;

package/dist/widgets/gauge.d.ts

@@ -1,5 +1,9 @@
 import { type WidgetProps } from '@devicechain/widget-sdk';
+import { loadChartEngine } from '@devicechain/widget-sdk/echarts';
 export declare function Gauge({ widget, data }: WidgetProps): import("react").JSX.Element;
+export declare namespace Gauge {
+    export { loadChartEngine as preload };
+}
 export declare const gaugeWidget: import("@devicechain/widget-sdk").WidgetDefinition<"measurement", {
     readonly title: {
         readonly kind: 'string';

package/dist/widgets/lazy-chunk.d.ts

@@ -1,8 +1,9 @@
 import type { MeasurementStreamState, WidgetProps } from '@devicechain/widget-sdk';
 export declare function lazyChunk<M extends Record<string, unknown>, D = MeasurementStreamState>(importer: () => Promise<M>): {
     load: () => Promise<M>;
-    component: <P = D, Props extends object = WidgetProps<P>>(name: keyof M & string) => {
+    component: <P = D, Props extends object = WidgetProps<P>>(name: keyof M & string, alsoPreload?: () => Promise<unknown>) => {
         (props: Props): import("react").JSX.Element | null;
         displayName: string;
+        preload: () => Promise<M>;
     };
 };

package/dist/widgets/selection-lazy.d.ts

@@ -0,0 +1,16 @@
+export declare const loadSelectionWidgets: () => Promise<typeof import("./entity-selector")>;
+export declare const entitySelectorWidget: import("@devicechain/widget-sdk").WidgetDefinition<"selection", {
+    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;
+    };
+}>;

package/dist/widgets/table-lazy.d.ts

@@ -0,0 +1,39 @@
+export declare const loadTableWidget: () => Promise<typeof import("./table")>;
+export declare const tableWidget: 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 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 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;
+        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.';
+    };
+}>;

package/dist/widgets/table.d.ts

@@ -1,40 +1,2 @@
 import { type WidgetProps } from '@devicechain/widget-sdk';
 export declare function Table({ widget, data }: WidgetProps): import("react").JSX.Element;
-export declare const tableWidget: 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 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 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;
-        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.';
-    };
-}>;

package/dist/widgets/time-series-chart.d.ts

@@ -1,5 +1,9 @@
 import { type WidgetProps } from '@devicechain/widget-sdk';
+import { loadChartEngine } from '@devicechain/widget-sdk/echarts';
 export declare function TimeSeriesChart({ widget, data }: WidgetProps): import("react").JSX.Element;
+export declare namespace TimeSeriesChart {
+    export { loadChartEngine as preload };
+}
 export declare const timeSeriesChartWidget: import("@devicechain/widget-sdk").WidgetDefinition<"measurement", {
     readonly title: {
         readonly kind: 'string';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devicechain/widgets",
-  "version": "0.22.0",
+  "version": "0.23.0",
   "description": "DeviceChain's built-in dashboard widgets across six channels — telemetry (time-series chart + gauge over Apache ECharts, latest card, table, and lazily loaded level, indicator and radial widgets: linear and level gauges, battery, status light, signal bars, compass, progress ring), static (label, image; no data), alarm (table, count), control (command button), selection (entity selector), and location (map over MapLibre GL, lazily loaded, tile source supplied by the host app) — plus the renderer that lays them out. Each is a registration built on @devicechain/widget-sdk. Themed via CSS custom properties, no Tailwind leakage.",
   "keywords": [
     "devicechain",
@@ -35,6 +35,9 @@
     },
     "./package.json": "./package.json"
   },
+  "sideEffects": [
+    "./dist/vite.js"
+  ],
   "files": [
     "dist",
     "README.md",
@@ -50,18 +53,18 @@
     "test": "vitest run"
   },
   "peerDependencies": {
-    "@devicechain/client": "0.22.0",
-    "@devicechain/dashboards": "0.22.0",
-    "@devicechain/widget-sdk": "0.22.0",
+    "@devicechain/client": "0.23.0",
+    "@devicechain/dashboards": "0.23.0",
+    "@devicechain/widget-sdk": "0.23.0",
     "echarts": "^6.0.0",
     "maplibre-gl": "^6.13.0",
     "react": "^19.3.0",
     "react-dom": "^19.3.0"
   },
   "devDependencies": {
-    "@devicechain/client": "0.22.0",
-    "@devicechain/dashboards": "0.22.0",
-    "@devicechain/widget-sdk": "0.22.0",
+    "@devicechain/client": "0.23.0",
+    "@devicechain/dashboards": "0.23.0",
+    "@devicechain/widget-sdk": "0.23.0",
     "@testing-library/react": "^16.3.3",
     "@types/node": "^26.6.5",
     "@types/react": "^19.3.0",

package/dist/chunks/aggregate-feed-6ZYKOQOB.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/aggregate-feed.tsx", "../../src/aggregate-fold.ts"],
-  "sourcesContent": ["// Copyright The DeviceChain Authors\n// SPDX-License-Identifier: Apache-2.0\n\n// The data feed of an aggregate widget: the exact aggregates of its measurements over its span,\n// plus the newest live reading of each. Loaded on first use (connected-widget.tsx imports it\n// dynamically), so a board with no aggregate widget never downloads it.\n//\n// The aggregates are folded from the source's own buckets (WidgetDataSource.bucketMeasurements: each\n// carries the exact count, min, max and sum), never from the chart seed: a seed is a series of bucket\n// AVERAGES, and a minimum or maximum cannot be recovered from those. A source that produces no\n// buckets is an explained state, not a guess.\n//\n//   - the span is the widget's pinned one, else the board's (DEFAULT_TIME_RANGE_SECONDS off a board);\n//   - the window is whole minutes (aggregateWindow), so it holds no reading from before the span;\n//   - live, the read ends at the last minute and repeats on the boundaries of aggregateRefreshMs\n//     (one chart bucket of the span: a minute for an hour, 42 minutes for a week), so every card on\n//     the board reads at the same moment and the hub serves identical reads once; paused, it ends\n//     at the freeze instant and is read once, so the number on screen does not move;\n//   - a hidden tab does not read; it reads once when it is shown again;\n//   - a read for a different selector, span or freeze instant is not shown under the new one: a\n//     result is tagged with the key it was read for, and a mismatch reads as loading.\n\nimport {\n  DEFAULT_TIME_RANGE_SECONDS,\n  type AggregateResult,\n  type AggregateStreamState,\n  type WidgetActions,\n  type WidgetDataSource,\n  type WidgetDescriptor,\n  type WidgetInstance,\n} from '@devicechain/dashboards';\nimport { useMeasurementStream, useWidgetTimeRange } from '@devicechain/widget-sdk';\nimport { useEffect, useMemo, useState, type ComponentType } from 'react';\n\nimport { aggregateBuckets, aggregateRefreshMs, aggregateWindow } from './aggregate-fold';\nimport { measurementSpan } from './binding-policy';\n\nconst LOADING: AggregateResult = { status: 'loading' };\n\nexport interface AggregateFeedProps {\n  hub: WidgetDataSource;\n  widget: WidgetInstance;\n  descriptor: WidgetDescriptor;\n  // The widget's component, and the host's pane for a stream that failed (before any figure).\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  Component: ComponentType<any>;\n  actions: WidgetActions | undefined;\n  ErrorFrame: ComponentType<{ widget: WidgetInstance; error: unknown }>;\n}\n\nexport default function AggregateFeed({ hub, widget, descriptor, Component, actions, ErrorFrame }: AggregateFeedProps) {\n  const range = useWidgetTimeRange();\n  const now = useMemo(() => (hub.now ? () => hub.now!() : Date.now), [hub]);\n  const spanSeconds = measurementSpan(descriptor, widget, range?.spanSeconds) ?? DEFAULT_TIME_RANGE_SECONDS;\n  const pausedAt = range?.paused ? range.pausedAt : undefined;\n  const ds = widget.datasource;\n\n  // The newest live reading per measurement. It holds one sample: only `latest` is read, and the\n  // pause keeps it from moving.\n  const stream = useMeasurementStream(hub, ds, { window: 1, pausedAt, now });\n\n  const key = JSON.stringify([ds ?? null, spanSeconds, pausedAt ?? null]);\n  const supported = hub.bucketMeasurements !== undefined;\n  const [tagged, setTagged] = useState<{ key: string; result: AggregateResult }>({ key, result: LOADING });\n\n  useEffect(() => {\n    if (!supported || !ds) return;\n    let current = true;\n    const run = (): void => {\n      const { window, spanSeconds: covered } = aggregateWindow(spanSeconds, pausedAt ?? now());\n      // Folded inside the chain, so a bucket that cannot be trusted fails the read like a network error.\n      hub.bucketMeasurements!(ds, window).then(aggregateBuckets).then(\n        (byName) => {\n          if (!current) return;\n          const { startTime, endTime } = window;\n          setTagged({ key, result: { status: 'ready', byName, startTime, endTime, spanSeconds: covered } });\n        },\n        (err: unknown) => {\n          if (!current) return;\n          const message = err instanceof Error ? err.message : String(err);\n          setTagged({ key, result: { status: 'unavailable', reason: 'failed', message } });\n        },\n      );\n    };\n    run();\n    // Paused, the window is fixed at the freeze instant: nothing new can land in it.\n    if (pausedAt !== undefined) return () => void (current = false);\n    const hidden = () => document.hidden;\n    const every = aggregateRefreshMs(spanSeconds);\n    let timer: ReturnType<typeof setTimeout>;\n    const schedule = (): void => {\n      timer = setTimeout(\n        () => {\n          if (!hidden()) run();\n          schedule();\n        },\n        every - (now() % every),\n      );\n    };\n    schedule();\n    const shown = (): void => {\n      if (!hidden()) run();\n    };\n    document.addEventListener('visibilitychange', shown);\n    return () => {\n      current = false;\n      clearTimeout(timer);\n      document.removeEventListener('visibilitychange', shown);\n    };\n    // `ds` is read through `key` (value identity), not by reference.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [hub, supported, key]);\n\n  let aggregates: AggregateResult;\n  if (!supported) aggregates = { status: 'unavailable', reason: 'unsupported' };\n  else if (!ds) aggregates = { status: 'ready', byName: {}, startTime: '', endTime: '', spanSeconds };\n  else aggregates = tagged.key === key ? tagged.result : LOADING;\n\n  const data: AggregateStreamState = { aggregates, latest: stream.latest, error: stream.error };\n  return data.error ? <ErrorFrame widget={widget} error={data.error} /> : <Component widget={widget} data={data} actions={actions} />;\n}\n", "// Copyright The DeviceChain Authors\n// SPDX-License-Identifier: Apache-2.0\n\n// Aggregates over a span, folded from the backend's time buckets. Each bucket carries the exact\n// count, minimum, maximum and sum of the readings in it, so the span's aggregates are exact too:\n// the min of the mins, the max of the maxes, the sum of the sums, the count of the counts, and a\n// mean that is the total sum over the total count (which is the count-weighted mean of the\n// buckets' averages, without ever reading an average).\n//\n// \uD83D\uDD34 A MINIMUM OR MAXIMUM IS NEVER DERIVED FROM AVERAGES. A bucket's average hides its extremes, so\n// the \"max of the avgs\" is a plausible number that is not the maximum. A bucket that holds\n// readings but lacks a field the aggregate needs is therefore a loud failure here, never a\n// quiet substitution.\n\nimport { bucketSecondsFor, type HistoryWindow, type MeasurementAggregate, type MeasurementBucket } from '@devicechain/dashboards';\n\nexport class AggregateFieldsError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'AggregateFieldsError';\n  }\n}\n\n// aggregateBuckets folds the buckets (any number of devices) into one aggregate per measurement\n// name. A name with no readings in any bucket is absent from the result, not zero.\nexport function aggregateBuckets(buckets: readonly MeasurementBucket[]): Record<string, MeasurementAggregate> {\n  const out: Record<string, MeasurementAggregate> = {};\n  for (const b of buckets) {\n    if (typeof b.count !== 'number') {\n      throw new AggregateFieldsError(`the bucket at ${b.bucketStart} for \"${b.name}\" carries no reading count`);\n    }\n    if (b.count === 0) continue;\n    const { min, max, sum } = b;\n    if (min == null || max == null || sum == null) {\n      const missing = [min == null && 'min', max == null && 'max', sum == null && 'sum'].filter(Boolean);\n      throw new AggregateFieldsError(\n        `the bucket at ${b.bucketStart} for \"${b.name}\" holds ${b.count} readings but no ${missing.join(', ')}`,\n      );\n    }\n    const a = out[b.name];\n    if (!a) out[b.name] = { count: b.count, min, max, sum, avg: sum / b.count };\n    else {\n      a.count += b.count;\n      a.sum += sum;\n      a.min = Math.min(a.min, min);\n      a.max = Math.max(a.max, max);\n      a.avg = a.sum / a.count;\n    }\n  }\n  return out;\n}\n\n// ---- The window a stat reads ------------------------------------------------------------------\n\nconst MINUTE_MS = 60_000;\n\n// aggregateRefreshMs is how often a live stat reads again: one bucket of the span's chart\n// (bucketSecondsFor), so never more often than once a minute. Finer is wasted -- the window it\n// reads moves in whole minutes (aggregateWindow) -- and a 7-day figure re-read every few seconds\n// costs the event store a scan of a week of summaries to move by a few seconds' readings.\nexport function aggregateRefreshMs(spanSeconds: number): number {\n  return bucketSecondsFor(spanSeconds) * 1000;\n}\n\nexport interface AggregateWindow {\n  window: HistoryWindow;\n  // The length the window actually covers, in seconds: the span, or less when the span is not a\n  // whole number of minutes. This, not the span asked for, is what the card says it covers.\n  spanSeconds: number;\n}\n\n// aggregateWindow is the window a stat over `spanSeconds` reads at `at` (epoch ms): whole minutes,\n// ending at the last minute boundary at or before `at`.\n//\n// \uD83D\uDD34 Whole minutes because the event store answers from one-minute summaries, and a summary is\n// read whole: a window starting mid-minute would also count the readings from that minute's\n// start, BEFORE the span, so \"Maximum \u00B7 1h\" could be the maximum of an hour and a minute. Both\n// edges fall on minute boundaries instead, and the end is asked for as the instant just before\n// its boundary (the store's end is inclusive), so the summaries read are exactly the window's.\n// The start rounds UP, so a span that is not a whole number of minutes covers less, never more,\n// and says so (`spanSeconds`).\n//\n// Live cards read again on the boundaries of aggregateRefreshMs (a whole number of minutes), so\n// every card of one span ends its window on the same boundary: cards that read the same\n// measurement ask the same question at the same moment, and the hub answers them with one read.\n// One bucket wide: the card needs only the totals, so the store returns one or two rows per\n// measurement rather than a chart's worth.\nexport function aggregateWindow(spanSeconds: number, at: number): AggregateWindow {\n  const end = Math.floor(at / MINUTE_MS) * MINUTE_MS;\n  const start = Math.ceil((end - spanSeconds * 1000) / MINUTE_MS) * MINUTE_MS;\n  const covered = (end - start) / 1000;\n  return {\n    window: {\n      startTime: new Date(start).toISOString(),\n      endTime: new Date(end - 1).toISOString(),\n      intervalSeconds: Math.max(60, covered),\n    },\n    spanSeconds: covered,\n  };\n}\n"],
-  "mappings": "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",
-  "names": []
-}