@procaaso/alphinity-ui-components 1.9.0 → 1.10.0

package/dist/index.d.cts

@@ -48,6 +48,38 @@ declare const Selector: react__default.FC<SelectorProps>;
  * Status levels for telemetry values
  */
 type TelemetryStatus$1 = 'normal' | 'warning' | 'alarm' | 'fault' | 'off';
+/**
+ * Marks a value as a maintenance force rather than a measured reading
+ * (alphinity-tffi issue #3607, unit U11). A forced value is a deliberate
+ * substitution at the instrument, so a surface that shows it must show
+ * `active` and, when known, the real value beside it. Never render `active`
+ * as a `TelemetryStatus` color; forced and alarm/warning/fault are
+ * independent facts about the same reading.
+ */
+interface ForcedState {
+    /** True while the tag carries an active maintenance force. Source: the control program's Sts_SimulationActive flag. */
+    active: boolean;
+    /**
+     * The real, unforced value, in the same unit as the primary value.
+     * Optional: the backend does not publish this yet for every tag kind
+     * (alphinity-tffi unit U3b). Render the forced mark alone when this is
+     * absent; never show a placeholder in its place.
+     *
+     * Covers both directions this feature forces, and the two read
+     * differently even though the field is the same:
+     * - Forced INPUT (a transmitter): the real, currently measured value.
+     * - Forced OUTPUT (a valve, a lamp, a commanded position): the value the
+     *   control system would be commanding right now if the force were not
+     *   active. Not the feedback tag. XV valve position feedback (ZSC/ZSO) is
+     *   synthesized from the commanded position, not sensed by a physical
+     *   limit switch (alphinity-tffi #774, a permanent design choice), and
+     *   pump feedback reaches the bus but nothing consumes it as a position.
+     *   Showing either as "real" would present a derived number as measured -
+     *   the exact confidently-wrong display this feature exists to prevent.
+     *   A commanded value, honestly labeled, is the only real answer here.
+     */
+    realValue?: number | string | boolean;
+}
 /**
  * Live telemetry value with status
  */
@@ -98,6 +130,11 @@ interface TelemetryBinding {
     tag: string;
     /** Current telemetry value */
     value: TelemetryValue;
+    /**
+     * Maintenance force state (#3607, R19). Absent or `active: false` means
+     * the value is a real reading; render nothing extra. See `ForcedState`.
+     */
+    forced?: ForcedState;
     /**
      * Uniform scaling / EU metadata (units, range, precision). When present it is
      * the authoritative source for the displayed units, decimal precision, and
@@ -197,10 +234,34 @@ interface ControlPanelProps extends react__default.HTMLAttributes<HTMLDivElement
     modeOptions: SelectorOption[];
     /** Callback when mode changes */
     onModeChange: (mode: string) => void;
-    /** Current setpoint value */
+    /** Typed/target setpoint value (editable) */
     setpointValue: number | string;
     /** Callback when setpoint changes */
     onSetpointChange: (value: number | string) => void;
+    /**
+     * The setpoint the control loop is currently running: read-only feedback
+     * from live telemetry, shown beside the typed setpoint above so an
+     * operator sees target and current separately (the typed field never
+     * "snaps back" to reflect the live value).
+     *
+     * Optional and hidden by default: the caller decides when a live-feedback
+     * row is worth showing, since always showing a normally-differing current
+     * value can read as a fault when none exists. When this tag carries a
+     * maintenance force, the caller MUST pass this prop at that time - a
+     * hidden value shows nothing, forced or not, but a shown value must carry
+     * its FORCED mark (#3607, R19).
+     */
+    currentSetpointValue?: number | string;
+    /**
+     * True when `currentSetpointValue` is a maintenance force, not a measured
+     * reading. Ignored when `currentSetpointValue` is not provided.
+     */
+    currentSetpointForced?: boolean;
+    /**
+     * The real, unforced value for `currentSetpointValue`. Optional; absent
+     * until the backend publishes it (alphinity-tffi unit U3b).
+     */
+    currentSetpointRealValue?: number | string;
     /** Current second setpoint value (for ramp mode, etc.) */
     secondSetpointValue?: number | string;
     /** Callback when second setpoint changes */
@@ -266,6 +327,22 @@ interface StatusIndicatorProps extends react__default.HTMLAttributes<HTMLDivElem
     shape?: 'circle' | 'square' | 'diamond';
     /** Whether the indicator should have a 3D LED effect */
     led?: boolean;
+    /**
+     * True when the underlying tag's state is a maintenance force, not a
+     * measured reading (#3607, R19). Renders a small glyph badge, never a
+     * color change: this indicator's whole signal is color plus a short
+     * label today, and color alone fails a colorblind operator.
+     */
+    forced?: boolean;
+    /**
+     * The real, unforced state, shown as text beside `label` when `forced`
+     * is true. For a forced discrete OUTPUT (a lamp, a valve OPEN/CLOSED
+     * indicator - R2), this is the state the system would command if the
+     * force were not active, not a second physical reading. Optional:
+     * absent until the backend publishes it. When absent, only the forced
+     * glyph badge renders.
+     */
+    realValue?: string;
 }
 declare const StatusIndicator: react__default.FC<StatusIndicatorProps>;
 
@@ -290,6 +367,19 @@ interface ValueEntryProps extends Omit<react__default.InputHTMLAttributes<HTMLIn
     label?: string;
     /** Whether the input is read-only */
     readOnly?: boolean;
