@devicechain/widgets 0.19.0-rc.1 → 0.20.0-rc.4

package/dist/options.d.ts

@@ -1,304 +1,12 @@
-import { type WidgetType } from '@devicechain/dashboards';
-interface OptionSpecBase {
-    doc: string;
-    required?: true;
-}
-export interface StringOptionSpec extends OptionSpecBase {
-    kind: 'string';
-    format?: 'json';
-}
-export interface NumberOptionSpec extends OptionSpecBase {
-    kind: 'number';
-    min?: number;
-    max?: number;
-    integer?: true;
-}
-export interface BooleanOptionSpec extends OptionSpecBase {
-    kind: 'boolean';
-}
-export interface EnumOptionSpec<V extends string = string> extends OptionSpecBase {
-    kind: 'enum';
-    values: readonly V[];
-}
-export type OptionSpec = StringOptionSpec | NumberOptionSpec | BooleanOptionSpec | EnumOptionSpec;
-export type WidgetOptionSpecs = Record<string, OptionSpec>;
-export declare const WIDGET_OPTIONS: {
-    readonly 'timeseries-chart': {
-        readonly title: {
-            readonly kind: 'string';
-            readonly doc: 'Heading shown in the widget frame. Blank hides the frame heading.';
-        };
-        readonly window: {
-            readonly kind: 'number';
-            readonly integer: true;
-            readonly min: 1;
-            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 'latest-card': {
-        readonly title: {
-            readonly kind: 'string';
-            readonly doc: 'Heading shown in the widget frame. Defaults to the displayed measurement name.';
-        };
-        readonly measurement: {
-            readonly kind: 'string';
-            readonly doc: 'Which measurement to display. Defaults to the first the datasource selects.';
-        };
-        readonly unit: {
-            readonly kind: 'string';
-            readonly doc: 'Unit suffix shown beside the value.';
-        };
-        readonly precision: {
-            readonly kind: 'number';
-            readonly integer: true;
-            readonly min: 0;
-            readonly max: 100;
-            readonly doc: 'Decimal places to round displayed values to. Unset shows the raw value.';
-        };
-        readonly flashOnChange: {
-            readonly kind: 'boolean';
-            readonly doc: 'Briefly tint a value green on a rise and red on a fall when it changes.';
-        };
-        readonly window: {
-            readonly kind: 'number';
-            readonly integer: true;
-            readonly min: 1;
-            readonly doc: 'Samples retained across ALL of the widget\'s measurements before the oldest are dropped. Bounds memory; only the chart draws them. Default 300.';
-        };
-    };
-    readonly gauge: {
-        readonly title: {
-            readonly kind: 'string';
-            readonly doc: 'Heading shown in the widget frame. Defaults to the displayed measurement name.';
-        };
-        readonly measurement: {
-            readonly kind: 'string';
-            readonly doc: 'Which measurement to display. Defaults to the first the datasource selects.';
-        };
-        readonly min: {
-            readonly kind: 'number';
-            readonly doc: 'Low end of the gauge scale. Default 0.';
-        };
-        readonly max: {
-            readonly kind: 'number';
-            readonly doc: 'High end of the gauge scale. Default 100.';
-        };
-        readonly unit: {
-            readonly kind: 'string';
-            readonly doc: 'Unit suffix shown beside the value.';
-        };
-        readonly flashOnChange: {
-            readonly kind: 'boolean';
-            readonly doc: 'Briefly tint a value green on a rise and red on a fall when it changes.';
-        };
-        readonly window: {
-            readonly kind: 'number';
-            readonly integer: true;
-            readonly min: 1;
-            readonly doc: 'Samples retained across ALL of the widget\'s measurements before the oldest are dropped. Bounds memory; only the chart draws them. Default 300.';
-        };
-    };
-    readonly table: {
-        readonly title: {
-            readonly kind: 'string';
-            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 doc: 'Decimal places to round displayed values to. Unset shows the raw value.';
-        };
-        readonly flashOnChange: {
-            readonly kind: 'boolean';
-            readonly doc: 'Briefly tint a value green on a rise and red on a fall when it changes.';
-        };
-        readonly window: {
-            readonly kind: 'number';
-            readonly integer: true;
-            readonly min: 1;
-            readonly doc: 'Samples retained across ALL of the widget\'s measurements before the oldest are dropped. Bounds memory; only the chart draws them. Default 300.';
-        };
-    };
-    readonly label: {
-        readonly title: {
-            readonly kind: 'string';
-            readonly doc: 'Heading shown in the widget frame. Blank hides the frame heading.';
-        };
-        readonly text: {
-            readonly kind: 'string';
-            readonly required: true;
-            readonly doc: 'The text to show. Rendered as plain text — markup is never interpreted.';
-        };
-        readonly align: {
-            readonly kind: 'enum';
-            readonly values: readonly ["left", "center", "right"];
-            readonly doc: 'Horizontal alignment of the text. Default center.';
-        };
-        readonly fontSize: {
-            readonly kind: 'number';
-            readonly min: 1;
-            readonly doc: 'Text size in pixels. Default 16.';
-        };
-    };
-    readonly image: {
-        readonly title: {
-            readonly kind: 'string';
-            readonly doc: 'Heading shown in the widget frame. Blank hides the frame heading.';
-        };
-        readonly url: {
-            readonly kind: 'string';
-            readonly required: true;
-            readonly doc: 'Source URL of the image.';
-        };
-        readonly alt: {
-            readonly kind: 'string';
-            readonly doc: 'Alternative text describing the image for assistive technology.';
-        };
-        readonly fit: {
-            readonly kind: 'enum';
-            readonly values: readonly ["contain", "cover", "fill"];
-            readonly doc: 'How the image fills its box. Default contain.';
-        };
-    };
-    readonly 'alarm-table': {
-        readonly title: {
-            readonly kind: 'string';
-            readonly doc: 'Heading shown in the widget frame. Blank hides the frame heading.';
-        };
-        readonly state: {
-            readonly kind: 'enum';
-            readonly values: readonly ["ACTIVE", "CLEARED"];
-            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 doc: 'Show only alarms at this severity. Unset shows every severity.';
-        };
-        readonly acknowledged: {
-            readonly kind: 'enum';
-            readonly values: readonly ["true", "false"];
-            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 doc: 'Alarms loaded into the table. Default 50.';
-        };
-        readonly precision: {
-            readonly kind: 'number';
-            readonly integer: true;
-            readonly min: 0;
-            readonly max: 100;
-            readonly doc: 'Decimal places to round displayed values to. Unset shows the raw value.';
-        };
-        readonly flashOnChange: {
-            readonly kind: 'boolean';
-            readonly doc: 'Briefly tint a value green on a rise and red on a fall when it changes.';
-        };
-        readonly selectionTarget: {
-            readonly kind: 'string';
-            readonly doc: 'Name of the slot this widget re-points when the viewer picks an entity.';
-        };
-    };
-    readonly 'alarm-count': {
-        readonly title: {
-            readonly kind: 'string';
-            readonly doc: 'Heading shown in the widget frame. Blank hides the frame heading.';
-        };
-        readonly state: {
-            readonly kind: 'enum';
-            readonly values: readonly ["ACTIVE", "CLEARED"];
-            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 doc: 'Show only alarms at this severity. Unset shows every severity.';
-        };
-        readonly acknowledged: {
-            readonly kind: 'enum';
-            readonly values: readonly ["true", "false"];
-            readonly doc: "Show only acknowledged ('true') or unacknowledged ('false') alarms. Unset shows both.";
-        };
-    };
-    readonly 'command-button': {
-        readonly title: {
-            readonly kind: 'string';
-            readonly doc: 'Heading shown in the widget frame. Blank hides the frame heading.';
-        };
-        readonly commandName: {
-            readonly kind: 'string';
-            readonly required: true;
-            readonly doc: 'Command key issued to the target device. Without it the widget cannot send.';
-        };
-        readonly commandLabel: {
-            readonly kind: 'string';
-            readonly doc: 'Text on the send button. Defaults to the command key.';
-        };
-        readonly parameterSchema: {
-            readonly kind: 'string';
-            readonly format: 'json';
-            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 doc: 'Recent commands shown in the history. Default 20.';
-        };
-    };
-    readonly 'entity-selector': {
-        readonly title: {
-            readonly kind: 'string';
-            readonly doc: 'Heading shown in the widget frame. Blank hides the frame heading.';
-        };
-        readonly selectionTarget: {
-            readonly kind: 'string';
-            readonly doc: 'Name of the slot this widget re-points when the viewer picks an entity.';
-            readonly required: true;
-        };
-    };
-    readonly map: {
-        readonly title: {
-            readonly kind: 'string';
-            readonly doc: 'Heading shown in the widget frame. Blank hides the frame heading.';
-        };
-        readonly tileUrl: {
-            readonly kind: 'string';
-            readonly doc: "Raster tile URL template, e.g. https://tiles.example.com/{z}/{x}/{y}.png. Leave empty to inherit the tenant's basemap; setting one overrides it for this board only.";
-        };
-        readonly attribution: {
-            readonly kind: 'string';
-            readonly doc: 'Credit line the tile source requires, shown on the map. Set whatever the provider you chose asks for.';
-        };
-    };
-};
-type SpecValue<S> = S extends {
-    kind: 'enum';
-    values: readonly (infer V)[];
-} ? V extends string ? V : never : S extends {
-    kind: 'number';
-} ? number : S extends {
-    kind: 'boolean';
-} ? boolean : S extends {
-    kind: 'string';
-} ? string : never;
-type RequiredOptionKeys<S> = {
-    [K in keyof S]: S[K] extends {
-        required: true;
-    } ? K : never;
-}[keyof S];
-type OptionsFor<T extends WidgetType> = {
-    [K in RequiredOptionKeys<(typeof WIDGET_OPTIONS)[T]>]: SpecValue<(typeof WIDGET_OPTIONS)[T][K]>;
-} & {
-    [K in Exclude<keyof (typeof WIDGET_OPTIONS)[T], RequiredOptionKeys<(typeof WIDGET_OPTIONS)[T]>>]?: SpecValue<(typeof WIDGET_OPTIONS)[T][K]>;
+import { clampNumberOption, type NumberOptionSpec, type OptionIssueCode, type BuiltinWidgetId, type OptionsOf, type WidgetType } from '@devicechain/dashboards';
+import { builtinWidgetDescriptors } from './builtin-descriptors';
+export type { BooleanOptionSpec, EnumOptionSpec, NumberOptionSpec, OptionIssueCode, OptionSpec, StringOptionSpec, WidgetOptionSpecs, } from '@devicechain/dashboards';
+export { clampNumberOption };
+type OptionsById = {
+    readonly [K in BuiltinWidgetId]: (typeof builtinWidgetDescriptors)[K]['options'];
 };
-export type WidgetOptions<T extends WidgetType> = T extends WidgetType ? OptionsFor<T> : never;
-export type OptionIssueCode = 'unknown' | 'type' | 'enum' | 'range' | 'missing' | 'json' | 'invariant';
+export declare const WIDGET_OPTIONS: OptionsById;
+export type WidgetOptions<T extends WidgetType> = T extends WidgetType ? OptionsOf<(typeof WIDGET_OPTIONS)[T]> : never;
 export interface OptionIssue {
     widgetType: WidgetType;
     key: string;
@@ -307,6 +15,4 @@ export interface OptionIssue {
 }
 export declare function validateWidgetOptions(widgetType: WidgetType, options: Record<string, unknown> | undefined): OptionIssue[];
 export declare function numberOptionSpec(type: WidgetType, key: string): NumberOptionSpec | undefined;
-export declare function clampNumberOption(spec: NumberOptionSpec | undefined, value: number): number | undefined;
 export declare function enumOptionValues(type: WidgetType, key: string): readonly string[] | undefined;
-export {};

package/dist/registry.d.ts

@@ -1,44 +1,10 @@
-import type { WidgetType } from '@devicechain/dashboards';
-import type { AlarmStreamState, CommandStreamState, LocationStreamState } from './hooks';
-import type { WidgetComponent } from './widget';
-export type WidgetChannel = 'measurement' | 'alarm' | 'control' | 'selection' | 'location';
+import type { BuiltinWidgetId, WidgetChannel } from '@devicechain/dashboards';
+import { builtinWidgetDescriptors } from './builtin-descriptors';
+export type { WidgetChannel };
+type Descriptors = typeof builtinWidgetDescriptors;
 export declare const WIDGET_CHANNEL: {
-    readonly 'timeseries-chart': 'measurement';
-    readonly 'latest-card': 'measurement';
-    readonly gauge: 'measurement';
-    readonly table: 'measurement';
-    readonly label: 'measurement';
-    readonly image: 'measurement';
-    readonly 'alarm-table': 'alarm';
-    readonly 'alarm-count': 'alarm';
-    readonly 'command-button': 'control';
-    readonly 'entity-selector': 'selection';
-    readonly map: 'location';
+    readonly [K in BuiltinWidgetId]: Descriptors[K]['channel'];
 };
-type WidgetTypeOn<C extends WidgetChannel> = {
-    [K in WidgetType]: (typeof WIDGET_CHANNEL)[K] extends C ? K : never;
-}[WidgetType];
-type MeasurementWidgetType = WidgetTypeOn<'measurement'>;
-type AlarmWidgetType = WidgetTypeOn<'alarm'>;
-type ControlWidgetType = WidgetTypeOn<'control'>;
-type SelectionWidgetType = WidgetTypeOn<'selection'>;
-type LocationWidgetType = WidgetTypeOn<'location'>;
-export declare const WIDGET_REGISTRY: Record<MeasurementWidgetType, WidgetComponent>;
-export declare const ALARM_WIDGET_REGISTRY: Record<AlarmWidgetType, WidgetComponent<AlarmStreamState>>;
-export declare const CONTROL_WIDGET_REGISTRY: Record<ControlWidgetType, WidgetComponent<CommandStreamState>>;
-export declare const SELECTION_WIDGET_REGISTRY: Record<SelectionWidgetType, WidgetComponent<null>>;
-export declare const LOCATION_WIDGET_REGISTRY: Record<LocationWidgetType, WidgetComponent<LocationStreamState>>;
 export declare const WIDGET_BINDS_DATASOURCE: {
-    readonly 'timeseries-chart': true;
-    readonly 'latest-card': true;
-    readonly gauge: true;
-    readonly table: true;
-    readonly label: false;
-    readonly image: false;
-    readonly 'alarm-table': true;
-    readonly 'alarm-count': true;
-    readonly 'command-button': true;
-    readonly 'entity-selector': false;
-    readonly map: true;
+    readonly [K in BuiltinWidgetId]: boolean;
 };
-export {};

package/dist/widget-containment.d.ts

@@ -0,0 +1,9 @@
+import { type ReactNode } from 'react';
+import { type ReportRejection } from './widget-host';
+export declare function useReportRejection(): ReportRejection;
+export interface WidgetContainmentProps {
+    title?: string;
+    resetKey: string;
+    children: ReactNode;
+}
+export declare function WidgetContainment({ title, resetKey, children }: WidgetContainmentProps): import("react").JSX.Element;

package/dist/widget-host.d.ts

@@ -0,0 +1,7 @@
+import type { WidgetActions, WidgetDescriptor } from '@devicechain/dashboards';
+import { type WidgetCandidates, type WidgetSelect } from '@devicechain/widget-sdk';
+export type ReportRejection = (message: string) => void;
+export declare function describeError(error: unknown): string;
+export declare function narrowActions(actions: WidgetActions | undefined, descriptor: WidgetDescriptor, report: ReportRejection): WidgetActions | undefined;
+export declare function narrowSelect(select: WidgetSelect | undefined, descriptor: WidgetDescriptor): WidgetSelect | undefined;
+export declare function narrowCandidates(candidates: WidgetCandidates | undefined, descriptor: WidgetDescriptor, report: ReportRejection): WidgetCandidates | undefined;

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

@@ -1,3 +1,48 @@
-import type { AlarmStreamState } from '../hooks';
-import { type WidgetProps } from '../widget';
+import { type AlarmStreamState, type WidgetProps } from '@devicechain/widget-sdk';
 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-table.d.ts

@@ -1,3 +1,78 @@
-import type { AlarmStreamState } from '../hooks';
-import { type WidgetProps } from '../widget';
+import { type AlarmStreamState, type WidgetProps } from '@devicechain/widget-sdk';
 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 shows the raw 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 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/command-button.d.ts

@@ -1,3 +1,40 @@
-import type { CommandStreamState } from '../hooks';
-import { type WidgetProps } from '../widget';
+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/entity-selector.d.ts

@@ -1,2 +1,17 @@
-import { type WidgetProps } from '../widget';
+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,2 +1,44 @@
-import { type WidgetProps } from '../widget';
+import { type WidgetProps } from '@devicechain/widget-sdk';
 export declare function Gauge({ widget, data }: WidgetProps): import("react").JSX.Element;
+export declare const gaugeWidget: 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 doc: "Low end of the gauge scale. Default 0.";
+    };
+    readonly max: {
+        readonly kind: "number";
+        readonly labelId: "widgetLabelMax";
+        readonly doc: "High end of the gauge scale. Default 100.";
+    };
+    readonly unit: {
+        readonly kind: 'string';
+        readonly labelId: 'widgetLabelUnit';
+        readonly doc: 'Unit suffix shown beside the value.';
+    };
+    readonly 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 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/image.d.ts

@@ -1,2 +1,32 @@
-import { type WidgetProps } from '../widget';
-export declare function Image({ widget }: WidgetProps): import("react").JSX.Element;
+import { type WidgetProps } from '@devicechain/widget-sdk';
+export declare function Image({ widget }: WidgetProps<null>): import("react").JSX.Element;
+export declare const imageWidget: import("@devicechain/widget-sdk").WidgetDefinition<"none", {
+    readonly title: {
+        readonly kind: 'string';
+        readonly labelId: 'widgetLabelTitle';
+        readonly doc: 'Heading shown in the widget frame. Blank hides the frame heading.';
+    };
+    readonly url: {
+        readonly kind: "string";
+        readonly required: true;
+        readonly labelId: "widgetLabelImageUrl";
+        readonly doc: "Source URL of the image.";
+    };
+    readonly alt: {
+        readonly kind: "string";
+        readonly labelId: "widgetLabelAltText";
+        readonly doc: "Alternative text describing the image for assistive technology.";
+    };
+    readonly fit: {
+        readonly kind: "enum";
+        readonly values: readonly ["contain", "cover", "fill"];
+        readonly labelId: "widgetLabelFit";
+        readonly valueLabelIds: {
+            readonly contain: "widgetFitContain";
+            readonly cover: "widgetFitCover";
+            readonly fill: "widgetFitFill";
+        };
+        readonly placeholderId: "widgetPlaceholderDefault";
+        readonly doc: "How the image fills its box. Default contain.";
+    };
+}>;