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

package/dist/presence-feed.d.ts

@@ -0,0 +1,24 @@
+import { type DevicePresence, type FleetState, type MemberRoster, type WidgetActions, type WidgetDataSource, type WidgetDescriptor, type WidgetInstance } from '@devicechain/dashboards';
+import { type ComponentType } from 'react';
+export interface PresenceFeedProps {
+    hub: WidgetDataSource;
+    widget: WidgetInstance;
+    descriptor: WidgetDescriptor;
+    Component: ComponentType<any>;
+    actions: WidgetActions | undefined;
+    ErrorFrame: ComponentType<{
+        widget: WidgetInstance;
+        error: unknown;
+    }>;
+}
+interface Store {
+    key: string | null;
+    roster: MemberRoster | null;
+    states: Map<string, DevicePresence> | null;
+    forbidden: boolean;
+    error: unknown | null;
+    readAt: number | null;
+}
+export declare function buildPresenceFleet(store: Pick<Store, 'roster' | 'states' | 'forbidden' | 'error'>): FleetState;
+export default function PresenceFeed({ hub, widget, descriptor, Component, actions }: PresenceFeedProps): import("react").JSX.Element;
+export {};

package/dist/presence-model.d.ts

@@ -0,0 +1,13 @@
+import type { FleetMember, MemberPresence } from '@devicechain/dashboards';
+export type PresenceKind = 'online' | 'offline' | 'unknown' | 'pending' | 'failed';
+export declare function presenceKind(presence: MemberPresence | undefined): PresenceKind;
+export declare function lastActivityMs(presence: MemberPresence | undefined): number | undefined;
+export interface PresenceTally {
+    online: number;
+    offline: number;
+    unknown: number;
+    pending: number;
+    failed: number;
+    newest: number | undefined;
+}
+export declare function tallyPresence(members: readonly FleetMember[]): PresenceTally;

package/dist/presence-strings.d.ts

@@ -0,0 +1,19 @@
+export interface PresenceStrings {
+    online: string;
+    offline: string;
+    unknown: string;
+    neverSeen: string;
+    lastSeen: (when: string) => string;
+    failed: string;
+    unsupported: string;
+    unbound: string;
+    oneDevice: string;
+    useDoughnut: string;
+    ofTotal: (total: number) => string;
+    onlineCaption: string;
+    notRead: (n: number) => string;
+    noStatusYet: (n: number) => string;
+    chartLabel: (online: number, offline: number, unknown: number) => string;
+}
+export declare const PRESENCE_STRINGS: Record<'en' | 'es', PresenceStrings>;
+export declare function presenceStrings(locale?: string | undefined): PresenceStrings;

package/dist/sparkline.d.ts

@@ -0,0 +1,23 @@
+import type { AggregateTrendPoint } from '@devicechain/dashboards';
+import type { AggregateStat } from './aggregate-strings';
+export interface TrendPoint {
+    at: number;
+    value: number;
+}
+export declare function trendValue(point: AggregateTrendPoint, stat: AggregateStat): number;
+export declare function trendPoints(series: readonly AggregateTrendPoint[] | undefined, stat: AggregateStat): TrendPoint[];
+export interface SparklineGeometry {
+    d: string;
+    end: {
+        left: number;
+        top: number;
+    } | undefined;
+    points: number;
+}
+export declare function sparklineGeometry(points: readonly TrendPoint[], height: number, bucketSeconds: number): SparklineGeometry;
+export declare function Sparkline({ points, height, bucketSeconds, label, }: {
+    points: readonly TrendPoint[];
+    height: number;
+    bucketSeconds: number;
+    label: string;
+}): import("react").JSX.Element | null;

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

