@devicechain/widgets 0.23.0 → 0.24.0

package/README.md

@@ -65,19 +65,24 @@ bound to a slot needs its datasource resolved first (`resolveWidgets` or
 
 | channel | widgets |
 | --- | --- |
-| measurement | `timeseries-chart`, `latest-card`, `gauge`, `linear-gauge`, `level-gauge`, `battery`, `status-light`, `signal-bars`, `compass`, `progress-ring`, `table`, `bar-chart`, `pie-chart`, `fleet-table` |
+| measurement | `timeseries-chart`, `latest-card`, `gauge`, `linear-gauge`, `level-gauge`, `battery`, `status-light`, `signal-bars`, `compass`, `progress-ring`, `table`, `bar-chart`, `pie-chart`, `fleet-table`, `fleet-count`, `device-status`, `online-doughnut` |
 | aggregate | `stat-card` |
 | none (static) | `label`, `image` |
-| alarm | `alarm-table`, `alarm-count` |
+| alarm | `alarm-table`, `alarm-count`, `alarm-severity` |
 | control | `command-button`, `command-slider`, `command-toggle` |
 | selection | `entity-selector` |
 | location | `map` |
 
-`fleet-table`, and `bar-chart` in its one-bar-per-device mode, read a device
+`fleet-table`, `fleet-count`, and `bar-chart` in its one-bar-per-device mode, read a device
 group member by member. The other measurement widgets, and `stat-card`, show one
 device and refuse a group. `stat-card` shows one figure (average, minimum, maximum, sum, count or
 latest) over the board's time range.
 
+`device-status` and `online-doughnut` read the devices' connectivity (online or offline, and when
+each was last active) from device-state, not their readings. They ride the measurement channel's
+member feed (`data.members[].presence`), so the channel set is unchanged. `device-status` shows one
+device; `online-doughnut` takes a group.
+
 The time-series chart, the dial gauge and the compass are drawn with
 [Apache ECharts](https://echarts.apache.org); the other widgets are plain DOM
 and SVG. The map is [MapLibre GL](https://maplibre.org), loaded lazily so a board

package/dist/aggregate-fold.d.ts

@@ -1,11 +1,12 @@
-import { type HistoryWindow, type MeasurementAggregate, type MeasurementBucket } from '@devicechain/dashboards';
+import { type AggregateTrendPoint, type HistoryWindow, type MeasurementAggregate, type MeasurementBucket } from '@devicechain/dashboards';
 export declare class AggregateFieldsError extends Error {
     constructor(message: string);
 }
 export declare function aggregateBuckets(buckets: readonly MeasurementBucket[]): Record<string, MeasurementAggregate>;
+export declare function aggregateSeries(buckets: readonly MeasurementBucket[]): Record<string, AggregateTrendPoint[]>;
 export declare function aggregateRefreshMs(spanSeconds: number): number;
 export interface AggregateWindow {
     window: HistoryWindow;
     spanSeconds: number;
 }
-export declare function aggregateWindow(spanSeconds: number, at: number): AggregateWindow;
+export declare function aggregateWindow(spanSeconds: number, at: number, bucketSeconds?: number): AggregateWindow;

package/dist/aggregate-strings.d.ts

@@ -8,6 +8,7 @@ export interface AggregateStrings {
     noReadings: (span: string) => string;
     noData: string;
     unbound: string;
+    trend: (stat: string, span: string) => string;
     noCategories: string;
     pieNegative: string;
     pieNoShare: string;

package/dist/alarm-strings.d.ts

@@ -0,0 +1,18 @@
+export interface AlarmStrings {
+    tabsLabel: string;
+    all: string;
+    deviceType: string;
+    activeBadge: (count: number, worst: string) => string;
+    severity: Record<string, string>;
+    breakdown: {
+        label: string;
+        total: (count: number) => string;
+        ofType: (count: number, deviceType: string) => string;
+        item: (severity: string, count: number) => string;
+        loading: string;
+        unsupported: string;
+        failed: string;
+    };
+}
+export declare const ALARM_STRINGS: Record<'en' | 'es', AlarmStrings>;
+export declare function alarmStrings(locale?: string | undefined): AlarmStrings;

package/dist/binding-policy.d.ts

@@ -2,5 +2,9 @@ import { type AlarmSubscription, type CommandSubscription, type WidgetDescriptor
 export declare function measurementWindow(descriptor: WidgetDescriptor, widget: WidgetInstance): number | undefined;
 export declare function measurementSpan(descriptor: WidgetDescriptor, widget: WidgetInstance, boardSpan: number | undefined): number | undefined;
 export declare function membersMode(descriptor: WidgetDescriptor, widget: WidgetInstance): boolean;
+export declare function measurementIsMembersOnly(descriptor: WidgetDescriptor): boolean;
+export declare function presenceMode(descriptor: WidgetDescriptor): boolean;
 export declare function alarmSubscription(descriptor: WidgetDescriptor, widget: WidgetInstance): AlarmSubscription;
+export declare function groupsAlarmsByDeviceType(descriptor: WidgetDescriptor, widget: WidgetInstance): boolean;
 export declare function commandSubscription(descriptor: WidgetDescriptor, widget: WidgetInstance): CommandSubscription;
+export declare function wantsEventMarkers(descriptor: WidgetDescriptor, widget: WidgetInstance): boolean;

package/dist/bound-devices-notice.d.ts

@@ -0,0 +1,30 @@
+import type { BindParamIssue } from '@devicechain/dashboards';
+export interface BoundDevicesNoticeProps {
+    title: string;
+    lines: string[];
+    dismissLabel: string;
+    onDismiss: () => void;
+    retryLabel?: string;
+    onRetry?: () => void;
+}
+export declare function BoundDevicesNotice({ title, lines, dismissLabel, onDismiss, retryLabel, onRetry }: BoundDevicesNoticeProps): import("react").JSX.Element;
+export interface BoundDevicesWording {
+    unknownSlot: (slot: string) => string;
+    notADeviceSlot: (slot: string) => string;
+    invalidToken: (slot: string, token: string) => string;
+    duplicateSlot: (slot: string) => string;
+    derivedSlot: (slot: string) => string;
+    missing: (slot: string, token: string) => string;
+    failed: (slot: string, token: string) => string;
+}
+export declare function describeBoundDevicesProblems(problems: {
+    issues: BindParamIssue[];
+    missing: Array<{
+        slot: string;
+        token: string;
+    }>;
+    failed: Array<{
+        slot: string;
+        token: string;
+    }>;
+}, w: BoundDevicesWording): string[];