@procaaso/alphinity-ui-components 1.9.0 → 1.11.0

package/dist/index.js

@@ -174,6 +174,8 @@ var ValueEntry = ({
   inputType = "numeric",
   label,
   readOnly = false,
+  forced = false,
+  realValue,
   className = "",
   disabled,
   ...props
@@ -224,9 +226,14 @@ var ValueEntry = ({
   const unitClass = unit ? "ui-value-entry--with-unit" : "";
   const currentStatus = disabled || readOnly ? "disabled" : status;
   const statusVariantClass = currentStatus ? `ui-value-entry--${currentStatus}` : "";
+  const forcedClass = forced ? "ui-value-entry--forced" : "";
+  const hasRealValue = forced && realValue !== void 0;
   const displayText = isEditing ? displayValue : inputType === "numeric" ? Number(value).toFixed(precision) : String(value);
   return /* @__PURE__ */ jsxs2("div", { className: "ui-value-entry-container", children: [
-    label && /* @__PURE__ */ jsx3("label", { className: "ui-value-entry-label", children: label }),
+    label && /* @__PURE__ */ jsxs2("label", { className: "ui-value-entry-label", children: [
+      label,
+      forced && /* @__PURE__ */ jsx3("span", { className: "ui-value-entry-forced-badge", "aria-label": "Forced", children: "F" })
+    ] }),
     /* @__PURE__ */ jsxs2("div", { className: "ui-value-entry-wrapper", children: [
       /* @__PURE__ */ jsx3(
         "input",
@@ -239,19 +246,71 @@ var ValueEntry = ({
           onKeyDown: handleKeyDown,
           disabled,
           readOnly,
-          className: `${baseClass} ${statusVariantClass} ${unitClass} ${className}`.trim(),
+          className: `${baseClass} ${statusVariantClass} ${forcedClass} ${unitClass} ${className}`.trim(),
           ...props
         }
       ),
       unit && /* @__PURE__ */ jsx3("span", { className: "ui-value-entry-unit", children: unit }),
       status === "alarm" && /* @__PURE__ */ jsx3("div", { className: "ui-value-entry-badge ui-value-entry-badge--alarm" }),
-      status === "warning" && /* @__PURE__ */ jsx3("div", { className: "ui-value-entry-badge ui-value-entry-badge--warning" })
+      status === "warning" && /* @__PURE__ */ jsx3("div", { className: "ui-value-entry-badge ui-value-entry-badge--warning" }),
+      !label && forced && /* @__PURE__ */ jsx3("span", { className: "ui-value-entry-forced-badge", "aria-label": "Forced", children: "F" })
+    ] }),
+    hasRealValue && /* @__PURE__ */ jsxs2("div", { className: "ui-value-entry-real-value", children: [
+      "REAL ",
+      String(realValue),
+      unit ? ` ${unit}` : ""
     ] })
   ] });
 };
 
 // src/components/ValueEntry/LegacyValueEntry.tsx
 import { useState as useState3, useCallback as useCallback2 } from "react";
+
+// src/theme/statusColors.ts
+var DEFAULT_STATUS_COLORS = {
+  normal: { fill: "#888888", stroke: "#6b6b6b", bg: "#888888", text: "#ffffff", border: "#6b6b6b" },
+  warning: { fill: "#f59e0b", stroke: "#d97706", bg: "#FFD700", text: "#000000", border: "#d97706" },
+  alarm: { fill: "#ef4444", stroke: "#dc2626", bg: "#FF0000", text: "#ffffff", border: "#dc2626" },
+  fault: { fill: "#dc2626", stroke: "#b91c1c", bg: "#FF0000", text: "#ffffff", border: "#b91c1c" },
+  off: { fill: "#edeeef", stroke: "#000000", bg: "#666666", text: "#ffffff", border: "#4b5563" },
+  starting: { fill: "#90EE90", stroke: "#22c55e", bg: "#90EE90", text: "#000000", border: "#22c55e" },
+  stopping: { fill: "#FFD700", stroke: "#d97706", bg: "#FFD700", text: "#000000", border: "#d97706" }
+};
+var FORCED_MARK_COLOR = {
+  fill: "#ede9fe",
+  stroke: "#5b21b6",
+  bg: "#ede9fe",
+  text: "#5b21b6",
+  border: "#7c3aed"
+};
+var UNKNOWN_MARK_COLOR = {
+  fill: "#ebebf5",
+  stroke: "#8f8fc2",
+  bg: "#ebebf5",
+  text: "#4f4f8a",
+  border: "#8f8fc2"
+};
+var UNKNOWN_MARK_COLOR_DARK = {
+  fill: "#23263a",
+  stroke: "#6f74a3",
+  bg: "#23263a",
+  text: "#b9bbdb",
+  border: "#6f74a3"
+};
+var STATUS_ALIASES = {
+  running: "normal",
+  stopped: "off"
+};
+function resolveStatusColor(status, customMap) {
+  const raw = (status || "off").toLowerCase();
+  const key = STATUS_ALIASES[raw] ?? raw;
+  const defaults = DEFAULT_STATUS_COLORS[key] ?? DEFAULT_STATUS_COLORS.off;
+  const overrides = customMap?.[key];
+  if (!overrides) return defaults;
+  return { ...defaults, ...overrides };
+}
+
+// src/components/ValueEntry/LegacyValueEntry.tsx
 import { jsx as jsx4, jsxs as jsxs3 } from "react/jsx-runtime";
 var LegacyValueEntry = ({
   value,
@@ -264,6 +323,8 @@ var LegacyValueEntry = ({
   inputType = "numeric",
   label,
   readOnly = false,
+  forced = false,
+  realValue,
   className = "",
   disabled,
   ...props
@@ -344,6 +405,27 @@ var LegacyValueEntry = ({
     }
   };
   const statusStyles = getStatusStyles();
+  const forcedBadgeStyle = {
+    display: "inline-flex",
+    alignItems: "center",
+    justifyContent: "center",
+    width: "1.1rem",
+    height: "1.1rem",
+    fontSize: "0.7rem",
+    fontWeight: 700,
+    color: FORCED_MARK_COLOR.text,
+    backgroundColor: FORCED_MARK_COLOR.bg,
+    border: `1px solid ${FORCED_MARK_COLOR.border}`,
+    borderRadius: "50%",
+    marginLeft: "8px",
+    lineHeight: 1
+  };
+  const realValueStyle = {
+    fontSize: "0.75rem",
+    fontWeight: 500,
+    color: "#94a3b8",
+    letterSpacing: "0.02em"
+  };
   const inputStyle = {
     width: "12rem",
     height: "4rem",
@@ -392,17 +474,22 @@ var LegacyValueEntry = ({
         gap: "0.75rem"
       },
       children: [
-        label && /* @__PURE__ */ jsx4(
+        (label || forced) && /* @__PURE__ */ jsxs3(
           "label",
           {
             style: {
+              display: "flex",
+              alignItems: "center",
               fontSize: "0.875rem",
               fontWeight: "600",
               color: "#cbd5e1",
               textTransform: "uppercase",
               letterSpacing: "0.05em"
             },
-            children: label
+            children: [
+              label,
+              forced && /* @__PURE__ */ jsx4("span", { style: forcedBadgeStyle, "aria-label": "Forced", children: "F" })
+            ]
           }
         ),
         /* @__PURE__ */ jsxs3("div", { style: { position: "relative", display: "inline-flex", alignItems: "center" }, children: [
@@ -459,6 +546,11 @@ var LegacyValueEntry = ({
               }
             }
           )
+        ] }),
+        forced && realValue !== void 0 && /* @__PURE__ */ jsxs3("div", { style: realValueStyle, children: [
+          "REAL ",
+          String(realValue),
+          unit ? ` ${unit}` : ""
         ] })
       ]
     }
@@ -474,6 +566,9 @@ var ControlPanel = ({
   onModeChange,
   setpointValue,
   onSetpointChange,
+  currentSetpointValue,
+  currentSetpointForced = false,
+  currentSetpointRealValue,
   secondSetpointValue,
   onSecondSetpointChange,
   modeConfigs = {},
@@ -570,6 +665,21 @@ var ControlPanel = ({
               disabled: status === "disabled"
             }
           ) }),
+          currentSetpointValue !== void 0 && /* @__PURE__ */ jsx5("div", { children: /* @__PURE__ */ jsx5(
+            LegacyValueEntry,
+            {
+              value: currentSetpointValue,
+              onChange: () => {
+              },
+              label: `${currentLabel} (Current)`,
+              unit: currentUnit,
+              precision: currentPrecision,
+              status,
+              readOnly: true,
+              forced: currentSetpointForced,
+              realValue: currentSetpointRealValue
+            }
+          ) }),
           hasSecondSetpoint && onSecondSetpointChange && /* @__PURE__ */ jsx5("div", { children: /* @__PURE__ */ jsx5(
             LegacyValueEntry,
             {
@@ -660,9 +770,15 @@ var StatusIndicator = ({
   labelPosition = "right",
   shape = "circle",
   led = true,
+  visible = true,
+  forced = false,
+  realValue,
   className = "",
   ...props
 }) => {
+  if (!visible) {
+    return null;
+  }
   const baseClass = "ui-status-indicator";
   const statusClass = status ? `ui-status-indicator--${status}` : "";
   const sizeClass = size ? `ui-status-indicator--${size}` : "";
@@ -683,28 +799,43 @@ var StatusIndicator = ({
         return "ui-status-indicator-container ui-status-indicator-label-right";
     }
   };
+  const forcedClass = forced ? "ui-status-indicator--forced" : "";
+  const hasRealValue = forced && realValue !== void 0;
   return /* @__PURE__ */ jsxs5("span", { className: getContainerLayout(), children: [
     label && (labelPosition === "left" || labelPosition === "top") && /* @__PURE__ */ jsx6("span", { className: "ui-status-indicator-label", children: label }),
-    /* @__PURE__ */ jsx6(
-      "span",
-      {
-        role: "status",
-        "aria-label": label || `Status: ${status}`,
-        "aria-description": getStatusDescription(status),
-        "data-status": status,
-        className: `
-          ${baseClass}
-          ${statusClass}
-          ${sizeClass}
-          ${shapeClass}
-          ${animationClass}
-          ${ledClass}
-          ${className}
-        `.replace(/\s+/g, " ").trim(),
-        ...props
-      }
-    ),
-    label && (labelPosition === "right" || labelPosition === "bottom") && /* @__PURE__ */ jsx6("span", { className: "ui-status-indicator-label", children: label })
+    hasRealValue && (labelPosition === "left" || labelPosition === "top") && /* @__PURE__ */ jsxs5("span", { className: "ui-status-indicator-real-value", children: [
+      "REAL ",
+      realValue
+    ] }),
+    /* @__PURE__ */ jsxs5("span", { style: { position: "relative", display: "inline-flex" }, children: [
+      /* @__PURE__ */ jsx6(
+        "span",
+        {
+          role: "status",
+          "aria-label": label || `Status: ${status}`,
+          "aria-description": getStatusDescription(status),
+          "data-status": status,
+          "data-forced": forced,
+          className: `
+            ${baseClass}
+            ${statusClass}
+            ${sizeClass}
+            ${shapeClass}
+            ${animationClass}
+            ${ledClass}
+            ${forcedClass}
+            ${className}
+          `.replace(/\s+/g, " ").trim(),
+          ...props
+        }
+      ),
+      forced && /* @__PURE__ */ jsx6("span", { className: "ui-status-indicator-forced-badge", "aria-label": "Forced", children: "F" })
+    ] }),
+    label && (labelPosition === "right" || labelPosition === "bottom") && /* @__PURE__ */ jsx6("span", { className: "ui-status-indicator-label", children: label }),
+    hasRealValue && (labelPosition === "right" || labelPosition === "bottom") && /* @__PURE__ */ jsxs5("span", { className: "ui-status-indicator-real-value", children: [
+      "REAL ",
+      realValue
+    ] })
   ] });
 };
 
@@ -832,6 +963,9 @@ var NodeControlsPanel = ({
               onModeChange: config.onModeChange,
               setpointValue: config.setpoint,
               onSetpointChange: config.onSetpointChange,
+              currentSetpointValue: config.currentSetpoint,
+              currentSetpointForced: config.currentSetpointForced,
+              currentSetpointRealValue: config.currentSetpointRealValue,
               secondSetpointValue: config.secondSetpoint,
               onSecondSetpointChange: config.onSecondSetpointChange,
               modeConfigs: config.modeConfigs,
@@ -896,31 +1030,6 @@ var NodeControlsPanel = ({
 
 // src/components/DeviceControlPanel/DeviceControlPanel.tsx
 import React5, { useState as useState5, useEffect as useEffect2 } from "react";
-
-// src/theme/statusColors.ts
-var DEFAULT_STATUS_COLORS = {
-  normal: { fill: "#888888", stroke: "#6b6b6b", bg: "#888888", text: "#ffffff", border: "#6b6b6b" },
-  warning: { fill: "#f59e0b", stroke: "#d97706", bg: "#FFD700", text: "#000000", border: "#d97706" },
-  alarm: { fill: "#ef4444", stroke: "#dc2626", bg: "#FF0000", text: "#ffffff", border: "#dc2626" },
-  fault: { fill: "#dc2626", stroke: "#b91c1c", bg: "#FF0000", text: "#ffffff", border: "#b91c1c" },
-  off: { fill: "#edeeef", stroke: "#000000", bg: "#666666", text: "#ffffff", border: "#4b5563" },
-  starting: { fill: "#90EE90", stroke: "#22c55e", bg: "#90EE90", text: "#000000", border: "#22c55e" },
-  stopping: { fill: "#FFD700", stroke: "#d97706", bg: "#FFD700", text: "#000000", border: "#d97706" }
-};
-var STATUS_ALIASES = {
-  running: "normal",
-  stopped: "off"
-};
-function resolveStatusColor(status, customMap) {
-  const raw = (status || "off").toLowerCase();
-  const key = STATUS_ALIASES[raw] ?? raw;
-  const defaults = DEFAULT_STATUS_COLORS[key] ?? DEFAULT_STATUS_COLORS.off;
-  const overrides = customMap?.[key];
-  if (!overrides) return defaults;
-  return { ...defaults, ...overrides };
-}
-
-// src/components/DeviceControlPanel/DeviceControlPanel.tsx
 import { Fragment as Fragment2, jsx as jsx8, jsxs as jsxs7 } from "react/jsx-runtime";
 function DeviceControlPanelImpl({
   binding,
@@ -1568,10 +1677,13 @@ function DeviceControlPanelImpl({
                     marginBottom: spacing.gap
                   },
                   children: [
-                    /* @__PURE__ */ jsx8(
+                    /* @__PURE__ */ jsxs7(
                       "span",
                       {
                         style: {
+                          display: "flex",
+                          alignItems: "center",
+                          gap: "6px",
                           fontSize: `${fontSize.label}px`,
                           fontWeight: 600,
                           textTransform: "uppercase",
@@ -1579,7 +1691,29 @@ function DeviceControlPanelImpl({
                           fontFamily: "Arial, sans-serif",
                           color: mutedTextColor
                         },
-                        children: param.label
+                        children: [
+                          param.label,
+                          param.forced?.active && /* @__PURE__ */ jsx8(
+                            "span",
+                            {
+                              "aria-label": "Forced",
+                              style: {
+                                display: "inline-flex",
+                                alignItems: "center",
+                                justifyContent: "center",
+                                width: "16px",
+                                height: "16px",
+                                fontSize: "10px",
+                                fontWeight: 700,
+                                color: FORCED_MARK_COLOR.text,
+                                backgroundColor: FORCED_MARK_COLOR.bg,
+                                border: `1px solid ${FORCED_MARK_COLOR.border}`,
+                                borderRadius: "50%"
+                              },
+                              children: "F"
+                            }
+                          )
+                        ]
                       }
                     ),
                     /* @__PURE__ */ jsxs7(
@@ -1601,6 +1735,27 @@ function DeviceControlPanelImpl({
                   ]
                 }
               ),
+              param.forced?.active && param.forced.realValue !== void 0 && /* @__PURE__ */ jsxs7(
+                "div",
+                {
+                  style: {
+                    display: "flex",
+                    justifyContent: "flex-end",
+                    marginTop: "-4px",
+                    marginBottom: spacing.gap,
+                    fontSize: "10px",
+                    fontWeight: 500,
+                    fontFamily: "Arial, sans-serif",
+                    color: mutedTextColor
+                  },
+                  children: [
+                    "REAL",
+                    " ",
+                    typeof param.forced.realValue === "boolean" ? param.forced.realValue ? "ON" : "OFF" : String(param.forced.realValue),
+                    param.unit ? ` ${param.unit}` : ""
+                  ]
+                }
+              ),
               param.type === "boolean" ? /* @__PURE__ */ jsx8(
                 "button",
                 {
@@ -2699,19 +2854,38 @@ var CardUnit = styled2("div")({
 
 // src/components/layout/FullscreenWorkspace/FullscreenWorkspace.visuals.tsx
 import { Fragment as Fragment3, jsx as jsx12, jsxs as jsxs9 } from "react/jsx-runtime";
+var forcedTagStyle = {
+  position: "absolute",
+  top: "-6px",
+  right: "-6px",
+  width: "14px",
+  height: "14px",
+  display: "flex",
+  alignItems: "center",
+  justifyContent: "center",
+  fontSize: "9px",
+  fontWeight: 700,
+  color: FORCED_MARK_COLOR.text,
+  backgroundColor: FORCED_MARK_COLOR.bg,
+  border: `1px solid ${FORCED_MARK_COLOR.border}`,
+  borderRadius: "50%",
+  pointerEvents: "none"
+};
 var TrendLine = ({
   values,
   width = 60,
   height = 20,
   color = "#4fc3f7",
   strokeWidth = 1.5,
-  backgroundColor = "rgba(255, 255, 255, 0.1)"
+  backgroundColor = "rgba(255, 255, 255, 0.1)",
+  forced = false
 }) => {
   if (!values || values.length < 2) {
-    return /* @__PURE__ */ jsx12(
+    return /* @__PURE__ */ jsxs9(
       "div",
       {
         style: {
+          position: "relative",
           width,
           height,
           backgroundColor,
@@ -2720,7 +2894,10 @@ var TrendLine = ({
           alignItems: "center",
           justifyContent: "center"
         },
-        children: /* @__PURE__ */ jsx12("span", { style: { fontSize: "8px", color: "#ccc" }, children: "No data" })
+        children: [
+          /* @__PURE__ */ jsx12("span", { style: { fontSize: "8px", color: "#ccc" }, children: "No data" }),
+          forced && /* @__PURE__ */ jsx12("span", { style: forcedTagStyle, "aria-label": "Forced", children: "F" })
+        ]
       }
     );
   }
@@ -2732,7 +2909,7 @@ var TrendLine = ({
     const x = 4 + i / (values.length - 1) * (width - 8);
     return i === 0 ? `M ${x} ${y}` : `L ${x} ${y}`;
   }).join(" ");
-  return /* @__PURE__ */ jsx12(
+  return /* @__PURE__ */ jsxs9(
     "div",
     {
       style: {
@@ -2741,30 +2918,41 @@ var TrendLine = ({
         backgroundColor,
         borderRadius: "2px",
         position: "relative",
-        overflow: "hidden"
+        overflow: "visible"
       },
-      children: /* @__PURE__ */ jsxs9("svg", { width, height, style: { position: "absolute", top: 0, left: 0 }, children: [
-        /* @__PURE__ */ jsx12(
-          "path",
+      children: [
+        /* @__PURE__ */ jsxs9(
+          "svg",
           {
-            d: pathData,
-            fill: "none",
-            stroke: color,
-            strokeWidth,
-            strokeLinecap: "round",
-            strokeLinejoin: "round"
+            width,
+            height,
+            style: { position: "absolute", top: 0, left: 0, overflow: "hidden", borderRadius: "2px" },
+            children: [
+              /* @__PURE__ */ jsx12(
+                "path",
+                {
+                  d: pathData,
+                  fill: "none",
+                  stroke: color,
+                  strokeWidth,
+                  strokeLinecap: "round",
+                  strokeLinejoin: "round"
+                }
+              ),
+              /* @__PURE__ */ jsx12(
+                "circle",
+                {
+                  cx: 4 + (width - 8),
+                  cy: normalizedValues[normalizedValues.length - 1],
+                  r: 1.5,
+                  fill: color
+                }
+              )
+            ]
           }
         ),
-        /* @__PURE__ */ jsx12(
-          "circle",
-          {
-            cx: 4 + (width - 8),
-            cy: normalizedValues[normalizedValues.length - 1],
-            r: 1.5,
-            fill: color
-          }
-        )
-      ] })
+        forced && /* @__PURE__ */ jsx12("span", { style: forcedTagStyle, "aria-label": "Forced", children: "F" })
+      ]
     }
   );
 };
@@ -2780,7 +2968,9 @@ var CircularGauge = ({
   unit,
   label,
   size = 60,
-  color = "rgba(255, 255, 255, 0.9)"
+  color = "rgba(255, 255, 255, 0.9)",
+  forced = false,
+  realValue
 }) => {
   const percentage = Math.min(value / max * 100, 100);
   const strokeWidth = 4;
@@ -2811,7 +3001,7 @@ var CircularGauge = ({
               height: size,
               borderRadius: "50%",
               backgroundColor,
-              border: `1px solid ${borderStrokeColor}`
+              border: forced ? `2px solid ${FORCED_MARK_COLOR.border}` : `1px solid ${borderStrokeColor}`
             },
             children: [
               /* @__PURE__ */ jsxs9("svg", { width: size, height: size, style: { transform: "rotate(-90deg)" }, children: [
@@ -2887,12 +3077,39 @@ var CircularGauge = ({
             },
             children: label
           }
-        )
+        ),
+        forced && /* @__PURE__ */ jsx12(
+          "span",
+          {
+            "aria-label": "Forced",
+            style: {
+              display: "inline-flex",
+              alignItems: "center",
+              justifyContent: "center",
+              width: "14px",
+              height: "14px",
+              fontSize: "9px",
+              fontWeight: 700,
+              color: FORCED_MARK_COLOR.text,
+              backgroundColor: FORCED_MARK_COLOR.bg,
+              border: `1px solid ${FORCED_MARK_COLOR.border}`,
+              borderRadius: "50%",
+              marginTop: "2px"
+            },
+            children: "F"
+          }
+        ),
+        forced && realValue !== void 0 && /* @__PURE__ */ jsxs9("div", { style: { fontSize: "8px", opacity: 0.8, color: "white", marginTop: "1px" }, children: [
+          "REAL ",
+          realValue.toFixed(1),
+          " ",
+          unit
+        ] })
       ]
     }
   );
 };
-var Sparkline = ({ data, width, height, color }) => {
+var Sparkline = ({ data, width, height, color, forced = false }) => {
   if (!data || data.length < 2) {
     return null;
   }
@@ -2907,24 +3124,52 @@ var Sparkline = ({ data, width, height, color }) => {
     const y = height - 8 - (value - min) / range * (height - 8);
     return `${x + 4},${y + 4}`;
   }).join(" ");
-  return /* @__PURE__ */ jsx12(
+  return /* @__PURE__ */ jsxs9(
     "div",
     {
       style: {
+        position: "relative",
         width,
         height,
         backgroundColor: "rgba(0, 0, 0, 0.7)",
-        border: "1px solid rgba(255, 255, 255, 0.3)",
+        border: forced ? `1px solid ${FORCED_MARK_COLOR.border}` : "1px solid rgba(255, 255, 255, 0.3)",
         borderRadius: "4px",
         display: "flex",
         alignItems: "center",
         justifyContent: "center",
         boxShadow: "0 1px 3px rgba(0, 0, 0, 0.2)"
       },
-      children: /* @__PURE__ */ jsx12("svg", { width, height, children: /* @__PURE__ */ jsx12("polyline", { points, fill: "none", stroke: color, strokeWidth: "1.5", opacity: "0.9" }) })
+      children: [
+        /* @__PURE__ */ jsx12("svg", { width, height, children: /* @__PURE__ */ jsx12("polyline", { points, fill: "none", stroke: color, strokeWidth: "1.5", opacity: "0.9" }) }),
+        forced && /* @__PURE__ */ jsx12("span", { style: forcedTagStyle, "aria-label": "Forced", children: "F" })
+      ]
     }
   );
 };
+var EquipmentForcedBadge = () => /* @__PURE__ */ jsx12(
+  "span",
+  {
+    "aria-label": "Forced",
+    style: {
+      position: "absolute",
+      top: "-4px",
+      right: "-4px",
+      width: "11px",
+      height: "11px",
+      borderRadius: "50%",
+      backgroundColor: FORCED_MARK_COLOR.bg,
+      border: `1px solid ${FORCED_MARK_COLOR.border}`,
+      color: FORCED_MARK_COLOR.text,
+      fontSize: "7px",
+      fontWeight: 700,
+      display: "flex",
+      alignItems: "center",
+      justifyContent: "center",
+      lineHeight: 1
+    },
+    children: "F"
+  }
+);
 var EquipmentIndicatorWithSparkline = ({
   svgX,
   svgY,
@@ -2932,11 +3177,51 @@ var EquipmentIndicatorWithSparkline = ({
   label,
   size = 30,
   sparklineData,
-  sparklineOffset = { x: 40, y: 0 }
+  sparklineOffset = { x: 40, y: 0 },
+  forced = false
 }) => {
   const hasSparkline = sparklineData && sparklineData.length > 1 && Math.max(...sparklineData) !== Math.min(...sparklineData);
   return /* @__PURE__ */ jsxs9(Fragment3, { children: [
-    /* @__PURE__ */ jsx12(SVGLockedOverlay, { svgX, svgY, style: { transform: "translate(-50%, -50%)" }, children: /* @__PURE__ */ jsx12(
+    /* @__PURE__ */ jsx12(SVGLockedOverlay, { svgX, svgY, style: { transform: "translate(-50%, -50%)" }, children: /* @__PURE__ */ jsxs9("div", { style: { position: "relative", width: size, height: size }, children: [
+      /* @__PURE__ */ jsx12(
+        "div",
+        {
+          style: {
+            width: size,
+            height: size,
+            borderRadius: "50%",
+            backgroundColor: color,
+            display: "flex",
+            alignItems: "center",
+            justifyContent: "center",
+            color: "white",
+            fontSize: "7px",
+            fontWeight: "700",
+            textAlign: "center",
+            boxShadow: "0 2px 8px rgba(0, 0, 0, 0.3)",
+            border: forced ? `2px solid ${FORCED_MARK_COLOR.border}` : "2px solid rgba(255, 255, 255, 0.3)"
+          },
+          children: label
+        }
+      ),
+      forced && /* @__PURE__ */ jsx12(EquipmentForcedBadge, {})
+    ] }) }),
+    hasSparkline && /* @__PURE__ */ jsx12(SVGLockedOverlay, { svgX: svgX + sparklineOffset.x, svgY: svgY + sparklineOffset.y, children: /* @__PURE__ */ jsx12(Sparkline, { data: sparklineData, width: 60, height: 20, color, forced }) })
+  ] });
+};
+var EquipmentIndicator = ({
+  svgX,
+  svgY,
+  color,
+  label,
+  size = 30,
+  style,
+  className,
+  forced = false
+}) => {
+  const overlayStyle = style !== void 0 ? { transform: "translate(-50%, -50%)", ...style } : { transform: "translate(-50%, -50%)" };
+  return /* @__PURE__ */ jsx12(SVGLockedOverlay, { svgX, svgY, style: overlayStyle, className, children: /* @__PURE__ */ jsxs9("div", { style: { position: "relative", width: size, height: size }, children: [
+    /* @__PURE__ */ jsx12(
       "div",
       {
         style: {
@@ -2952,45 +3237,13 @@ var EquipmentIndicatorWithSparkline = ({
           fontWeight: "700",
           textAlign: "center",
           boxShadow: "0 2px 8px rgba(0, 0, 0, 0.3)",
-          border: "2px solid rgba(255, 255, 255, 0.3)"
+          border: forced ? `2px solid ${FORCED_MARK_COLOR.border}` : "2px solid rgba(255, 255, 255, 0.3)"
         },
         children: label
       }
-    ) }),
-    hasSparkline && /* @__PURE__ */ jsx12(SVGLockedOverlay, { svgX: svgX + sparklineOffset.x, svgY: svgY + sparklineOffset.y, children: /* @__PURE__ */ jsx12(Sparkline, { data: sparklineData, width: 60, height: 20, color }) })
-  ] });
-};
-var EquipmentIndicator = ({
-  svgX,
-  svgY,
-  color,
-  label,
-  size = 30,
-  style,
-  className
-}) => {
-  const overlayStyle = style !== void 0 ? { transform: "translate(-50%, -50%)", ...style } : { transform: "translate(-50%, -50%)" };
-  return /* @__PURE__ */ jsx12(SVGLockedOverlay, { svgX, svgY, style: overlayStyle, className, children: /* @__PURE__ */ jsx12(
-    "div",
-    {
-      style: {
-        width: size,
-        height: size,
-        borderRadius: "50%",
-        backgroundColor: color,
-        display: "flex",
-        alignItems: "center",
-        justifyContent: "center",
-        color: "white",
-        fontSize: "7px",
-        fontWeight: "700",
-        textAlign: "center",
-        boxShadow: "0 2px 8px rgba(0, 0, 0, 0.3)",
-        border: "2px solid rgba(255, 255, 255, 0.3)"
-      },
-      children: label
-    }
-  ) });
+    ),
+    forced && /* @__PURE__ */ jsx12(EquipmentForcedBadge, {})
+  ] }) });
 };
 
 // src/components/layout/FullscreenWorkspace/FullscreenWorkspace.tsx
@@ -3280,7 +3533,7 @@ var ThemeToggle = ({
 };
 
 // src/components/PIDCanvas/PIDCanvas.tsx
-import React13, { useCallback as useCallback8, useState as useState14, useEffect as useEffect12, useRef as useRef6 } from "react";
+import React13, { useCallback as useCallback8, useState as useState14, useEffect as useEffect13, useRef as useRef6 } from "react";
 
 // src/components/PIDCanvas/NodeRenderer.tsx
 import React9 from "react";
@@ -3311,6 +3564,25 @@ var mockSymbolLibrary = {
       tags: ["valve", "gate", "powered", "actuator"]
     }
   },
+  "status-indicator": {
+    id: "status-indicator",
+    name: "Status LED",
+    category: "instrument",
+    viewBox: { x: 0, y: 0, width: 24, height: 24 },
+    ports: [],
+    svgContent: `
+      <rect x="2" y="2" width="20" height="20"
+        rx="var(--led-rx, 50%)"
+        fill="var(--symbol-fill, #64748b)"
+        stroke="rgba(255,255,255,0.4)"
+        stroke-width="var(--led-bezel, 0)"
+        style="transform-box: fill-box; transform: rotate(var(--led-rotate, 0deg)); transform-origin: center; pointer-events: all;"/>
+    `,
+    metadata: {
+      description: "Status LED indicator driven by telemetry status color",
+      tags: ["status", "led", "indicator", "instrument"]
+    }
+  },
   "pump-positive-displacement": {
     id: "pump-positive-displacement",
     name: "Positive Displacement Pump",
@@ -4503,8 +4775,144 @@ function getAvailableSymbols() {
   return [...Object.keys(customSymbols), ...Object.keys(mockSymbolLibrary)];
 }
 
+// src/diagram/symbols/appearanceSchema.ts
+var COLOR_PRESETS = {
+  green: "#22c55e",
+  red: "#ef4444",
+  amber: "#f59e0b",
+  blue: "#3b82f6",
+  grey: "#64748b"
+};
+function resolvePresetColor(name) {
+  return name && COLOR_PRESETS[name] || COLOR_PRESETS.grey;
+}
+var COLOR_OPTIONS = Object.keys(COLOR_PRESETS);
+var STATUS_LED_APPEARANCE = [
+  {
+    key: "shape",
+    kind: "select",
+    label: "Shape",
+    options: ["circle", "square", "diamond"],
+    default: "circle"
+  },
+  {
+    key: "size",
+    kind: "select",
+    label: "Size",
+    target: "scale",
+    options: ["small", "medium", "large"],
+    default: "medium",
+    valueMap: { small: 0.75, medium: 1, large: 1.5 }
+  },
+  { key: "led", kind: "boolean", label: "Bezel ring", default: true },
+  { key: "glow", kind: "boolean", label: "Diffusion (glow)", default: false },
+  {
+    key: "animation",
+    kind: "select",
+    label: "Animation",
+    options: ["none", "pulse", "blink"],
+    default: "none"
+  },
+  {
+    key: "labelPosition",
+    kind: "select",
+    label: "Label position",
+    options: ["bottom", "top", "left", "right"],
+    default: "bottom"
+  },
+  // Color binding: a named signal drives the on/off color.
+  {
+    key: "colorSource",
+    kind: "tag",
+    label: "Color source (tag)",
+    default: "",
+    help: "Signal/tag that drives color. True (non-zero) shows On color; false shows Off color. Blank = unbound (grey)."
+  },
+  {
+    key: "onColor",
+    kind: "select",
+    label: "On color (true)",
+    options: COLOR_OPTIONS,
+    default: "green",
+    help: "Color when the Color source is true."
+  },
+  {
+    key: "offColor",
+    kind: "select",
+    label: "Off color (false)",
+    options: COLOR_OPTIONS,
+    default: "red",
+    help: "Color when the Color source is false."
+  },
+  // Visibility binding: an independent named signal drives show/hide.
+  {
+    key: "visibleSource",
+    kind: "tag",
+    label: "Visibility source (tag)",
+    default: "",
+    help: "Signal/tag that drives visibility. True shows the LED, false hides it. Blank = always visible (use the Visible checkbox)."
+  },
+  {
+    key: "visible",
+    kind: "boolean",
+    label: "Visible",
+    target: "visible",
+    default: true,
+    help: "Static show/hide, used only when no Visibility source is set."
+  }
+];
+var APPEARANCE_REGISTRY = {
+  "status-indicator": STATUS_LED_APPEARANCE
+};
+function getAppearanceSchema(symbolId) {
+  return APPEARANCE_REGISTRY[symbolId] ?? [];
+}
+function getAppearanceDefaults(symbolId) {
+  const out = {};
+  for (const field of getAppearanceSchema(symbolId)) {
+    if ((field.target ?? "metadata") === "metadata" && field.default !== void 0) {
+      out[field.key] = field.default;
+    }
+  }
+  return out;
+}
+function readAppearanceValue(node, field) {
+  if (field.target === "visible") {
+    return node.visible ?? field.default ?? true;
+  }
+  if (field.target === "scale") {
+    const scale = node.transform.scale ?? 1;
+    if (field.valueMap) {
+      let bestOption = field.options?.[0] ?? String(scale);
+      let bestDiff = Infinity;
+      for (const [option, value2] of Object.entries(field.valueMap)) {
+        const diff = Math.abs(value2 - scale);
+        if (diff < bestDiff) {
+          bestDiff = diff;
+          bestOption = option;
+        }
+      }
+      return bestOption;
+    }
+    return scale;
+  }
+  const value = node.metadata?.[field.key];
+  return value ?? field.default;
+}
+function writeAppearanceValue(node, field, value) {
+  if (field.target === "visible") {
+    return { visible: Boolean(value) };
+  }
+  if (field.target === "scale") {
+    const scale = field.valueMap ? field.valueMap[String(value)] ?? 1 : Number(value);
+    return { transform: { ...node.transform, scale } };
+  }
+  return { metadata: { ...node.metadata, [field.key]: value } };
+}
+
 // src/components/PIDCanvas/NodeRenderer.tsx
 import { jsx as jsx16, jsxs as jsxs12 } from "react/jsx-runtime";
+var HATCH_SIZE = 6;
 function NodeRendererImpl({
   nodes: nodes2,
   selectedNodeIds,
@@ -4516,140 +4924,206 @@ function NodeRendererImpl({
   enableDrag = false,
   statusColorMap
 }) {
-  return /* @__PURE__ */ jsx16("g", { id: "layer-nodes", children: nodes2.filter((node) => node.visible !== false).map((node) => {
-    const symbol = getSymbolDefinition(node.symbolId);
-    const isSelected = selectedNodeIds?.has(node.id) ?? false;
-    const isDragging = draggingNodeId === node.id;
-    if (!symbol) {
-      return /* @__PURE__ */ jsxs12("g", { children: [
-        /* @__PURE__ */ jsx16(
-          "circle",
-          {
-            cx: node.transform.x,
-            cy: node.transform.y,
-            r: "15",
-            fill: "#ff0000",
-            opacity: "0.3",
-            stroke: "#ff0000",
-            strokeWidth: "2"
-          }
-        ),
-        /* @__PURE__ */ jsx16(
-          "text",
-          {
-            x: node.transform.x,
-            y: node.transform.y,
-            textAnchor: "middle",
-            dominantBaseline: "middle",
-            fontSize: "10",
-            fill: "#ff0000",
-            children: "?"
-          }
-        )
-      ] }, node.id);
-    }
-    const transforms = [];
-    const effectiveX = isDragging ? node.transform.x + dragOffset.x : node.transform.x;
-    const effectiveY = isDragging ? node.transform.y + dragOffset.y : node.transform.y;
-    transforms.push(`translate(${effectiveX}, ${effectiveY})`);
-    if (node.transform.rotation) {
-      const centerX = symbol.viewBox.width / 2;
-      const centerY = symbol.viewBox.height / 2;
-      transforms.push(`rotate(${node.transform.rotation}, ${centerX}, ${centerY})`);
-    }
-    if (node.transform.scale && node.transform.scale !== 1) {
-      const centerX = symbol.viewBox.width / 2;
-      const centerY = symbol.viewBox.height / 2;
-      transforms.push(
-        `translate(${centerX}, ${centerY}) scale(${node.transform.scale}) translate(${-centerX}, ${-centerY})`
-      );
-    }
-    if (node.transform.flipX || node.transform.flipY) {
-      const scaleX = node.transform.flipX ? -1 : 1;
-      const scaleY = node.transform.flipY ? -1 : 1;
-      const centerX = symbol.viewBox.width / 2;
-      const centerY = symbol.viewBox.height / 2;
-      transforms.push(
-        `translate(${centerX}, ${centerY}) scale(${scaleX}, ${scaleY}) translate(${-centerX}, ${-centerY})`
-      );
-    }
-    const statusEntry = resolveStatusColor(node.status, statusColorMap);
-    const fillColor = node.customColors?.fill ?? statusEntry.fill;
-    const strokeColor = node.customColors?.stroke ?? statusEntry.stroke;
-    return /* @__PURE__ */ jsxs12(
-      "g",
+  const hatchId = `pid-unknown-hatch-${React9.useId().replace(/[^A-Za-z0-9_-]/g, "")}`;
+  const hasUnknown = nodes2.some((n) => n.positionUnknown === true && n.visible !== false);
+  return /* @__PURE__ */ jsxs12("g", { id: "layer-nodes", children: [
+    hasUnknown && /* @__PURE__ */ jsx16("defs", { children: /* @__PURE__ */ jsxs12(
+      "pattern",
       {
-        "data-node-id": node.id,
-        "data-symbol-id": node.symbolId,
-        "data-selected": isSelected,
-        "data-dragging": isDragging,
-        transform: transforms.join(" "),
-        style: {
-          "--symbol-fill": fillColor,
-          "--symbol-stroke": strokeColor,
-          cursor: enableDrag ? isDragging ? "grabbing" : "grab" : onNodeClick ? "pointer" : "default"
-        },
-        onClick: (e) => {
-          e.stopPropagation();
-          onNodeClick?.(node.id, e);
-        },
-        onDoubleClick: (e) => {
-          e.stopPropagation();
-          onNodeDoubleClick?.(node.id, e);
-        },
-        onMouseDown: (e) => {
-          if (enableDrag) {
-            onNodeDragStart?.(node.id, e);
-          }
-        },
-        onTouchStart: (e) => {
-          if (enableDrag) {
-            e.stopPropagation();
-            onNodeDragStart?.(node.id, e);
-          }
-        },
+        id: hatchId,
+        "data-testid": "position-unknown-pattern",
+        patternUnits: "userSpaceOnUse",
+        width: HATCH_SIZE,
+        height: HATCH_SIZE,
+        patternTransform: "rotate(45)",
         children: [
-          isSelected && /* @__PURE__ */ jsx16(
-            "rect",
+          /* @__PURE__ */ jsx16("rect", { width: HATCH_SIZE, height: HATCH_SIZE, fill: UNKNOWN_MARK_COLOR.fill }),
+          /* @__PURE__ */ jsx16(
+            "line",
             {
-              x: "-5",
-              y: "-5",
-              width: symbol.viewBox.width + 10,
-              height: symbol.viewBox.height + 10,
-              fill: "none",
-              stroke: isDragging ? "#10b981" : "#3b82f6",
-              strokeWidth: isDragging ? "3" : "2",
-              strokeDasharray: "4 2",
-              rx: "2",
-              pointerEvents: "none"
+              x1: "0",
+              y1: "0",
+              x2: "0",
+              y2: HATCH_SIZE,
+              stroke: UNKNOWN_MARK_COLOR.text,
+              strokeWidth: "2"
             }
-          ),
+          )
+        ]
+      }
+    ) }),
+    nodes2.filter((node) => node.visible !== false).map((node) => {
+      const symbol = getSymbolDefinition(node.symbolId);
+      const isSelected = selectedNodeIds?.has(node.id) ?? false;
+      const isDragging = draggingNodeId === node.id;
+      if (!symbol) {
+        return /* @__PURE__ */ jsxs12("g", { children: [
           /* @__PURE__ */ jsx16(
-            "g",
+            "circle",
             {
-              dangerouslySetInnerHTML: { __html: symbol.svgContent },
-              "data-symbol-content": symbol.id,
-              style: { pointerEvents: "auto" }
+              cx: node.transform.x,
+              cy: node.transform.y,
+              r: "15",
+              fill: "#ff0000",
+              opacity: "0.3",
+              stroke: "#ff0000",
+              strokeWidth: "2"
             }
           ),
           /* @__PURE__ */ jsx16(
             "text",
             {
-              x: symbol.viewBox.width / 2 + (node.labelOffset?.x ?? 0),
-              y: symbol.viewBox.height + 12 + (node.labelOffset?.y ?? 0),
+              x: node.transform.x,
+              y: node.transform.y,
               textAnchor: "middle",
-              fontSize: node.labelFontSize ?? 10,
-              fontWeight: "600",
-              fill: isSelected ? "#3b82f6" : "#1f2937",
-              transform: node.transform.rotation ? `rotate(${-node.transform.rotation}, ${symbol.viewBox.width / 2 + (node.labelOffset?.x ?? 0)}, ${symbol.viewBox.height + 12 + (node.labelOffset?.y ?? 0)})` : void 0,
-              children: node.label || node.id
+              dominantBaseline: "middle",
+              fontSize: "10",
+              fill: "#ff0000",
+              children: "?"
             }
           )
-        ]
-      },
-      node.id
-    );
-  }) });
+        ] }, node.id);
+      }
+      const transforms = [];
+      const effectiveX = isDragging ? node.transform.x + dragOffset.x : node.transform.x;
+      const effectiveY = isDragging ? node.transform.y + dragOffset.y : node.transform.y;
+      transforms.push(`translate(${effectiveX}, ${effectiveY})`);
+      if (node.transform.rotation) {
+        const centerX = symbol.viewBox.width / 2;
+        const centerY = symbol.viewBox.height / 2;
+        transforms.push(`rotate(${node.transform.rotation}, ${centerX}, ${centerY})`);
+      }
+      if (node.transform.scale && node.transform.scale !== 1) {
+        const centerX = symbol.viewBox.width / 2;
+        const centerY = symbol.viewBox.height / 2;
+        transforms.push(
+          `translate(${centerX}, ${centerY}) scale(${node.transform.scale}) translate(${-centerX}, ${-centerY})`
+        );
+      }
+      if (node.transform.flipX || node.transform.flipY) {
+        const scaleX = node.transform.flipX ? -1 : 1;
+        const scaleY = node.transform.flipY ? -1 : 1;
+        const centerX = symbol.viewBox.width / 2;
+        const centerY = symbol.viewBox.height / 2;
+        transforms.push(
+          `translate(${centerX}, ${centerY}) scale(${scaleX}, ${scaleY}) translate(${-centerX}, ${-centerY})`
+        );
+      }
+      const statusEntry = resolveStatusColor(node.status, statusColorMap);
+      const isUnknown = node.positionUnknown === true;
+      const fillColor = isUnknown ? `url(#${hatchId})` : node.customColors?.fill ?? statusEntry.fill;
+      const strokeColor = isUnknown ? UNKNOWN_MARK_COLOR.stroke : node.customColors?.stroke ?? statusEntry.stroke;
+      const appearance = { ...getAppearanceDefaults(node.symbolId), ...node.metadata ?? {} };
+      const ledStyle = {};
+      if (appearance.shape !== void 0) {
+        ledStyle["--led-rx"] = appearance.shape === "circle" ? "50%" : "2";
+        ledStyle["--led-rotate"] = appearance.shape === "diamond" ? "45deg" : "0deg";
+      }
+      if (appearance.led !== void 0) {
+        ledStyle["--led-bezel"] = appearance.led ? "2" : "0";
+      }
+      if (appearance.glow) {
+        ledStyle.filter = `drop-shadow(0 0 4px ${fillColor})`;
+      }
+      const ledAnimation = typeof appearance.animation === "string" && appearance.animation !== "none" ? appearance.animation : void 0;
+      const vb = symbol.viewBox;
+      const ox = node.labelOffset?.x ?? 0;
+      const oy = node.labelOffset?.y ?? 0;
+      const labelPos = typeof appearance.labelPosition === "string" ? appearance.labelPosition : "bottom";
+      let labelX = vb.width / 2 + ox;
+      let labelY = vb.height + 12 + oy;
+      let labelAnchor = "middle";
+      if (labelPos === "top") {
+        labelX = vb.width / 2 + ox;
+        labelY = -6 + oy;
+        labelAnchor = "middle";
+      } else if (labelPos === "left") {
+        labelX = -6 + ox;
+        labelY = vb.height / 2 + oy;
+        labelAnchor = "end";
+      } else if (labelPos === "right") {
+        labelX = vb.width + 6 + ox;
+        labelY = vb.height / 2 + oy;
+        labelAnchor = "start";
+      }
+      return /* @__PURE__ */ jsxs12(
+        "g",
+        {
+          "data-node-id": node.id,
+          "data-symbol-id": node.symbolId,
+          "data-selected": isSelected,
+          "data-dragging": isDragging,
+          "data-led-animation": ledAnimation,
+          "data-position-unknown": isUnknown ? "true" : void 0,
+          transform: transforms.join(" "),
+          style: {
+            "--symbol-fill": fillColor,
+            "--symbol-stroke": strokeColor,
+            cursor: enableDrag ? isDragging ? "grabbing" : "grab" : onNodeClick ? "pointer" : "default",
+            ...ledStyle
+          },
+          onClick: (e) => {
+            e.stopPropagation();
+            onNodeClick?.(node.id, e);
+          },
+          onDoubleClick: (e) => {
+            e.stopPropagation();
+            onNodeDoubleClick?.(node.id, e);
+          },
+          onMouseDown: (e) => {
+            if (enableDrag) {
+              onNodeDragStart?.(node.id, e);
+            }
+          },
+          onTouchStart: (e) => {
+            if (enableDrag) {
+              e.stopPropagation();
+              onNodeDragStart?.(node.id, e);
+            }
+          },
+          children: [
+            isSelected && /* @__PURE__ */ jsx16(
+              "rect",
+              {
+                x: "-5",
+                y: "-5",
+                width: symbol.viewBox.width + 10,
+                height: symbol.viewBox.height + 10,
+                fill: "none",
+                stroke: isDragging ? "#10b981" : "#3b82f6",
+                strokeWidth: isDragging ? "3" : "2",
+                strokeDasharray: "4 2",
+                rx: "2",
+                pointerEvents: "none"
+              }
+            ),
+            /* @__PURE__ */ jsx16(
+              "g",
+              {
+                dangerouslySetInnerHTML: { __html: symbol.svgContent },
+                "data-symbol-content": symbol.id,
+                style: { pointerEvents: "auto" }
+              }
+            ),
+            /* @__PURE__ */ jsx16(
+              "text",
+              {
+                x: labelX,
+                y: labelY,
+                textAnchor: labelAnchor,
+                fontSize: node.labelFontSize ?? 10,
+                fontWeight: "600",
+                fill: isSelected ? "#3b82f6" : "#1f2937",
+                transform: node.transform.rotation ? `rotate(${-node.transform.rotation}, ${labelX}, ${labelY})` : void 0,
+                children: node.label || node.id
+              }
+            )
+          ]
+        },
+        node.id
+      );
+    })
+  ] });
 }
 var NodeRenderer = React9.memo(NodeRendererImpl);
 
@@ -4870,7 +5344,9 @@ function DataOverlayImpl({
   scale = 1,
   statusColorMap
 }) {
-  const { value, display, history, scaling } = telemetry;
+  const { value, display, history, scaling, forced } = telemetry;
+  const isForced = forced?.active === true;
+  const hasRealValue = isForced && forced?.realValue !== void 0;
   const showValue = display?.showValue ?? true;
   const showStatus = display?.showStatus ?? true;
   const showSparkline = display?.showSparkline ?? false;
@@ -4919,12 +5395,16 @@ function DataOverlayImpl({
   const finalTextColor = textColor || colors.text;
   const formattedValue = formatValue(value.value);
   const displayText = unit ? `${formattedValue} ${unit}` : formattedValue;
+  const realDisplayText = hasRealValue ? unit ? `REAL ${formatValue(forced.realValue)} ${unit}` : `REAL ${formatValue(forced.realValue)}` : void 0;
+  const borderColor = isForced ? FORCED_MARK_COLOR.border : colors.border;
+  const borderWidth = (isForced ? 2 : 1) * scale;
   const hasSparkline = showSparkline && sparklinePath;
-  const overlayHeight = (label ? hasSparkline ? 55 : 30 : hasSparkline ? 47 : 22) * scale;
+  const extraMarkRows = realDisplayText ? 1 : 0;
+  const overlayHeight = (label ? hasSparkline ? 55 : 30 : hasSparkline ? 47 : 22) * scale + extraMarkRows * 9 * scale;
   const overlayWidth = 80 * scale;
   const displayX = x + offsetX;
   const displayY = y + offsetY;
-  return /* @__PURE__ */ jsxs14("g", { "data-overlay-node": nodeId, "data-status": value.status, children: [
+  return /* @__PURE__ */ jsxs14("g", { "data-overlay-node": nodeId, "data-status": value.status, "data-forced": isForced, children: [
     /* @__PURE__ */ jsx18(
       "rect",
       {
@@ -4934,8 +5414,8 @@ function DataOverlayImpl({
         height: overlayHeight,
         rx: 4 * scale,
         fill: colors.bg,
-        stroke: colors.border,
-        strokeWidth: 1 * scale,
+        stroke: borderColor,
+        strokeWidth: borderWidth,
         opacity: "0.95",
         filter: "drop-shadow(0 2px 4px rgba(0,0,0,0.2))"
       }
@@ -4984,6 +5464,48 @@ function DataOverlayImpl({
         ]
       }
     ),
+    isForced && /* @__PURE__ */ jsxs14(
+      "g",
+      {
+        transform: `translate(${displayX + overlayWidth / 2}, ${displayY - 25 * scale})`,
+        "aria-label": "Forced",
+        children: [
+          /* @__PURE__ */ jsx18(
+            "circle",
+            {
+              r: 7 * scale,
+              fill: FORCED_MARK_COLOR.bg,
+              stroke: FORCED_MARK_COLOR.border,
+              strokeWidth: 1.5 * scale
+            }
+          ),
+          /* @__PURE__ */ jsx18(
+            "text",
+            {
+              textAnchor: "middle",
+              dominantBaseline: "central",
+              fontSize: 8 * scale,
+              fontWeight: "700",
+              fill: FORCED_MARK_COLOR.text,
+              children: "F"
+            }
+          )
+        ]
+      }
+    ),
+    realDisplayText && /* @__PURE__ */ jsx18(
+      "text",
+      {
+        x: displayX,
+        y: displayY + (value.quality !== void 0 && value.quality < 100 ? 14 : 5) * scale,
+        textAnchor: "middle",
+        fontSize: 7 * scale,
+        fontWeight: "500",
+        fill: finalTextColor,
+        opacity: "0.85",
+        children: realDisplayText
+      }
+    ),
     hasSparkline && /* @__PURE__ */ jsx18("g", { transform: `translate(${displayX - 35 * scale}, ${displayY + (label ? 5 : 0) * scale})`, children: /* @__PURE__ */ jsx18(
       "path",
       {
@@ -5751,8 +6273,49 @@ function useTelemetryStatus(telemetry, diagram, setDiagram, options = {}) {
   }, [telemetry, diagram, setDiagram, enabled, mapStatus]);
 }
 
+// src/diagram/hooks/useBooleanIndicators.ts
+import { useEffect as useEffect10 } from "react";
+function useBooleanIndicators(telemetry, diagram, setDiagram, options = {}) {
+  const { enabled = true, symbolId = "status-indicator" } = options;
+  useEffect10(() => {
+    if (!enabled) return;
+    const tagIndex = /* @__PURE__ */ new Map();
+    telemetry.forEach((binding) => {
+      if (binding.tag) tagIndex.set(binding.tag, binding.value.value);
+    });
+    let needsUpdate = false;
+    const updatedNodes = diagram.nodes.map((node) => {
+      if (node.symbolId !== symbolId) return node;
+      const meta = node.metadata ?? {};
+      const colorSource = typeof meta.colorSource === "string" ? meta.colorSource : "";
+      const visibleSource = typeof meta.visibleSource === "string" ? meta.visibleSource : "";
+      let next = node;
+      if (colorSource) {
+        const isTrue = Boolean(tagIndex.get(colorSource));
+        const fill = resolvePresetColor(
+          String(isTrue ? meta.onColor ?? "green" : meta.offColor ?? "red")
+        );
+        if (node.customColors?.fill !== fill) {
+          next = { ...next, customColors: { ...next.customColors, fill } };
+        }
+      }
+      if (visibleSource) {
+        const vis = Boolean(tagIndex.get(visibleSource));
+        if ((next.visible ?? true) !== vis) {
+          next = { ...next, visible: vis };
+        }
+      }
+      if (next !== node) needsUpdate = true;
+      return next;
+    });
+    if (needsUpdate) {
+      setDiagram({ ...diagram, nodes: updatedNodes });
+    }
+  }, [telemetry, diagram, setDiagram, enabled, symbolId]);
+}
+
 // src/diagram/hooks/useDrag.ts
-import { useState as useState13, useCallback as useCallback7, useRef as useRef5, useEffect as useEffect10 } from "react";
+import { useState as useState13, useCallback as useCallback7, useRef as useRef5, useEffect as useEffect11 } from "react";
 function useDrag(options = {}) {
   const {
     onDragStart,
@@ -5937,7 +6500,7 @@ function useDrag(options = {}) {
     },
     [screenToWorld, applySnap, onDragEnd]
   );
-  useEffect10(() => {
+  useEffect11(() => {
     if (!isListening) return;
     document.addEventListener("mousemove", handleMouseMove);
     document.addEventListener("mouseup", handleMouseUp);
@@ -6006,7 +6569,7 @@ function useDrag(options = {}) {
 }
 
 // src/diagram/hooks/useKeyboardShortcuts.ts
-import { useEffect as useEffect11 } from "react";
+import { useEffect as useEffect12 } from "react";
 function useKeyboardShortcuts(options) {
   const {
     onDelete,
@@ -6017,7 +6580,7 @@ function useKeyboardShortcuts(options) {
     onSelectAll,
     enabled = true
   } = options;
-  useEffect11(() => {
+  useEffect12(() => {
     if (!enabled) return;
     const handleKeyDown = (event) => {
       const target = event.target;
@@ -6169,7 +6732,7 @@ function PIDCanvasImpl({
   const isUndoRedoAction = useRef6(false);
   const isInternalChange = useRef6(false);
   const lastInternalDiagram = useRef6(null);
-  useEffect12(() => {
+  useEffect13(() => {
     const isExternal = !isInternalChange.current && diagram !== lastInternalDiagram.current;
     if (isExternal) {
       setLocalDiagram(diagram);
@@ -6214,7 +6777,7 @@ function PIDCanvasImpl({
     });
     return { minX, minY, maxX, maxY };
   }, [localDiagram.nodes]);
-  useEffect12(() => {
+  useEffect13(() => {
     if (onMounted) {
       const controls = {
         fitToContent: (padding = 50) => {
@@ -6293,7 +6856,7 @@ function PIDCanvasImpl({
       isUndoRedoAction.current = false;
     }, 0);
   }, [localDiagram, onDiagramChange]);
-  useEffect12(() => {
+  useEffect13(() => {
     const handleKeyDown = (e) => {
       const isCtrlOrCmd = e.ctrlKey || e.metaKey;
       if (isCtrlOrCmd && e.key === "z" && !e.shiftKey) {
@@ -6310,7 +6873,7 @@ function PIDCanvasImpl({
     window.addEventListener("keydown", handleKeyDown);
     return () => window.removeEventListener("keydown", handleKeyDown);
   }, [undo, redo]);
-  useEffect12(() => {
+  useEffect13(() => {
     if (!features.dragNodes) return;
     const handleKeyDown = (e) => {
       if (selection.selectedNodeIds.size === 0 && !selectedWaypoint) return;
@@ -6847,6 +7410,7 @@ function PIDCanvasImpl({
                 }
               ),
               telemetryEnabled && telemetry && /* @__PURE__ */ jsx20("g", { id: "layer-telemetry", children: displayDiagram.nodes.map((node) => {
+                if (node.symbolId === "status-indicator") return null;
                 const binding = telemetry.get(node.id);
                 if (!binding) return null;
                 const symbol = getSymbolDefinition(node.symbolId);
@@ -7214,6 +7778,8 @@ function NodeConfigPanel({
   onUpdateNode,
   onUpdateTelemetry,
   onAddTelemetry,
+  onRemoveTelemetry,
+  availableTags = [],
   onRemove,
   className = "",
   style = {}
@@ -7226,6 +7792,8 @@ function NodeConfigPanel({
     padding: "20px",
     ...style
   };
+  const appearanceFields = getAppearanceSchema(node.symbolId);
+  const showGenericTelemetry = appearanceFields.length === 0;
   return /* @__PURE__ */ jsxs18("div", { className, style: defaultStyle, children: [
     /* @__PURE__ */ jsxs18("h2", { style: { margin: "0 0 16px 0", fontSize: "1rem", fontWeight: 600 }, children: [
       "Configure: ",
@@ -7347,7 +7915,136 @@ function NodeConfigPanel({
         )
       ] })
     ] }),
-    /* @__PURE__ */ jsxs18("div", { style: { marginBottom: "20px" }, children: [
+    appearanceFields.length > 0 && /* @__PURE__ */ jsxs18("div", { style: { marginBottom: "20px" }, children: [
+      /* @__PURE__ */ jsx22("h3", { style: { fontSize: "0.875rem", fontWeight: 600, marginBottom: "8px" }, children: "Appearance" }),
+      appearanceFields.map((field) => {
+        const value = readAppearanceValue(node, field);
+        const fieldLabel = field.label ?? field.key;
+        const inputStyle = {
+          width: "100%",
+          padding: "6px 8px",
+          borderRadius: "4px",
+          border: "1px solid #cbd5e1",
+          fontSize: "0.875rem"
+        };
+        let control;
+        if (field.kind === "boolean") {
+          control = /* @__PURE__ */ jsxs18("label", { style: { fontSize: "0.75rem", display: "block" }, children: [
+            /* @__PURE__ */ jsx22(
+              "input",
+              {
+                type: "checkbox",
+                checked: Boolean(value),
+                onChange: (e) => onUpdateNode(writeAppearanceValue(node, field, e.target.checked)),
+                style: { marginRight: "6px" }
+              }
+            ),
+            fieldLabel
+          ] });
+        } else if (field.kind === "select") {
+          control = /* @__PURE__ */ jsxs18(Fragment8, { children: [
+            /* @__PURE__ */ jsxs18("label", { style: { fontSize: "0.75rem", display: "block", marginBottom: "4px" }, children: [
+              fieldLabel,
+              ":"
+            ] }),
+            /* @__PURE__ */ jsx22(
+              "select",
+              {
+                value: String(value),
+                onChange: (e) => onUpdateNode(writeAppearanceValue(node, field, e.target.value)),
+                style: inputStyle,
+                children: field.options?.map((opt) => /* @__PURE__ */ jsx22("option", { value: opt, children: opt }, opt))
+              }
+            )
+          ] });
+        } else if (field.kind === "number") {
+          control = /* @__PURE__ */ jsxs18(Fragment8, { children: [
+            /* @__PURE__ */ jsxs18("label", { style: { fontSize: "0.75rem", display: "block", marginBottom: "4px" }, children: [
+              fieldLabel,
+              ":"
+            ] }),
+            /* @__PURE__ */ jsx22(
+              "input",
+              {
+                type: "number",
+                value: Number(value),
+                onChange: (e) => onUpdateNode(writeAppearanceValue(node, field, parseFloat(e.target.value) || 0)),
+                style: inputStyle
+              }
+            )
+          ] });
+        } else if (field.kind === "tag") {
+          const tagValue = String(value);
+          const listId = `tags-${node.id}-${field.key}`;
+          const known = tagValue.length > 0 && availableTags.includes(tagValue);
+          const unknown = tagValue.length > 0 && !known;
+          control = /* @__PURE__ */ jsxs18(Fragment8, { children: [
+            /* @__PURE__ */ jsxs18("label", { style: { fontSize: "0.75rem", display: "block", marginBottom: "4px" }, children: [
+              fieldLabel,
+              ":"
+            ] }),
+            /* @__PURE__ */ jsx22(
+              "input",
+              {
+                type: "text",
+                value: tagValue,
+                list: listId,
+                onChange: (e) => onUpdateNode(writeAppearanceValue(node, field, e.target.value)),
+                placeholder: "type or pick a signal\u2026",
+                style: {
+                  ...inputStyle,
+                  border: `1px solid ${unknown ? "#f59e0b" : known ? "#22c55e" : "#cbd5e1"}`
+                }
+              }
+            ),
+            /* @__PURE__ */ jsx22("datalist", { id: listId, children: availableTags.map((t) => /* @__PURE__ */ jsx22("option", { value: t }, t)) }),
+            tagValue.length > 0 && /* @__PURE__ */ jsx22(
+              "div",
+              {
+                style: {
+                  fontSize: "0.7rem",
+                  marginTop: "3px",
+                  color: known ? "#16a34a" : "#b45309"
+                },
+                children: known ? "\u2713 matched signal" : "\u26A0 no matching signal (reads as false until published)"
+              }
+            )
+          ] });
+        } else {
+          control = /* @__PURE__ */ jsxs18(Fragment8, { children: [
+            /* @__PURE__ */ jsxs18("label", { style: { fontSize: "0.75rem", display: "block", marginBottom: "4px" }, children: [
+              fieldLabel,
+              ":"
+            ] }),
+            /* @__PURE__ */ jsx22(
+              "input",
+              {
+                type: "text",
+                value: String(value),
+                onChange: (e) => onUpdateNode(writeAppearanceValue(node, field, e.target.value)),
+                style: inputStyle
+              }
+            )
+          ] });
+        }
+        return /* @__PURE__ */ jsxs18("div", { style: { marginBottom: "10px" }, children: [
+          control,
+          field.help && /* @__PURE__ */ jsx22(
+            "div",
+            {
+              style: {
+                fontSize: "0.7rem",
+                color: "#64748b",
+                marginTop: "3px",
+                lineHeight: 1.35
+              },
+              children: field.help
+            }
+          )
+        ] }, field.key);
+      })
+    ] }),
+    showGenericTelemetry && /* @__PURE__ */ jsxs18("div", { style: { marginBottom: "20px" }, children: [
       /* @__PURE__ */ jsx22("h3", { style: { fontSize: "0.875rem", fontWeight: 600, marginBottom: "8px" }, children: "Telemetry Data" }),
       !binding ? /* @__PURE__ */ jsx22(
         "button",
@@ -7393,6 +8090,27 @@ function NodeConfigPanel({
           children: "+ Add Telemetry"
         }
       ) : /* @__PURE__ */ jsxs18(Fragment8, { children: [
+        /* @__PURE__ */ jsx22("label", { style: { fontSize: "0.75rem", display: "block", marginBottom: "4px" }, children: "Tag (attribute):" }),
+        /* @__PURE__ */ jsx22(
+          "input",
+          {
+            type: "text",
+            value: binding.tag || "",
+            onChange: (e) => onUpdateTelemetry({
+              nodeId: node.id,
+              tag: e.target.value
+            }),
+            placeholder: "e.g. pump.running",
+            style: {
+              width: "100%",
+              padding: "6px 8px",
+              borderRadius: "4px",
+              border: "1px solid #cbd5e1",
+              fontSize: "0.875rem",
+              marginBottom: "8px"
+            }
+          }
+        ),
         /* @__PURE__ */ jsx22("label", { style: { fontSize: "0.75rem", display: "block", marginBottom: "4px" }, children: "Initial Value:" }),
         /* @__PURE__ */ jsx22(
           "input",
@@ -7700,10 +8418,28 @@ function NodeConfigPanel({
             ] })
           ] }),
           " "
-        ] })
+        ] }),
+        onRemoveTelemetry && /* @__PURE__ */ jsx22(
+          "button",
+          {
+            onClick: onRemoveTelemetry,
+            style: {
+              width: "100%",
+              padding: "6px 8px",
+              marginTop: "8px",
+              borderRadius: "4px",
+              border: "1px solid #ef4444",
+              background: "transparent",
+              color: "#ef4444",
+              fontSize: "0.8125rem",
+              cursor: "pointer"
+            },
+            children: "Remove Telemetry"
+          }
+        )
       ] })
     ] }),
-    binding && /* @__PURE__ */ jsxs18("div", { style: { marginBottom: "20px" }, children: [
+    showGenericTelemetry && binding && /* @__PURE__ */ jsxs18("div", { style: { marginBottom: "20px" }, children: [
       /* @__PURE__ */ jsx22("h3", { style: { fontSize: "0.875rem", fontWeight: 600, marginBottom: "8px" }, children: "Thresholds" }),
       ["highHigh", "high", "low", "lowLow"].map((key) => {
         const label = key === "highHigh" ? "High-High (\u2265)" : key === "high" ? "High (\u2265)" : key === "low" ? "Low (\u2264)" : "Low-Low (\u2264)";
@@ -7733,7 +8469,7 @@ function NodeConfigPanel({
         ] }, key);
       })
     ] }),
-    binding && /* @__PURE__ */ jsxs18("div", { style: { marginBottom: "20px" }, children: [
+    showGenericTelemetry && binding && /* @__PURE__ */ jsxs18("div", { style: { marginBottom: "20px" }, children: [
       /* @__PURE__ */ jsx22("h3", { style: { fontSize: "0.875rem", fontWeight: 600, marginBottom: "8px" }, children: "Status Colors" }),
       ["normal", "warning", "alarm", "fault", "off"].map((status) => {
         const defaultColors = {
@@ -8592,7 +9328,7 @@ function useDeviceConfigs(initialConfigs) {
 }
 
 // src/components/DeviceConfigPanel/DeviceConfigPanel.tsx
-import React15, { useState as useState18, useEffect as useEffect13, useMemo, useRef as useRef8 } from "react";
+import React15, { useState as useState18, useEffect as useEffect14, useMemo, useRef as useRef8 } from "react";
 import { Fragment as Fragment9, jsx as jsx23, jsxs as jsxs19 } from "react/jsx-runtime";
 function DeviceConfigPanelImpl({
   binding,
@@ -8651,7 +9387,7 @@ function DeviceConfigPanelImpl({
     setCollapsedSections(collapsed);
     setBindingId(binding.nodeId);
   }
-  useEffect13(() => {
+  useEffect14(() => {
     const currentTimestamp = binding?.state.lastSaved || 0;
     if (binding?.state.lastSaveResult && currentTimestamp !== lastResultTimestampRef.current) {
       lastResultTimestampRef.current = currentTimestamp;
@@ -8786,7 +9522,49 @@ function DeviceConfigPanelImpl({
                   " (",
                   param.unit,
                   ")"
-                ] })
+                ] }),
+                param.forced?.active && /* @__PURE__ */ jsx23(
+                  "span",
+                  {
+                    "aria-label": "Forced",
+                    style: {
+                      display: "inline-flex",
+                      alignItems: "center",
+                      justifyContent: "center",
+                      width: "16px",
+                      height: "16px",
+                      marginLeft: "6px",
+                      fontSize: "10px",
+                      fontWeight: 700,
+                      textTransform: "none",
+                      letterSpacing: "normal",
+                      color: FORCED_MARK_COLOR.text,
+                      backgroundColor: FORCED_MARK_COLOR.bg,
+                      border: `1px solid ${FORCED_MARK_COLOR.border}`,
+                      borderRadius: "50%",
+                      verticalAlign: "middle"
+                    },
+                    children: "F"
+                  }
+                )
+              ]
+            }
+          ),
+          param.forced?.active && param.forced.realValue !== void 0 && /* @__PURE__ */ jsxs19(
+            "div",
+            {
+              style: {
+                fontSize: `${fontSize.description}px`,
+                color: mutedTextColor,
+                marginTop: "-2px",
+                marginBottom: "6px",
+                fontFamily: "Arial, sans-serif"
+              },
+              children: [
+                "REAL",
+                " ",
+                typeof param.forced.realValue === "boolean" ? param.forced.realValue ? "ON" : "OFF" : String(param.forced.realValue),
+                param.unit ? ` ${param.unit}` : ""
               ]
             }
           ),
@@ -9300,7 +10078,7 @@ function DeviceConfigPanelImpl({
 var DeviceConfigPanel = React15.memo(DeviceConfigPanelImpl);
 
 // src/diagram/hooks/useSimulation.ts
-import { useEffect as useEffect14 } from "react";
+import { useEffect as useEffect15 } from "react";
 function useSimulation(telemetry, updateTelemetryBatch, options = {}) {
   const {
     interval = 2e3,
@@ -9311,7 +10089,7 @@ function useSimulation(telemetry, updateTelemetryBatch, options = {}) {
     historyLength = 10,
     generateValue
   } = options;
-  useEffect14(() => {
+  useEffect15(() => {
     if (!enabled) return;
     const intervalId = setInterval(() => {
       const updates = [];
@@ -9361,6 +10139,7 @@ function useSimulation(telemetry, updateTelemetryBatch, options = {}) {
 }
 export {
   Button,
+  COLOR_PRESETS,
   CardHeader,
   CardUnit,
   CardValue,
@@ -9374,6 +10153,7 @@ export {
   DisplayModeToggle,
   EquipmentIndicator,
   EquipmentIndicatorWithSparkline,
+  FORCED_MARK_COLOR,
   FixedSVGContainer,
   FooterPanel,
   FullscreenContainer,
@@ -9389,6 +10169,7 @@ export {
   PanelTabs,
   RightPanel,
   RightToggleButton,
+  STATUS_LED_APPEARANCE,
   SVGArea,
   SVGLockedOverlay,
   ScrollableSVGWrapper,
@@ -9399,6 +10180,8 @@ export {
   ThemeProvider,
   ThemeToggle,
   TrendLine,
+  UNKNOWN_MARK_COLOR,
+  UNKNOWN_MARK_COLOR_DARK,
   ValueEntry,
   ZoomButton,
   ZoomControls,
@@ -9408,6 +10191,8 @@ export {
   exampleDiagram,
   exportDiagram,
   generateRoutePoints,
+  getAppearanceDefaults,
+  getAppearanceSchema,
   getAvailableSymbols,
   getPortWorldPosition,
   getSymbolDefinition,
@@ -9415,9 +10200,12 @@ export {
   mockSymbolLibrary,
   nodeHasPort,
   overlayStyles,
+  readAppearanceValue,
   registerSymbol,
   registerSymbols,
+  resolvePresetColor,
   resolveStatusColor,
+  useBooleanIndicators,
   useDeviceConfigs,
   useDeviceControls,
   useDrag,
@@ -9428,6 +10216,7 @@ export {
   useTelemetryStatus,
   useTheme,
   useViewBox,
-  validateDiagram
+  validateDiagram,
+  writeAppearanceValue
 };
 //# sourceMappingURL=index.js.map