@@ -0,0 +1,26 @@
+import { type BindCheck, type BindParamIssue, type DashboardDefinition, type DeviceResolver, type SelectionTarget, type SlotBinding } from '@devicechain/dashboards';
+export interface BoundDevicesAddress {
+    search: string;
+    replaceSearch: (search: string) => void;
+}
+export interface LinkProblems {
+    issues: BindParamIssue[];
+    missing: BindCheck['missing'];
+    failed: BindCheck['failed'];
+}
+export type BoundDevicesPhase = 'ready' | 'checking' | 'refused';
+export interface BoundDevices {
+    selection: Record<string, SlotBinding>;
+    select: (target: SelectionTarget) => void;
+    reset: () => void;
+    phase: BoundDevicesPhase;
+    problems: LinkProblems | null;
+    dismiss: () => void;
+    retry: () => void;
+}
+export declare function useBoundDevices({ definition, resolver, address, enabled, }: {
+    definition: DashboardDefinition;
+    resolver: Pick<DeviceResolver, 'deviceExists'>;
+    address: BoundDevicesAddress;
+    enabled?: boolean;
+}): BoundDevices;

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

@@ -1,15 +1,13 @@
 export declare const loadAggregateWidgets: () => Promise<typeof import("./aggregate-widgets")>;
-export declare const statCardWidget: import("@devicechain/widget-sdk").WidgetDefinition<"aggregate", {
+export declare const statCardWidget: import("@devicechain/widget-sdk").WidgetDefinition<"aggregate", import("../builtin-descriptors").DocumentedSpecs<{
     readonly title: {
         readonly kind: 'string';
         readonly labelId: 'widgetLabelTitle';
-        readonly doc: 'Heading shown in the widget frame. Defaults to the displayed measurement name.';
     };
     readonly measurement: {
         readonly kind: 'string';
         readonly labelId: 'widgetLabelMeasurement';
         readonly helpId: 'widgetHintMeasurement';
-        readonly doc: 'Which measurement to display. Defaults to the first the datasource selects.';
     };
     readonly stat: {
         readonly kind: "enum";
@@ -25,12 +23,10 @@ export declare const statCardWidget: import("@devicechain/widget-sdk").WidgetDef
             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';
@@ -39,20 +35,17 @@ export declare const statCardWidget: import("@devicechain/widget-sdk").WidgetDef
         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';
@@ -67,15 +60,18 @@ export declare const statCardWidget: import("@devicechain/widget-sdk").WidgetDef
                     readonly critical: 'widgetSeverityCritical';
                 };
                 readonly placeholderId: 'widgetPlaceholderThresholdLevel';
-                readonly doc: 'The severity of this band. The theme decides the colour; normal has none.';
             };
             readonly label: {
                 readonly kind: 'string';
                 readonly labelId: 'widgetLabelThresholdLabel';
-                readonly doc: 'Text shown on the chart line for this threshold. Defaults to its value.';
             };
         };
     };
+    readonly sparkline: {
+        readonly kind: "boolean";
+        readonly labelId: "widgetLabelSparkline";
+        readonly helpId: "widgetHintSparkline";
+    };
     readonly windowSeconds: {
         readonly kind: 'number';
         readonly integer: true;
@@ -83,14 +79,12 @@ export declare const statCardWidget: import("@devicechain/widget-sdk").WidgetDef
         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 const barChartWidget: import("@devicechain/widget-sdk").WidgetDefinition<"measurement", {
+}>>;
+export declare const barChartWidget: import("@devicechain/widget-sdk").WidgetDefinition<"measurement", import("../builtin-descriptors").DocumentedSpecs<{
     readonly title: {
         readonly kind: 'string';
         readonly labelId: 'widgetLabelTitle';
-        readonly doc: 'Heading shown in the widget frame. Blank hides the frame heading.';
     };
     readonly groupBy: {
         readonly kind: "enum";
@@ -102,18 +96,15 @@ export declare const barChartWidget: import("@devicechain/widget-sdk").WidgetDef
             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';
@@ -122,7 +113,6 @@ export declare const barChartWidget: import("@devicechain/widget-sdk").WidgetDef
         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';
@@ -134,19 +124,16 @@ export declare const barChartWidget: import("@devicechain/widget-sdk").WidgetDef
             readonly descending: 'widgetSortDescending';
         };
         readonly placeholderId: 'widgetPlaceholderDefault';
-        readonly doc: 'Order of the categories. Default: as the data source lists them.';
     };
-}>;
-export declare const pieChartWidget: import("@devicechain/widget-sdk").WidgetDefinition<"measurement", {
+}>>;
+export declare const pieChartWidget: import("@devicechain/widget-sdk").WidgetDefinition<"measurement", import("../builtin-descriptors").DocumentedSpecs<{
     readonly title: {
         readonly kind: 'string';
         readonly labelId: 'widgetLabelTitle';
-        readonly doc: 'Heading shown in the widget frame. Blank hides the frame heading.';
     };
     readonly unit: {
         readonly kind: 'string';
         readonly labelId: 'widgetLabelUnit';
-        readonly doc: 'Unit suffix shown beside the value.';
     };
     readonly precision: {
         readonly kind: 'number';
@@ -155,7 +142,6 @@ export declare const pieChartWidget: import("@devicechain/widget-sdk").WidgetDef
         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';
@@ -167,37 +153,99 @@ export declare const pieChartWidget: import("@devicechain/widget-sdk").WidgetDef
             readonly descending: 'widgetSortDescending';
         };
         readonly placeholderId: 'widgetPlaceholderDefault';
-        readonly doc: 'Order of the categories. Default: as the data source lists them.';
     };