+    /**
+     * True when `value` is a maintenance force, not a measured reading
+     * (#3607, R19). Source: the control program's Sts_SimulationActive flag.
+     * Renders a FORCED badge; never changes `status`, which stays an
+     * independent fact about the same reading.
+     */
+    forced?: boolean;
+    /**
+     * The real, unforced value, shown beside `value` when `forced` is true.
+     * Optional: the backend does not publish this for every tag kind yet
+     * (alphinity-tffi unit U3b). When absent, only the FORCED badge renders.
+     */
+    realValue?: number | string;
 }
 declare const ValueEntry: react__default.FC<ValueEntryProps>;
 
@@ -314,6 +404,16 @@ interface LegacyValueEntryProps extends Omit<react__default.InputHTMLAttributes<
     label?: string;
     /** Whether the input is read-only */
     readOnly?: boolean;
+    /**
+     * True when `value` is a maintenance force, not a measured reading
+     * (#3607, R19). Renders a FORCED badge; never changes `status`.
+     */
+    forced?: boolean;
+    /**
+     * The real, unforced value, shown beside `value` when `forced` is true.
+     * Optional; absent until the backend publishes it (unit U3b).
+     */
+    realValue?: number | string;
 }
 declare const LegacyValueEntry: react__default.FC<LegacyValueEntryProps>;
 
