@texturehq/edges 2.5.0 → 2.5.2

package/dist/{colors-CwPI5R2L.d.ts → colors-BbO4TbGH.d.ts}

@@ -2199,8 +2199,20 @@ type SerializableFieldFormat = Exclude<FieldFormat, {
  *                (e.g. transformer loading: SUM of downstream meter `kwh_usage`
  *                ÷ PF ÷ `ratedKva`, a 0–1 ratio the cell scales ×100). Consumers
  *                MUST treat this as async/loading and never block the card on it.
+ * - `scada`    — a live SCADA telemetry reading resolved from the element's
+ *                `TelemetrySource` (`externalId = '{'+elementGuid+'}'`). `points`
+ *                are the TelemetryPoint names to read, `reduce` collapses them
+ *                (`maxAbs` for three-phase current), `unit` is passed through,
+ *                and `sla` (ms) is the freshness window past which the reading
+ *                reads "as of {rel}", not live. Optional `ignore` lists numeric
+ *                sentinel values (e.g. `32767` on a tap-position phase) that are
+ *                treated as absent — skipped before the reduce and before the
+ *                freshness check, exactly as a `null` reading would be. Added in
+ *                MR-EN4; paired with the grid capability resolver. The gate is a
+ *                fresh point, not `ScadaGridNode` existence; a stale point never
+ *                blocks the card.
  *
- * No grid row uses `metadata`/`derived` yet — the design's grid metric proposal
+ * No grid row uses `metadata`/`derived`/`scada` yet — the design's grid metric proposal
  * is still "For review" (see MR-07). The type is extended now so those rows can
  * be authored honestly once design signs off; only `state` rows exist today.
  */
@@ -2214,6 +2226,13 @@ type MetricSource = {
     kind: "derived";
     rollup: "transformer-loading";
     window: "15m" | "1h" | "1d";
+} | {
+    kind: "scada";
+    points: string[];
+    reduce: "maxAbs" | "sum" | "first";
+    unit: string;
+    sla: number;
+    ignore?: number[];
 };
 /**
  * One headline metric shown by `entity.now`. A serializable declaration only —
@@ -2283,7 +2302,11 @@ interface GridStatFieldFormat {
  * the live block. See MR-07 "'has data' ≠ 'belongs in entity.now'".
  */
 interface GridStatField {
-    /** JSONB key in `GridElement.elementData`. */
+    /**
+     * Key in the element's resolved data. Usually a `GridElement.elementData`
+     * JSONB key; may also be a decoded top-level field the host merges in (e.g.
+     * `capacityKva`, the decoded transformer kVA rating).
+     */
     key: string;
     /** Display label (translation key or plain text). */
     label: string;
@@ -2447,45 +2470,21 @@ declare const ABSENT_GRID_FIELDS: readonly ["energized", "customerName", "gs_max
  */
 declare const GRID_STAT_LIST: {
     readonly TRANSFORMER: [{
-        readonly key: "primaryRatedVoltage";
-        readonly label: "Primary Voltage";
+        readonly key: "capacityKva";
+        readonly label: "kVA Rating";
         readonly format: {
-            readonly type: "voltage";
-            readonly unit: "V";
+            readonly type: "power";
+            readonly unit: "kVA";
             readonly decimals: 0;
         };
     }, {
-        readonly key: "ratedOutputVoltage";
-        readonly label: "Output Voltage";
+        readonly key: "primaryRatedVoltage";
+        readonly label: "Primary Voltage";
         readonly format: {
             readonly type: "voltage";
             readonly unit: "V";
             readonly decimals: 0;
         };
-    }, {
-        readonly key: "tranKvaA";
-        readonly label: "Rating Phase A";
-        readonly format: {
-            readonly type: "power";
-            readonly unit: "kVA";
-            readonly decimals: 1;
-        };
-    }, {
-        readonly key: "tranKvaB";
-        readonly label: "Rating Phase B";
-        readonly format: {
-            readonly type: "power";
-            readonly unit: "kVA";
-            readonly decimals: 1;
-        };
-    }, {
-        readonly key: "tranKvaC";
-        readonly label: "Rating Phase C";
-        readonly format: {
-            readonly type: "power";
-            readonly unit: "kVA";
-            readonly decimals: 1;
-        };
     }];
     readonly CONSUMER: [{
         readonly key: "meterNumber";
@@ -3075,45 +3074,21 @@ declare const ENTITY_CONFIG: {
         readonly detailPage: true;
         readonly properties: {
             readonly statList: [{
-                readonly key: "primaryRatedVoltage";
-                readonly label: "Primary Voltage";
+                readonly key: "capacityKva";
+                readonly label: "kVA Rating";
                 readonly format: {
-                    readonly type: "voltage";
-                    readonly unit: "V";
+                    readonly type: "power";
+                    readonly unit: "kVA";
                     readonly decimals: 0;
                 };
             }, {
-                readonly key: "ratedOutputVoltage";
-                readonly label: "Output Voltage";
+                readonly key: "primaryRatedVoltage";
+                readonly label: "Primary Voltage";
                 readonly format: {
                     readonly type: "voltage";
                     readonly unit: "V";
                     readonly decimals: 0;
                 };
-            }, {
-                readonly key: "tranKvaA";
-                readonly label: "Rating Phase A";
-                readonly format: {
-                    readonly type: "power";
-                    readonly unit: "kVA";
-                    readonly decimals: 1;
-                };
-            }, {
-                readonly key: "tranKvaB";
-                readonly label: "Rating Phase B";
-                readonly format: {
-                    readonly type: "power";
-                    readonly unit: "kVA";
-                    readonly decimals: 1;
-                };
-            }, {
-                readonly key: "tranKvaC";
-                readonly label: "Rating Phase C";
-                readonly format: {
-                    readonly type: "power";
-                    readonly unit: "kVA";
-                    readonly decimals: 1;
-                };
             }];
         };
         readonly label: {

package/dist/{colors-Jvcd1uiH.d.cts → colors-fisZABpX.d.cts}

@@ -2199,8 +2199,20 @@ type SerializableFieldFormat = Exclude<FieldFormat, {
  *                (e.g. transformer loading: SUM of downstream meter `kwh_usage`
  *                ÷ PF ÷ `ratedKva`, a 0–1 ratio the cell scales ×100). Consumers
  *                MUST treat this as async/loading and never block the card on it.
+ * - `scada`    — a live SCADA telemetry reading resolved from the element's
+ *                `TelemetrySource` (`externalId = '{'+elementGuid+'}'`). `points`
+ *                are the TelemetryPoint names to read, `reduce` collapses them
+ *                (`maxAbs` for three-phase current), `unit` is passed through,
+ *                and `sla` (ms) is the freshness window past which the reading
+ *                reads "as of {rel}", not live. Optional `ignore` lists numeric
+ *                sentinel values (e.g. `32767` on a tap-position phase) that are
+ *                treated as absent — skipped before the reduce and before the
+ *                freshness check, exactly as a `null` reading would be. Added in
+ *                MR-EN4; paired with the grid capability resolver. The gate is a
+ *                fresh point, not `ScadaGridNode` existence; a stale point never
+ *                blocks the card.
  *
- * No grid row uses `metadata`/`derived` yet — the design's grid metric proposal
+ * No grid row uses `metadata`/`derived`/`scada` yet — the design's grid metric proposal
  * is still "For review" (see MR-07). The type is extended now so those rows can
  * be authored honestly once design signs off; only `state` rows exist today.
  */
@@ -2214,6 +2226,13 @@ type MetricSource = {
     kind: "derived";
     rollup: "transformer-loading";
     window: "15m" | "1h" | "1d";
+} | {
+    kind: "scada";
+    points: string[];
+    reduce: "maxAbs" | "sum" | "first";
+    unit: string;
+    sla: number;
+    ignore?: number[];
 };
 /**
  * One headline metric shown by `entity.now`. A serializable declaration only —
@@ -2283,7 +2302,11 @@ interface GridStatFieldFormat {
  * the live block. See MR-07 "'has data' ≠ 'belongs in entity.now'".
  */
 interface GridStatField {
-    /** JSONB key in `GridElement.elementData`. */
+    /**
+     * Key in the element's resolved data. Usually a `GridElement.elementData`
+     * JSONB key; may also be a decoded top-level field the host merges in (e.g.
+     * `capacityKva`, the decoded transformer kVA rating).
+     */
     key: string;
     /** Display label (translation key or plain text). */
     label: string;
@@ -2447,45 +2470,21 @@ declare const ABSENT_GRID_FIELDS: readonly ["energized", "customerName", "gs_max
  */
 declare const GRID_STAT_LIST: {
     readonly TRANSFORMER: [{
-        readonly key: "primaryRatedVoltage";
-        readonly label: "Primary Voltage";
+        readonly key: "capacityKva";
+        readonly label: "kVA Rating";
         readonly format: {
-            readonly type: "voltage";
-            readonly unit: "V";
+            readonly type: "power";
+            readonly unit: "kVA";
             readonly decimals: 0;
         };
     }, {
-        readonly key: "ratedOutputVoltage";
-        readonly label: "Output Voltage";
+        readonly key: "primaryRatedVoltage";
+        readonly label: "Primary Voltage";
         readonly format: {
             readonly type: "voltage";
             readonly unit: "V";
             readonly decimals: 0;
         };
-    }, {
-        readonly key: "tranKvaA";
-        readonly label: "Rating Phase A";
-        readonly format: {
-            readonly type: "power";
-            readonly unit: "kVA";
-            readonly decimals: 1;
-        };
-    }, {
-        readonly key: "tranKvaB";
-        readonly label: "Rating Phase B";
-        readonly format: {
-            readonly type: "power";
-            readonly unit: "kVA";
-            readonly decimals: 1;
-        };
-    }, {
-        readonly key: "tranKvaC";
-        readonly label: "Rating Phase C";
-        readonly format: {
-            readonly type: "power";
-            readonly unit: "kVA";
-            readonly decimals: 1;
-        };
     }];
     readonly CONSUMER: [{
         readonly key: "meterNumber";
@@ -3075,45 +3074,21 @@ declare const ENTITY_CONFIG: {
         readonly detailPage: true;
         readonly properties: {
             readonly statList: [{
-                readonly key: "primaryRatedVoltage";
-                readonly label: "Primary Voltage";
+                readonly key: "capacityKva";
+                readonly label: "kVA Rating";
                 readonly format: {
-                    readonly type: "voltage";
-                    readonly unit: "V";
+                    readonly type: "power";
+                    readonly unit: "kVA";
                     readonly decimals: 0;
                 };
             }, {
-                readonly key: "ratedOutputVoltage";
-                readonly label: "Output Voltage";
+                readonly key: "primaryRatedVoltage";
+                readonly label: "Primary Voltage";
                 readonly format: {
                     readonly type: "voltage";
                     readonly unit: "V";
                     readonly decimals: 0;
                 };
-            }, {
-                readonly key: "tranKvaA";
-                readonly label: "Rating Phase A";
-                readonly format: {
-                    readonly type: "power";
-                    readonly unit: "kVA";
-                    readonly decimals: 1;
-                };
-            }, {
-                readonly key: "tranKvaB";
-                readonly label: "Rating Phase B";
-                readonly format: {
-                    readonly type: "power";
-                    readonly unit: "kVA";
-                    readonly decimals: 1;
-                };
-            }, {
-                readonly key: "tranKvaC";
-                readonly label: "Rating Phase C";
-                readonly format: {
-                    readonly type: "power";
-                    readonly unit: "kVA";
-                    readonly decimals: 1;
-                };
             }];
         };
         readonly label: {