-}>;
-export declare const fleetTableWidget: import("@devicechain/widget-sdk").WidgetDefinition<"measurement", {
+}>>;
+export declare const fleetCountWidget: import("@devicechain/widget-sdk").WidgetDefinition<"measurement", import("../builtin-descriptors").DocumentedSpecs<{
+    readonly title: {
+        readonly kind: 'string';
+        readonly labelId: 'widgetLabelTitle';
+    };
+    readonly show: {
+        readonly kind: "enum";
+        readonly values: readonly ["attention", "devices"];
+        readonly labelId: "widgetLabelFleetShow";
+        readonly helpId: "widgetHintFleetShow";
+        readonly valueLabelIds: {
+            readonly attention: "widgetFleetShowAttention";
+            readonly devices: "widgetFleetShowDevices";
+        };
+        readonly placeholderId: "widgetPlaceholderDefault";
+    };
+    readonly measurement: {
+        readonly kind: 'string';
+        readonly labelId: 'widgetLabelMeasurement';
+        readonly helpId: 'widgetHintMeasurement';
+    };
+    readonly thresholds: {
+        readonly kind: 'list';
+        readonly maxItems: 12;
+        readonly labelId: 'widgetLabelThresholds';
+        readonly helpId: 'widgetHintThresholds';
+        readonly item: {
+            readonly value: {
+                readonly kind: 'number';
+                readonly required: true;
+                readonly labelId: 'widgetLabelThresholdValue';
+            };
+            readonly level: {
+                readonly kind: 'enum';
+                readonly required: true;
+                readonly values: readonly ["normal", "warning", "minor", "major", "critical"];
+                readonly labelId: 'widgetLabelThresholdLevel';
+                readonly valueLabelIds: {
+                    readonly normal: 'widgetSeverityNormal';
+                    readonly warning: 'widgetSeverityWarning';
+                    readonly minor: 'widgetSeverityMinor';
+                    readonly major: 'widgetSeverityMajor';
+                    readonly critical: 'widgetSeverityCritical';
+                };
+                readonly placeholderId: 'widgetPlaceholderThresholdLevel';
+            };
+            readonly label: {
+                readonly kind: 'string';
+                readonly labelId: 'widgetLabelThresholdLabel';
+            };
+        };
+    };
+    readonly staleAfterSeconds: {
+        readonly kind: 'number';
+        readonly integer: true;
+        readonly min: 1;
+        readonly labelId: 'widgetLabelStaleAfter';
+        readonly helpId: 'widgetHintStaleAfter';
+    };
+    readonly windowSeconds: {
+        readonly kind: 'number';
+        readonly integer: true;
+        readonly min: 60;
+        readonly max: 604800;
+        readonly labelId: 'widgetLabelWindowSeconds';
+        readonly helpId: 'widgetHintWindowSeconds';
+    };
+}>>;
+export declare const fleetTableWidget: import("@devicechain/widget-sdk").WidgetDefinition<"measurement", import("../builtin-descriptors").DocumentedSpecs<{
     readonly title: {
         readonly kind: 'string';
         readonly labelId: 'widgetLabelTitle';
-        readonly doc: 'Heading shown in the widget frame. Blank hides the frame heading.';
     };
     readonly columns: {
         readonly kind: 'list';
         readonly maxItems: 24;
         readonly labelId: 'widgetLabelColumns';
         readonly helpId: 'widgetHintColumns';
-        readonly doc: 'Heading, unit and precision per measurement column; a column with none shows its name.';
         readonly item: {
             readonly measurement: {
                 readonly kind: 'string';
                 readonly required: true;
                 readonly labelId: 'widgetLabelMeasurement';
-                readonly doc: 'The measurement column this entry applies to.';
             };
             readonly label: {
                 readonly kind: 'string';
                 readonly labelId: 'widgetLabelColumnHeading';
-                readonly doc: 'Column heading. Defaults to the measurement name.';
             };
             readonly unit: {
                 readonly kind: 'string';
                 readonly labelId: 'widgetLabelUnit';
-                readonly doc: 'Unit suffix shown beside the value.';
             };
             readonly precision: {
                 readonly kind: 'number';
@@ -206,7 +254,6 @@ export declare const fleetTableWidget: import("@devicechain/widget-sdk").WidgetD
                 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).';
             };
         };
     };