@@ -328,10 +428,16 @@ interface NodeControlConfig {
     currentMode: string;
     /** Callback when mode changes */
     onModeChange: (mode: string) => void;
-    /** Current setpoint value */
+    /** Typed/target setpoint value (editable) */
     setpoint: number | string;
     /** Callback when setpoint changes */
     onSetpointChange: (value: number | string) => void;
+    /** Current setpoint: read-only feedback from live telemetry. See ControlPanelProps.currentSetpointValue. */
+    currentSetpoint?: number | string;
+    /** True when `currentSetpoint` is a maintenance force, not a measured reading. */
+    currentSetpointForced?: boolean;
+    /** The real, unforced value for `currentSetpoint`. Optional; absent until the backend publishes it. */
+    currentSetpointRealValue?: number | string;
     /** Optional second setpoint value */
     secondSetpoint?: number | string;
     /** Callback for second setpoint */
@@ -450,6 +556,11 @@ interface ControlParameter {
     precision?: number;
     /** Current value */
     value: number | string | boolean;
+    /**
+     * Maintenance force state for this parameter (#3607, R19). Absent or
+     * `active: false` means `value` is a real reading. See `ForcedState`.
+     */
+    forced?: ForcedState;
     /** Whether parameter is read-only */
     readOnly?: boolean;
     /** Parameter type */
@@ -758,6 +869,11 @@ interface TrendLineProps {
     color?: string;
     strokeWidth?: number;
     backgroundColor?: string;
+    /**
+     * True when `values` trends a maintenance force, not measured readings
+     * (#3607, R19). Renders a FORCED tag; the trend line itself is unchanged.
+     */
+    forced?: boolean;
 }
 interface CircularGaugeProps {
     value: number;
@@ -766,12 +882,27 @@ interface CircularGaugeProps {
     label: string;
     size?: number;
     color?: string;
+    /**
+     * True when `value` is a maintenance force, not a measured reading
+     * (#3607, R19). Source: the control program's Sts_SimulationActive flag.
+     */
+    forced?: boolean;
+    /**
+     * The real, unforced value, shown beside `value` when `forced` is true.
+     * Optional; absent until the backend publishes it (unit U3b).
+     */
+    realValue?: number;
 }
 interface SparklineProps {
     data: number[];
     width: number;
     height: number;
     color: string;
+    /**
+     * True when `data` trends a maintenance force, not measured readings
+     * (#3607, R19). Renders a FORCED tag; the trend line itself is unchanged.
+     */
+    forced?: boolean;
 }
 interface EquipmentIndicatorWithSparklineProps {
     svgX: number;
@@ -784,6 +915,13 @@ interface EquipmentIndicatorWithSparklineProps {
         x: number;
         y: number;
     };
+    /**
+     * True when this equipment's state is a maintenance force, not a measured
+     * reading (#3607, R19). Renders a small glyph badge, never a color
+     * change: this indicator's whole signal is color plus a short label
+     * today, and color alone fails a colorblind operator.
+     */
+    forced?: boolean;
 }
 interface EquipmentIndicatorProps {
     svgX: number;
@@ -793,6 +931,12 @@ interface EquipmentIndicatorProps {
     size?: number;
     style?: react__default.CSSProperties;
     className?: string;
+    /**
+     * True when this equipment's state is a maintenance force, not a measured
+     * reading (#3607, R19). Renders a small glyph badge, never a color
+     * change. See EquipmentIndicatorWithSparklineProps.forced.
+     */
+    forced?: boolean;
 }
 interface FullscreenWorkspaceTab {
     label: string;
@@ -954,11 +1098,11 @@ declare const CardUnit: _emotion_styled.StyledComponent<{
     as?: React.ElementType;
 }, react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;
 
-declare const TrendLine: ({ values, width, height, color, strokeWidth, backgroundColor, }: TrendLineProps) => react.JSX.Element;
-declare const CircularGauge: ({ value, max, unit, label, size, color, }: CircularGaugeProps) => react.JSX.Element;
-declare const Sparkline: ({ data, width, height, color }: SparklineProps) => react.JSX.Element | null;
-declare const EquipmentIndicatorWithSparkline: ({ svgX, svgY, color, label, size, sparklineData, sparklineOffset, }: EquipmentIndicatorWithSparklineProps) => react.JSX.Element;
-declare const EquipmentIndicator: ({ svgX, svgY, color, label, size, style, className, }: EquipmentIndicatorProps) => react.JSX.Element;
+declare const TrendLine: ({ values, width, height, color, strokeWidth, backgroundColor, forced, }: TrendLineProps) => react.JSX.Element;
+declare const CircularGauge: ({ value, max, unit, label, size, color, forced, realValue, }: CircularGaugeProps) => react.JSX.Element;
+declare const Sparkline: ({ data, width, height, color, forced }: SparklineProps) => react.JSX.Element | null;
+declare const EquipmentIndicatorWithSparkline: ({ svgX, svgY, color, label, size, sparklineData, sparklineOffset, forced, }: EquipmentIndicatorWithSparklineProps) => react.JSX.Element;
+declare const EquipmentIndicator: ({ svgX, svgY, color, label, size, style, className, forced, }: EquipmentIndicatorProps) => react.JSX.Element;
 
 declare function FullscreenWorkspace({ svgContent, overlays, leftPanel, rightPanel, footer, tabs, activeTab, onTabChange, defaultLeftCollapsed, defaultRightCollapsed, leftCollapsed: leftCollapsedProp, rightCollapsed: rightCollapsedProp, onLeftCollapseChange, onRightCollapseChange, displayMode, defaultDisplayMode, onDisplayModeChange, showDisplayModeToggle, showZoomControls, onZoomIn, onZoomOut, onResetZoom, zoomDisabled, className, ...rest }: FullscreenWorkspaceProps): react__default.ReactElement;
 
@@ -1018,6 +1162,17 @@ type StatusColorMap = Partial<Record<DeviceStatus, Partial<StatusColorEntry>>>;
  * - stopping: amber (transitional)
  */
 declare const DEFAULT_STATUS_COLORS: Record<DeviceStatus, StatusColorEntry>;
+/**
+ * Maintenance-force marking color (#3607, R19). Deliberately outside
+ * DEFAULT_STATUS_COLORS: a forced value is not a health status, and must
+ * never share a color with warning/alarm/fault or read as one of them.
+ * Violet is unused elsewhere in this palette.
+ *
+ * Light fill + dark text, not a solid vivid chip: reads as a calm marker
+ * rather than an alarm sticker, while the vivid `border` shade still
+ * outlines a forced value's box/ring so it stays findable at a glance.
+ */
+declare const FORCED_MARK_COLOR: StatusColorEntry;
 /**
  * Resolve a status string to a full color entry.
  *
@@ -1730,6 +1885,15 @@ interface ConfigParameter {
     type: 'number' | 'string' | 'boolean' | 'select' | 'multiselect';
     /** Current value */
     value: any;
+    /**
+     * Maintenance force state for this parameter (#3607, R19). A field the
+     * operator has not overridden falls back to control's live value (the
+     * pilet's own DashboardScreen does this on every config refresh), so
+     * `value` here can be a live, forced reading, not only a static setting.
+     * Absent or `active: false` means `value` is a real reading or a real
+     * saved setting. See `ForcedState`.
+     */
+    forced?: ForcedState;
     /** Default value */
     defaultValue?: any;
     /** Whether parameter is read-only */
@@ -2058,4 +2222,4 @@ interface SimulationOptions {
  */
 declare function useSimulation(telemetry: TelemetryMap, updateTelemetryBatch: (updates: Array<any>) => void, options?: SimulationOptions): void;
 
-export { type AnchorType, Button, type ButtonProps, CardHeader, CardUnit, CardValue, CircularGauge, type CircularGaugeProps, type CommandKind, type ConfigActions, type ConfigDisplay, type ConfigParameter, type ConfigSection, type ConfigState, type ConfigTheme, type ControlCapabilities, type ControlMode, ControlPanel, type ControlPanelProps, type ControlParameter, type ControlState, type CustomAction, DEFAULT_STATUS_COLORS, DEFAULT_THRESHOLDS, DashboardCard, type DataBinding, type DeviceConfigBinding, type DeviceConfigMap, DeviceConfigPanel, type DeviceConfigPanelProps, type DeviceControlBinding, type DeviceControlMap, DeviceControlPanel, type DeviceControlPanelProps, type DeviceStatus, type Diagram, type DiagramMetadata, type DisplayMode, DisplayModeToggle, type DragPoint, type DragState, EquipmentIndicator, type EquipmentIndicatorProps, EquipmentIndicatorWithSparkline, type EquipmentIndicatorWithSparklineProps, FixedSVGContainer, FooterPanel, FullscreenContainer, FullscreenWorkspace, type FullscreenWorkspaceProps, type FullscreenWorkspaceTab, type KeyboardShortcutsOptions, LeftPanel, LeftToggleButton, LegacyValueEntry, type LegacyValueEntryProps, type ModeConfig, NodeConfigPanel, type NodeConfigPanelProps, type NodeControlConfig, NodeControlsPanel, type NodeControlsPanelProps, type NodeInstance, NumpadDialog, type NumpadDialogProps, type Overlay, type OverlayContent, type OverlayTheme, type OverlayType, PIDCanvas, type PIDCanvasControls, type PIDCanvasFeatures, type PIDCanvasProps, PanelContent, PanelTabs, type PipeEdge, type PipeStyle, type Point, type PortDefinition, type PortInstance, type PortType, RightPanel, RightToggleButton, SVGArea, SVGLockedOverlay, type SVGLockedOverlayProps, type ScalingMetadata, ScrollableSVGWrapper, type SelectionState, Selector, type SelectorOption, type SelectorProps, type SimulationOptions, Sparkline, type SparklineProps, type StatusColorEntry, type StatusColorMap, StatusIndicator, type StatusIndicatorProps, type SymbolCategory, type SymbolDefinition, SymbolLibrary, type SymbolLibraryProps, type SymbolMetadata, type TelemetryBinding, type TelemetryMap, type TelemetryStatus$1 as TelemetryStatus, type TelemetryValue, ThemeProvider, ThemeToggle, type ThemeToggleProps, type Thresholds, type Transform, TrendLine, type TrendLineProps, type UseDeviceControlsOptions, type UseDragOptions, type UseDragResult, type UseSelectionOptions, type UseSelectionResult, type UseTelemetryOptions, type UseTelemetryResult, type UseTelemetryStatusOptions, type UseViewBoxOptions, type UseViewBoxResult, ValueEntry, type ValueEntryProps, type ViewBox, ZoomButton, ZoomControls, calculateThresholdStatus, createConfigBinding, createControlBinding, exampleDiagram, exportDiagram, generateRoutePoints, getAvailableSymbols, getPortWorldPosition, getSymbolDefinition, importDiagram, mockSymbolLibrary, nodeHasPort, overlayStyles, registerSymbol, registerSymbols, resolveStatusColor, useDeviceConfigs, useDeviceControls, useDrag, useKeyboardShortcuts, useSelection, useSimulation, useTelemetry, useTelemetryStatus, useTheme, useViewBox, validateDiagram };
+export { type AnchorType, Button, type ButtonProps, CardHeader, CardUnit, CardValue, CircularGauge, type CircularGaugeProps, type CommandKind, type ConfigActions, type ConfigDisplay, type ConfigParameter, type ConfigSection, type ConfigState, type ConfigTheme, type ControlCapabilities, type ControlMode, ControlPanel, type ControlPanelProps, type ControlParameter, type ControlState, type CustomAction, DEFAULT_STATUS_COLORS, DEFAULT_THRESHOLDS, DashboardCard, type DataBinding, type DeviceConfigBinding, type DeviceConfigMap, DeviceConfigPanel, type DeviceConfigPanelProps, type DeviceControlBinding, type DeviceControlMap, DeviceControlPanel, type DeviceControlPanelProps, type DeviceStatus, type Diagram, type DiagramMetadata, type DisplayMode, DisplayModeToggle, type DragPoint, type DragState, EquipmentIndicator, type EquipmentIndicatorProps, EquipmentIndicatorWithSparkline, type EquipmentIndicatorWithSparklineProps, FORCED_MARK_COLOR, FixedSVGContainer, FooterPanel, type ForcedState, FullscreenContainer, FullscreenWorkspace, type FullscreenWorkspaceProps, type FullscreenWorkspaceTab, type KeyboardShortcutsOptions, LeftPanel, LeftToggleButton, LegacyValueEntry, type LegacyValueEntryProps, type ModeConfig, NodeConfigPanel, type NodeConfigPanelProps, type NodeControlConfig, NodeControlsPanel, type NodeControlsPanelProps, type NodeInstance, NumpadDialog, type NumpadDialogProps, type Overlay, type OverlayContent, type OverlayTheme, type OverlayType, PIDCanvas, type PIDCanvasControls, type PIDCanvasFeatures, type PIDCanvasProps, PanelContent, PanelTabs, type PipeEdge, type PipeStyle, type Point, type PortDefinition, type PortInstance, type PortType, RightPanel, RightToggleButton, SVGArea, SVGLockedOverlay, type SVGLockedOverlayProps, type ScalingMetadata, ScrollableSVGWrapper, type SelectionState, Selector, type SelectorOption, type SelectorProps, type SimulationOptions, Sparkline, type SparklineProps, type StatusColorEntry, type StatusColorMap, StatusIndicator, type StatusIndicatorProps, type SymbolCategory, type SymbolDefinition, SymbolLibrary, type SymbolLibraryProps, type SymbolMetadata, type TelemetryBinding, type TelemetryMap, type TelemetryStatus$1 as TelemetryStatus, type TelemetryValue, ThemeProvider, ThemeToggle, type ThemeToggleProps, type Thresholds, type Transform, TrendLine, type TrendLineProps, type UseDeviceControlsOptions, type UseDragOptions, type UseDragResult, type UseSelectionOptions, type UseSelectionResult, type UseTelemetryOptions, type UseTelemetryResult, type UseTelemetryStatusOptions, type UseViewBoxOptions, type UseViewBoxResult, ValueEntry, type ValueEntryProps, type ViewBox, ZoomButton, ZoomControls, calculateThresholdStatus, createConfigBinding, createControlBinding, exampleDiagram, exportDiagram, generateRoutePoints, getAvailableSymbols, getPortWorldPosition, getSymbolDefinition, importDiagram, mockSymbolLibrary, nodeHasPort, overlayStyles, registerSymbol, registerSymbols, resolveStatusColor, useDeviceConfigs, useDeviceControls, useDrag, useKeyboardShortcuts, useSelection, useSimulation, useTelemetry, useTelemetryStatus, useTheme, useViewBox, validateDiagram };

package/dist/index.d.ts

@@ -48,6 +48,38 @@ declare const Selector: react__default.FC<SelectorProps>;
  * Status levels for telemetry values
  */
 type TelemetryStatus$1 = 'normal' | 'warning' | 'alarm' | 'fault' | 'off';
+/**
+ * Marks a value as a maintenance force rather than a measured reading
+ * (alphinity-tffi issue #3607, unit U11). A forced value is a deliberate
+ * substitution at the instrument, so a surface that shows it must show
+ * `active` and, when known, the real value beside it. Never render `active`
+ * as a `TelemetryStatus` color; forced and alarm/warning/fault are
+ * independent facts about the same reading.
+ */
+interface ForcedState {
+    /** True while the tag carries an active maintenance force. Source: the control program's Sts_SimulationActive flag. */
+    active: boolean;
+    /**
+     * The real, unforced value, in the same unit as the primary value.
+     * Optional: the backend does not publish this yet for every tag kind
+     * (alphinity-tffi unit U3b). Render the forced mark alone when this is
+     * absent; never show a placeholder in its place.
+     *
+     * Covers both directions this feature forces, and the two read
+     * differently even though the field is the same:
+     * - Forced INPUT (a transmitter): the real, currently measured value.
+     * - Forced OUTPUT (a valve, a lamp, a commanded position): the value the
+     *   control system would be commanding right now if the force were not
+     *   active. Not the feedback tag. XV valve position feedback (ZSC/ZSO) is
+     *   synthesized from the commanded position, not sensed by a physical
+     *   limit switch (alphinity-tffi #774, a permanent design choice), and
+     *   pump feedback reaches the bus but nothing consumes it as a position.
+     *   Showing either as "real" would present a derived number as measured -
+     *   the exact confidently-wrong display this feature exists to prevent.
+     *   A commanded value, honestly labeled, is the only real answer here.
+     */
+    realValue?: number | string | boolean;
+}
 /**
  * Live telemetry value with status
  */
@@ -98,6 +130,11 @@ interface TelemetryBinding {
     tag: string;
     /** Current telemetry value */
     value: TelemetryValue;
+    /**
+     * Maintenance force state (#3607, R19). Absent or `active: false` means
+     * the value is a real reading; render nothing extra. See `ForcedState`.
+     */
+    forced?: ForcedState;
     /**
      * Uniform scaling / EU metadata (units, range, precision). When present it is
      * the authoritative source for the displayed units, decimal precision, and
@@ -197,10 +234,34 @@ interface ControlPanelProps extends react__default.HTMLAttributes<HTMLDivElement
     modeOptions: SelectorOption[];
     /** Callback when mode changes */
     onModeChange: (mode: string) => void;
-    /** Current setpoint value */
+    /** Typed/target setpoint value (editable) */
     setpointValue: number | string;
     /** Callback when setpoint changes */
     onSetpointChange: (value: number | string) => void;
+    /**
+     * The setpoint the control loop is currently running: read-only feedback
+     * from live telemetry, shown beside the typed setpoint above so an
+     * operator sees target and current separately (the typed field never
+     * "snaps back" to reflect the live value).
+     *
+     * Optional and hidden by default: the caller decides when a live-feedback
+     * row is worth showing, since always showing a normally-differing current
+     * value can read as a fault when none exists. When this tag carries a
+     * maintenance force, the caller MUST pass this prop at that time - a
+     * hidden value shows nothing, forced or not, but a shown value must carry
+     * its FORCED mark (#3607, R19).
+     */
+    currentSetpointValue?: number | string;
+    /**
+     * True when `currentSetpointValue` is a maintenance force, not a measured
+     * reading. Ignored when `currentSetpointValue` is not provided.
+     */
+    currentSetpointForced?: boolean;
+    /**
+     * The real, unforced value for `currentSetpointValue`. Optional; absent
+     * until the backend publishes it (alphinity-tffi unit U3b).
+     */
+    currentSetpointRealValue?: number | string;
     /** Current second setpoint value (for ramp mode, etc.) */
     secondSetpointValue?: number | string;
     /** Callback when second setpoint changes */
@@ -266,6 +327,22 @@ interface StatusIndicatorProps extends react__default.HTMLAttributes<HTMLDivElem
     shape?: 'circle' | 'square' | 'diamond';
     /** Whether the indicator should have a 3D LED effect */
     led?: boolean;
+    /**
+     * True when the underlying tag's state is a maintenance force, not a
+     * measured reading (#3607, R19). Renders a small glyph badge, never a
+     * color change: this indicator's whole signal is color plus a short
+     * label today, and color alone fails a colorblind operator.
+     */
+    forced?: boolean;
+    /**
+     * The real, unforced state, shown as text beside `label` when `forced`
+     * is true. For a forced discrete OUTPUT (a lamp, a valve OPEN/CLOSED
+     * indicator - R2), this is the state the system would command if the
+     * force were not active, not a second physical reading. Optional:
+     * absent until the backend publishes it. When absent, only the forced
+     * glyph badge renders.
+     */
+    realValue?: string;
 }
 declare const StatusIndicator: react__default.FC<StatusIndicatorProps>;
 
@@ -290,6 +367,19 @@ interface ValueEntryProps extends Omit<react__default.InputHTMLAttributes<HTMLIn
     label?: string;
     /** Whether the input is read-only */
     readOnly?: boolean;
+    /**
+     * True when `value` is a maintenance force, not a measured reading
+     * (#3607, R19). Source: the control program's Sts_SimulationActive flag.
+     * Renders a FORCED badge; never changes `status`, which stays an
+     * independent fact about the same reading.
+     */
+    forced?: boolean;
+    /**
+     * The real, unforced value, shown beside `value` when `forced` is true.
+     * Optional: the backend does not publish this for every tag kind yet
+     * (alphinity-tffi unit U3b). When absent, only the FORCED badge renders.
+     */
+    realValue?: number | string;
 }
 declare const ValueEntry: react__default.FC<ValueEntryProps>;
 
@@ -314,6 +404,16 @@ interface LegacyValueEntryProps extends Omit<react__default.InputHTMLAttributes<
     label?: string;
     /** Whether the input is read-only */
     readOnly?: boolean;
+    /**
+     * True when `value` is a maintenance force, not a measured reading
+     * (#3607, R19). Renders a FORCED badge; never changes `status`.
+     */
+    forced?: boolean;
+    /**
+     * The real, unforced value, shown beside `value` when `forced` is true.
+     * Optional; absent until the backend publishes it (unit U3b).
+     */
+    realValue?: number | string;
 }
 declare const LegacyValueEntry: react__default.FC<LegacyValueEntryProps>;
 
@@ -328,10 +428,16 @@ interface NodeControlConfig {
     currentMode: string;
     /** Callback when mode changes */
     onModeChange: (mode: string) => void;
-    /** Current setpoint value */
+    /** Typed/target setpoint value (editable) */
     setpoint: number | string;
     /** Callback when setpoint changes */
     onSetpointChange: (value: number | string) => void;
+    /** Current setpoint: read-only feedback from live telemetry. See ControlPanelProps.currentSetpointValue. */
+    currentSetpoint?: number | string;
+    /** True when `currentSetpoint` is a maintenance force, not a measured reading. */
+    currentSetpointForced?: boolean;
+    /** The real, unforced value for `currentSetpoint`. Optional; absent until the backend publishes it. */
+    currentSetpointRealValue?: number | string;
     /** Optional second setpoint value */
     secondSetpoint?: number | string;
     /** Callback for second setpoint */
@@ -450,6 +556,11 @@ interface ControlParameter {
     precision?: number;
     /** Current value */
     value: number | string | boolean;
+    /**
+     * Maintenance force state for this parameter (#3607, R19). Absent or
+     * `active: false` means `value` is a real reading. See `ForcedState`.
+     */
+    forced?: ForcedState;
     /** Whether parameter is read-only */
     readOnly?: boolean;
     /** Parameter type */
@@ -758,6 +869,11 @@ interface TrendLineProps {
     color?: string;
     strokeWidth?: number;
     backgroundColor?: string;
+    /**
+     * True when `values` trends a maintenance force, not measured readings
+     * (#3607, R19). Renders a FORCED tag; the trend line itself is unchanged.
+     */
+    forced?: boolean;
 }
 interface CircularGaugeProps {
     value: number;
@@ -766,12 +882,27 @@ interface CircularGaugeProps {
     label: string;
     size?: number;
     color?: string;
+    /**
+     * True when `value` is a maintenance force, not a measured reading
+     * (#3607, R19). Source: the control program's Sts_SimulationActive flag.
+     */
+    forced?: boolean;
+    /**
+     * The real, unforced value, shown beside `value` when `forced` is true.
+     * Optional; absent until the backend publishes it (unit U3b).
+     */
+    realValue?: number;
 }
 interface SparklineProps {
     data: number[];
     width: number;
     height: number;
     color: string;
+    /**
+     * True when `data` trends a maintenance force, not measured readings
+     * (#3607, R19). Renders a FORCED tag; the trend line itself is unchanged.
+     */
+    forced?: boolean;
 }
 interface EquipmentIndicatorWithSparklineProps {
     svgX: number;
@@ -784,6 +915,13 @@ interface EquipmentIndicatorWithSparklineProps {
         x: number;
         y: number;
     };
+    /**
+     * True when this equipment's state is a maintenance force, not a measured
+     * reading (#3607, R19). Renders a small glyph badge, never a color
+     * change: this indicator's whole signal is color plus a short label
+     * today, and color alone fails a colorblind operator.
+     */
+    forced?: boolean;
 }
 interface EquipmentIndicatorProps {
     svgX: number;
@@ -793,6 +931,12 @@ interface EquipmentIndicatorProps {
     size?: number;
     style?: react__default.CSSProperties;
     className?: string;
+    /**
+     * True when this equipment's state is a maintenance force, not a measured
+     * reading (#3607, R19). Renders a small glyph badge, never a color
+     * change. See EquipmentIndicatorWithSparklineProps.forced.
+     */
+    forced?: boolean;
 }
 interface FullscreenWorkspaceTab {
     label: string;
@@ -954,11 +1098,11 @@ declare const CardUnit: _emotion_styled.StyledComponent<{
     as?: React.ElementType;
 }, react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;
 
-declare const TrendLine: ({ values, width, height, color, strokeWidth, backgroundColor, }: TrendLineProps) => react.JSX.Element;
-declare const CircularGauge: ({ value, max, unit, label, size, color, }: CircularGaugeProps) => react.JSX.Element;
-declare const Sparkline: ({ data, width, height, color }: SparklineProps) => react.JSX.Element | null;
-declare const EquipmentIndicatorWithSparkline: ({ svgX, svgY, color, label, size, sparklineData, sparklineOffset, }: EquipmentIndicatorWithSparklineProps) => react.JSX.Element;
-declare const EquipmentIndicator: ({ svgX, svgY, color, label, size, style, className, }: EquipmentIndicatorProps) => react.JSX.Element;
+declare const TrendLine: ({ values, width, height, color, strokeWidth, backgroundColor, forced, }: TrendLineProps) => react.JSX.Element;
+declare const CircularGauge: ({ value, max, unit, label, size, color, forced, realValue, }: CircularGaugeProps) => react.JSX.Element;
+declare const Sparkline: ({ data, width, height, color, forced }: SparklineProps) => react.JSX.Element | null;
+declare const EquipmentIndicatorWithSparkline: ({ svgX, svgY, color, label, size, sparklineData, sparklineOffset, forced, }: EquipmentIndicatorWithSparklineProps) => react.JSX.Element;
+declare const EquipmentIndicator: ({ svgX, svgY, color, label, size, style, className, forced, }: EquipmentIndicatorProps) => react.JSX.Element;
 
 declare function FullscreenWorkspace({ svgContent, overlays, leftPanel, rightPanel, footer, tabs, activeTab, onTabChange, defaultLeftCollapsed, defaultRightCollapsed, leftCollapsed: leftCollapsedProp, rightCollapsed: rightCollapsedProp, onLeftCollapseChange, onRightCollapseChange, displayMode, defaultDisplayMode, onDisplayModeChange, showDisplayModeToggle, showZoomControls, onZoomIn, onZoomOut, onResetZoom, zoomDisabled, className, ...rest }: FullscreenWorkspaceProps): react__default.ReactElement;
 
@@ -1018,6 +1162,17 @@ type StatusColorMap = Partial<Record<DeviceStatus, Partial<StatusColorEntry>>>;
  * - stopping: amber (transitional)
  */
 declare const DEFAULT_STATUS_COLORS: Record<DeviceStatus, StatusColorEntry>;
+/**
+ * Maintenance-force marking color (#3607, R19). Deliberately outside
+ * DEFAULT_STATUS_COLORS: a forced value is not a health status, and must
+ * never share a color with warning/alarm/fault or read as one of them.
+ * Violet is unused elsewhere in this palette.
+ *
+ * Light fill + dark text, not a solid vivid chip: reads as a calm marker
+ * rather than an alarm sticker, while the vivid `border` shade still
+ * outlines a forced value's box/ring so it stays findable at a glance.
+ */
+declare const FORCED_MARK_COLOR: StatusColorEntry;
 /**
  * Resolve a status string to a full color entry.
  *
@@ -1730,6 +1885,15 @@ interface ConfigParameter {
     type: 'number' | 'string' | 'boolean' | 'select' | 'multiselect';
     /** Current value */
     value: any;
+    /**
+     * Maintenance force state for this parameter (#3607, R19). A field the
+     * operator has not overridden falls back to control's live value (the
+     * pilet's own DashboardScreen does this on every config refresh), so
+     * `value` here can be a live, forced reading, not only a static setting.
+     * Absent or `active: false` means `value` is a real reading or a real
+     * saved setting. See `ForcedState`.
+     */
+    forced?: ForcedState;
     /** Default value */
     defaultValue?: any;
     /** Whether parameter is read-only */
@@ -2058,4 +2222,4 @@ interface SimulationOptions {
  */
 declare function useSimulation(telemetry: TelemetryMap, updateTelemetryBatch: (updates: Array<any>) => void, options?: SimulationOptions): void;
 
-export { type AnchorType, Button, type ButtonProps, CardHeader, CardUnit, CardValue, CircularGauge, type CircularGaugeProps, type CommandKind, type ConfigActions, type ConfigDisplay, type ConfigParameter, type ConfigSection, type ConfigState, type ConfigTheme, type ControlCapabilities, type ControlMode, ControlPanel, type ControlPanelProps, type ControlParameter, type ControlState, type CustomAction, DEFAULT_STATUS_COLORS, DEFAULT_THRESHOLDS, DashboardCard, type DataBinding, type DeviceConfigBinding, type DeviceConfigMap, DeviceConfigPanel, type DeviceConfigPanelProps, type DeviceControlBinding, type DeviceControlMap, DeviceControlPanel, type DeviceControlPanelProps, type DeviceStatus, type Diagram, type DiagramMetadata, type DisplayMode, DisplayModeToggle, type DragPoint, type DragState, EquipmentIndicator, type EquipmentIndicatorProps, EquipmentIndicatorWithSparkline, type EquipmentIndicatorWithSparklineProps, FixedSVGContainer, FooterPanel, FullscreenContainer, FullscreenWorkspace, type FullscreenWorkspaceProps, type FullscreenWorkspaceTab, type KeyboardShortcutsOptions, LeftPanel, LeftToggleButton, LegacyValueEntry, type LegacyValueEntryProps, type ModeConfig, NodeConfigPanel, type NodeConfigPanelProps, type NodeControlConfig, NodeControlsPanel, type NodeControlsPanelProps, type NodeInstance, NumpadDialog, type NumpadDialogProps, type Overlay, type OverlayContent, type OverlayTheme, type OverlayType, PIDCanvas, type PIDCanvasControls, type PIDCanvasFeatures, type PIDCanvasProps, PanelContent, PanelTabs, type PipeEdge, type PipeStyle, type Point, type PortDefinition, type PortInstance, type PortType, RightPanel, RightToggleButton, SVGArea, SVGLockedOverlay, type SVGLockedOverlayProps, type ScalingMetadata, ScrollableSVGWrapper, type SelectionState, Selector, type SelectorOption, type SelectorProps, type SimulationOptions, Sparkline, type SparklineProps, type StatusColorEntry, type StatusColorMap, StatusIndicator, type StatusIndicatorProps, type SymbolCategory, type SymbolDefinition, SymbolLibrary, type SymbolLibraryProps, type SymbolMetadata, type TelemetryBinding, type TelemetryMap, type TelemetryStatus$1 as TelemetryStatus, type TelemetryValue, ThemeProvider, ThemeToggle, type ThemeToggleProps, type Thresholds, type Transform, TrendLine, type TrendLineProps, type UseDeviceControlsOptions, type UseDragOptions, type UseDragResult, type UseSelectionOptions, type UseSelectionResult, type UseTelemetryOptions, type UseTelemetryResult, type UseTelemetryStatusOptions, type UseViewBoxOptions, type UseViewBoxResult, ValueEntry, type ValueEntryProps, type ViewBox, ZoomButton, ZoomControls, calculateThresholdStatus, createConfigBinding, createControlBinding, exampleDiagram, exportDiagram, generateRoutePoints, getAvailableSymbols, getPortWorldPosition, getSymbolDefinition, importDiagram, mockSymbolLibrary, nodeHasPort, overlayStyles, registerSymbol, registerSymbols, resolveStatusColor, useDeviceConfigs, useDeviceControls, useDrag, useKeyboardShortcuts, useSelection, useSimulation, useTelemetry, useTelemetryStatus, useTheme, useViewBox, validateDiagram };
+export { type AnchorType, Button, type ButtonProps, CardHeader, CardUnit, CardValue, CircularGauge, type CircularGaugeProps, type CommandKind, type ConfigActions, type ConfigDisplay, type ConfigParameter, type ConfigSection, type ConfigState, type ConfigTheme, type ControlCapabilities, type ControlMode, ControlPanel, type ControlPanelProps, type ControlParameter, type ControlState, type CustomAction, DEFAULT_STATUS_COLORS, DEFAULT_THRESHOLDS, DashboardCard, type DataBinding, type DeviceConfigBinding, type DeviceConfigMap, DeviceConfigPanel, type DeviceConfigPanelProps, type DeviceControlBinding, type DeviceControlMap, DeviceControlPanel, type DeviceControlPanelProps, type DeviceStatus, type Diagram, type DiagramMetadata, type DisplayMode, DisplayModeToggle, type DragPoint, type DragState, EquipmentIndicator, type EquipmentIndicatorProps, EquipmentIndicatorWithSparkline, type EquipmentIndicatorWithSparklineProps, FORCED_MARK_COLOR, FixedSVGContainer, FooterPanel, type ForcedState, FullscreenContainer, FullscreenWorkspace, type FullscreenWorkspaceProps, type FullscreenWorkspaceTab, type KeyboardShortcutsOptions, LeftPanel, LeftToggleButton, LegacyValueEntry, type LegacyValueEntryProps, type ModeConfig, NodeConfigPanel, type NodeConfigPanelProps, type NodeControlConfig, NodeControlsPanel, type NodeControlsPanelProps, type NodeInstance, NumpadDialog, type NumpadDialogProps, type Overlay, type OverlayContent, type OverlayTheme, type OverlayType, PIDCanvas, type PIDCanvasControls, type PIDCanvasFeatures, type PIDCanvasProps, PanelContent, PanelTabs, type PipeEdge, type PipeStyle, type Point, type PortDefinition, type PortInstance, type PortType, RightPanel, RightToggleButton, SVGArea, SVGLockedOverlay, type SVGLockedOverlayProps, type ScalingMetadata, ScrollableSVGWrapper, type SelectionState, Selector, type SelectorOption, type SelectorProps, type SimulationOptions, Sparkline, type SparklineProps, type StatusColorEntry, type StatusColorMap, StatusIndicator, type StatusIndicatorProps, type SymbolCategory, type SymbolDefinition, SymbolLibrary, type SymbolLibraryProps, type SymbolMetadata, type TelemetryBinding, type TelemetryMap, type TelemetryStatus$1 as TelemetryStatus, type TelemetryValue, ThemeProvider, ThemeToggle, type ThemeToggleProps, type Thresholds, type Transform, TrendLine, type TrendLineProps, type UseDeviceControlsOptions, type UseDragOptions, type UseDragResult, type UseSelectionOptions, type UseSelectionResult, type UseTelemetryOptions, type UseTelemetryResult, type UseTelemetryStatusOptions, type UseViewBoxOptions, type UseViewBoxResult, ValueEntry, type ValueEntryProps, type ViewBox, ZoomButton, ZoomControls, calculateThresholdStatus, createConfigBinding, createControlBinding, exampleDiagram, exportDiagram, generateRoutePoints, getAvailableSymbols, getPortWorldPosition, getSymbolDefinition, importDiagram, mockSymbolLibrary, nodeHasPort, overlayStyles, registerSymbol, registerSymbols, resolveStatusColor, useDeviceConfigs, useDeviceControls, useDrag, useKeyboardShortcuts, useSelection, useSimulation, useTelemetry, useTelemetryStatus, useTheme, useViewBox, validateDiagram };