@@ -215,13 +262,11 @@ export declare const fleetTableWidget: import("@devicechain/widget-sdk").WidgetD
         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';
@@ -236,18 +281,15 @@ export declare const fleetTableWidget: import("@devicechain/widget-sdk").WidgetD
                     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.';
             };
         };
     };
@@ -257,7 +299,6 @@ export declare const fleetTableWidget: import("@devicechain/widget-sdk").WidgetD
         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";
@@ -265,18 +306,15 @@ export declare const fleetTableWidget: import("@devicechain/widget-sdk").WidgetD
         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";
@@ -284,14 +322,12 @@ export declare const fleetTableWidget: import("@devicechain/widget-sdk").WidgetD
         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';
@@ -300,6 +336,5 @@ export declare const fleetTableWidget: import("@devicechain/widget-sdk").WidgetD
         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.';
     };
-}>;
+}>>;

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

@@ -1,4 +1,5 @@
 export { BarChart } from './bar-chart';
+export { FleetCount } from './fleet-count';
 export { FleetTable } from './fleet-table';
 export { PieChart } from './pie-chart';
 export { StatCard } from './stat-card';

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

@@ -0,0 +1,17 @@
+import type { AlarmSubscription, AlarmTypeCount, AlarmTypeTab, WidgetActions, WidgetDataSource, WidgetInstance } from '@devicechain/dashboards';
+import { type ComponentType } from 'react';
+import type { useHeld as UseHeld } from '../use-held';
+export interface GroupedAlarmProps {
+    hub: WidgetDataSource;
+    widget: WidgetInstance;
+    base: AlarmSubscription;
+    useHeld: typeof UseHeld;
+    Component: ComponentType<any>;
+    actions: WidgetActions | undefined;
+    ErrorFrame: ComponentType<{
+        widget: WidgetInstance;
+        error: unknown;
+    }>;
+}
+export declare function foldTypeTabs(counts: readonly AlarmTypeCount[], selected: string | null, names: Map<string, string | null>): AlarmTypeTab[];
+export declare function GroupedAlarm({ widget, hub, base, useHeld, Component, actions, ErrorFrame }: GroupedAlarmProps): import("react").JSX.Element;

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

@@ -1,9 +1,8 @@
 export declare const loadAlarmWidgets: () => Promise<typeof import("./alarm-widgets")>;
-export declare const alarmTableWidget: import("@devicechain/widget-sdk").WidgetDefinition<"alarm", {
+export declare const alarmTableWidget: import("@devicechain/widget-sdk").WidgetDefinition<"alarm", import("../builtin-descriptors").DocumentedSpecs<{
     readonly title: {
         readonly kind: 'string';
         readonly labelId: 'widgetLabelTitle';
-        readonly doc: 'Heading shown in the widget frame. Blank hides the frame heading.';
     };
     readonly state: {
         readonly kind: 'enum';
@@ -15,7 +14,6 @@ export declare const alarmTableWidget: import("@devicechain/widget-sdk").WidgetD
             readonly CLEARED: 'widgetAlarmStateCleared';
         };
         readonly placeholderId: 'widgetPlaceholderAny';
-        readonly doc: 'Show only alarms in this state. Unset shows every state.';
     };
     readonly severity: {
         readonly kind: 'enum';
@@ -30,7 +28,6 @@ export declare const alarmTableWidget: import("@devicechain/widget-sdk").WidgetD
             readonly INDETERMINATE: 'widgetAlarmSeverityIndeterminate';
         };
         readonly placeholderId: 'widgetPlaceholderAny';
-        readonly doc: 'Show only alarms at this severity. Unset shows every severity.';
     };
     readonly acknowledged: {
         readonly kind: 'enum';
@@ -42,7 +39,31 @@ export declare const alarmTableWidget: import("@devicechain/widget-sdk").WidgetD
             readonly false: 'widgetAlarmAckUnacknowledged';
         };
         readonly placeholderId: 'widgetPlaceholderAny';
-        readonly doc: "Show only acknowledged ('true') or unacknowledged ('false') alarms. Unset shows both.";
+    };
+    readonly groupBy: {
+        readonly kind: "enum";
+        readonly values: readonly ["none", "deviceType"];
+        readonly labelId: "widgetLabelAlarmGroupBy";
+        readonly helpId: "widgetHintAlarmGroupBy";
+        readonly valueLabelIds: {
+            readonly none: "widgetAlarmGroupByNone";
+            readonly deviceType: "widgetAlarmGroupByDeviceType";
+        };
+        readonly placeholderId: "widgetPlaceholderDefault";
+    };
+    readonly deviceTypes: {
+        readonly kind: "list";
+        readonly maxItems: 24;
+        readonly ordered: true;
+        readonly labelId: "widgetLabelAlarmDeviceTypes";
+        readonly helpId: "widgetHintAlarmDeviceTypes";
+        readonly item: {
+            readonly token: {
+                readonly kind: "string";
+                readonly control: "device-type";
+                readonly labelId: "widgetLabelAlarmDeviceTypeToken";
+            };
+        };
     };
     readonly maxRows: {
         readonly kind: "number";
@@ -50,7 +71,6 @@ export declare const alarmTableWidget: import("@devicechain/widget-sdk").WidgetD
         readonly min: 1;
         readonly labelId: "widgetLabelMaxRows";
         readonly helpId: "widgetMaxRowsAlarmHint";
-        readonly doc: "Alarms loaded into the table. Default 50.";
     };
     readonly precision: {
         readonly kind: 'number';
@@ -59,27 +79,57 @@ export declare const alarmTableWidget: import("@devicechain/widget-sdk").WidgetD
         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", {
+}>>;
+export declare const alarmSeverityWidget: import("@devicechain/widget-sdk").WidgetDefinition<"alarm", import("../builtin-descriptors").DocumentedSpecs<{
+    readonly title: {
+        readonly kind: 'string';
+        readonly labelId: 'widgetLabelTitle';
+    };
+    readonly state: {
+        readonly kind: 'enum';
+        readonly values: readonly ["ACTIVE", "CLEARED"];
+        readonly labelId: 'widgetLabelState';
+        readonly helpId: 'widgetStateHint';
+        readonly valueLabelIds: {
+            readonly ACTIVE: 'widgetAlarmStateActive';
+            readonly CLEARED: 'widgetAlarmStateCleared';
+        };
+        readonly placeholderId: 'widgetPlaceholderAny';
+    };
+    readonly acknowledged: {
+        readonly kind: 'enum';
+        readonly values: readonly ["true", "false"];
+        readonly labelId: 'widgetLabelAcknowledged';
+        readonly helpId: 'widgetAcknowledgedHint';
+        readonly valueLabelIds: {
+            readonly true: 'widgetAlarmAckAcknowledged';
+            readonly false: 'widgetAlarmAckUnacknowledged';
+        };
+        readonly placeholderId: 'widgetPlaceholderAny';
+    };
+    readonly deviceType: {
+        readonly kind: "string";
+        readonly control: "device-type";
+        readonly labelId: "widgetLabelAlarmSeverityType";
+        readonly helpId: "widgetHintAlarmSeverityType";
+    };
+}>>;
+export declare const alarmCountWidget: import("@devicechain/widget-sdk").WidgetDefinition<"alarm", import("../builtin-descriptors").DocumentedSpecs<{
     readonly title: {
         readonly kind: 'string';
         readonly labelId: 'widgetLabelTitle';
-        readonly doc: 'Heading shown in the widget frame. Blank hides the frame heading.';
     };
     readonly state: {
         readonly kind: 'enum';
@@ -91,7 +141,6 @@ export declare const alarmCountWidget: import("@devicechain/widget-sdk").WidgetD
             readonly CLEARED: 'widgetAlarmStateCleared';
         };
         readonly placeholderId: 'widgetPlaceholderAny';
-        readonly doc: 'Show only alarms in this state. Unset shows every state.';
     };
     readonly severity: {
         readonly kind: 'enum';
@@ -106,7 +155,6 @@ export declare const alarmCountWidget: import("@devicechain/widget-sdk").WidgetD
             readonly INDETERMINATE: 'widgetAlarmSeverityIndeterminate';
         };
         readonly placeholderId: 'widgetPlaceholderAny';
-        readonly doc: 'Show only alarms at this severity. Unset shows every severity.';
     };
     readonly acknowledged: {
         readonly kind: 'enum';
@@ -118,6 +166,5 @@ export declare const alarmCountWidget: import("@devicechain/widget-sdk").WidgetD
             readonly false: 'widgetAlarmAckUnacknowledged';
         };
         readonly placeholderId: 'widgetPlaceholderAny';
-        readonly doc: "Show only acknowledged ('true') or unacknowledged ('false') alarms. Unset shows both.";
     };
-}>;
+}>>;

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

@@ -0,0 +1,8 @@
+import { type AlarmStreamState, type WidgetProps } from '@devicechain/widget-sdk';
+export declare const SEVERITY_SCALE: readonly ['CRITICAL', 'MAJOR', 'MINOR', 'WARNING', 'INDETERMINATE'];
+export type ScaleSeverity = (typeof SEVERITY_SCALE)[number];
+export declare function severityCounts(source: readonly {
+    severity: string;
+    count: number;
+}[]): Record<ScaleSeverity, number>;
+export declare function AlarmSeverity({ widget, data }: WidgetProps<AlarmStreamState>): import("react").JSX.Element;

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

@@ -1,5 +1,7 @@
+import type { AlarmTypeTab } from '@devicechain/dashboards';
 import { type ReactNode } from 'react';
 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 shownTabs(discovered: readonly AlarmTypeTab[], pinned: readonly string[]): AlarmTypeTab[];
 export declare function AlarmTable({ widget, data, actions }: WidgetProps<AlarmStreamState>): import("react").JSX.Element;

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

@@ -0,0 +1,10 @@
+import type { AlarmTypeTab } from '@devicechain/dashboards';
+export interface AlarmTypeTabsProps {
+    tabs: readonly AlarmTypeTab[];
+    selected: string | null;
+    onSelect: (token: string | null) => void;
+    idBase: string;
+}
+export declare const tabDomId: (idBase: string, token: string | null) => string;
+export declare const panelDomId: (idBase: string) => string;
+export declare function AlarmTypeTabsStrip({ tabs, selected, onSelect, idBase }: AlarmTypeTabsProps): import("react").JSX.Element;