@texturehq/edges 2.4.6 → 2.4.8

package/dist/{colors-B8z56mNG.d.cts → colors-Aab3l13k.d.cts}

@@ -2117,6 +2117,139 @@ declare const TextLink: ({ href, children, className, external, title, variant,
 /** Grouping for an entity. Lets surfaces section grid elements and devices
  *  apart from core platform objects. */
 type EntityCategory = "platform" | "grid" | "device";
+/**
+ * The base page composition an entity renders with. Thirty in-scope entities
+ * share these five compositions — the per-entity variation is which blocks
+ * appear (driven by this config), not per-entity page code.
+ *
+ * - `device`         — Battery, EV Charger, Inverter, Thermostat, EV, Water Heater.
+ *                      Leads with `entity.now` (live state + headline metrics).
+ * - `platform`       — Site, Customer. No `Now` block.
+ * - `grid-energized` — energized grid equipment (Transformer, Recloser, Meter…).
+ * - `grid-line`      — lines & structures (overhead/underground spans, support structures).
+ *
+ * Matches the design's coverage matrix (DESIGN-REFERENCE.md §2). Every entry in
+ * `ENTITY_CONFIG` carries an archetype, even the 12 that have no detail page —
+ * the archetype is the composition it *would* use; `detailPage` gates whether a
+ * page is actually reachable.
+ */
+type EntityArchetype = "device" | "platform" | "grid-energized" | "grid-line";
+/**
+ * A serializable `FieldFormat`. `entity.now` and every block that consumes a
+ * config must be JSON-serializable (the core block contract forbids functions
+ * in props), so the function-carrying `custom` format variant is excluded here
+ * at the type level — a metric can never smuggle a `formatter` into the registry.
+ */
+type SerializableFieldFormat = Exclude<FieldFormat, {
+    type: "custom";
+}>;
+/**
+ * Where a headline metric's value comes from — its provenance. A pure-data
+ * discriminated union (no functions), so the whole registry stays
+ * JSON-serializable. Added in MR-07: MR-06's `HeadlineMetric` could only express
+ * a dot-path into a resolved *device* snapshot; grid metrics are either static
+ * nameplate (a JSONB `elementData` key) or a derived telemetry rollup, and
+ * authoring those against a bare `path` would misrepresent how they are fetched.
+ *
+ * - `state`    — device snapshot, resolved from a dot-path (the MR-06 shape).
+ *                e.g. `state.gridPower`. This is what every device/meter row uses.
+ * - `metadata` — a static nameplate value read from `GridElement.elementData`
+ *                (JSONB). The `key` is the JSONB key, *not* a dot-path.
+ * - `derived`  — an asynchronous telemetry rollup with hours-to-a-day latency
+ *                (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.
+ *
+ * No grid row uses `metadata`/`derived` 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.
+ */
+type MetricSource = {
+    kind: "state";
+    path: string;
+} | {
+    kind: "metadata";
+    key: string;
+} | {
+    kind: "derived";
+    rollup: "transformer-loading";
+    window: "15m" | "1h" | "1d";
+};
+/**
+ * One headline metric shown by `entity.now`. A serializable declaration only —
+ * `source` says where the value comes from (see `MetricSource`), `label` is a
+ * translation key, `format` says how to render the value, and `icon` is a
+ * registry key (never a component). No functions: the host resolves the source
+ * and format at render.
+ *
+ * The shape is the serializable subset of `device-config`'s `FieldConfig`
+ * (`id`/`label`/`source`/`format`/`icon`) — `showWhen`/`resolver`/`custom`
+ * formatters are intentionally dropped. MR-07 replaced the bare `path` with a
+ * `source` discriminator; a `state` source carries the former dot-path as
+ * `source.path`, so no device row changed meaning.
+ */
+interface HeadlineMetric {
+    /** Stable identifier for the metric (unique within an entity). */
+    id: string;
+    /** Translation key for the display label. */
+    label: string;
+    /** Where the value comes from (device snapshot, nameplate, or rollup). */
+    source: MetricSource;
+    /** How to render the value. Serializable formats only. */
+    format: SerializableFieldFormat;
+    /** Optional icon registry key. */
+    icon?: IconName;
+}
+/**
+ * A serializable rule for deriving a display state from resolved entity data.
+ * Mirrors `device-config`'s `StateRule` but drops the optional `resolver`
+ * function so the registry stays JSON-serializable. `mapping` maps a raw field
+ * value to a display-state token; `fallback` is used when the field is
+ * missing/unmapped.
+ */
+interface EntityStateRule {
+    /** Dot-path to the source field in the resolved entity data. */
+    fieldPath: string;
+    /** Raw-value → display-state-token map. */
+    mapping: Record<string, string>;
+    /** State token to use when the field is missing or unmapped. */
+    fallback: string;
+    /** Optional translation key for the state's display label. */
+    label?: string;
+}
+/**
+ * The render format for a static grid property. This is the serializable subset
+ * of `@texturehq/grid-element-config`'s `MetadataFieldConfig["format"]` — the
+ * same shape, kept structurally identical so the two stay in sync when stat-list
+ * rows are transcribed. Deliberately *not* `SerializableFieldFormat`: nameplate
+ * ratings carry units the edges `FieldFormat` unit enums don't admit (e.g. a
+ * transformer's `kVA`, a capacitor's `kVar`), so `unit` is a free string here.
+ */
+interface GridStatFieldFormat {
+    type: "voltage" | "power" | "distance" | "text" | "number";
+    unit?: string;
+    decimals?: number;
+}
+/**
+ * One row in a grid entity's static-properties (`data.stat-list`) block. A
+ * serializable declaration transcribed from `grid-element-config.metadataFields`
+ * (MR-07 step 2): `key` is the `GridElement.elementData` JSONB key, `label` is
+ * the display label, `format` says how to render it. The source config's
+ * `showWhen` predicate is intentionally dropped — a stat-list row is data only,
+ * and per-instance visibility is a render-time concern, not registry state.
+ *
+ * This is nameplate, not "now": static properties (kVA rating, conductor type,
+ * meter number, length) belong here, never in `fields.headlineMetrics`, which is
+ * the live block. See MR-07 "'has data' ≠ 'belongs in entity.now'".
+ */
+interface GridStatField {
+    /** JSONB key in `GridElement.elementData`. */
+    key: string;
+    /** Display label (translation key or plain text). */
+    label: string;
+    /** How to render the value. Optional — plain text when omitted. */
+    format?: GridStatFieldFormat;
+}
 interface EntityConfig {
     /** Phosphor icon name. The canonical (resting / default) glyph. For switchable
      *  elements this mirrors `states.closed.icon` (or the base glyph when the
@@ -2145,6 +2278,53 @@ interface EntityConfig {
         open: EntityStateVariant;
         closed: EntityStateVariant;
     };
+    /**
+     * The base page composition this entity renders with. Required on all 42
+     * entries — the archetype is the composition an entity *would* use even when
+     * `detailPage` is false.
+     */
+    archetype: EntityArchetype;
+    /**
+     * Whether this entity has a reachable detail page. 30 of 42 are `true`; the
+     * registry is the single answer to "does this entity have a page?".
+     */
+    detailPage: boolean;
+    /**
+     * `entity.now` field config. Present only for entities that show a `Now`
+     * block (devices with a `device-config` source, plus Meter). Absent means
+     * `entity.now` declines to render — grid elements omit this until the design's
+     * (currently "For review") metric proposal is approved, and Site/Customer
+     * omit it because their composition has no `Now` block.
+     */
+    fields?: {
+        /**
+         * The 2–4 headline metrics `entity.now` shows. The cell count adapts across
+         * that range; the bound is enforced by the conformance test, not just docs.
+         */
+        headlineMetrics: HeadlineMetric[];
+    };
+    /**
+     * State rules for `entity.now`'s status chips. `primaryState` drives the
+     * pulsing primary chip; `secondaryState` (battery/inverter: charge + grid)
+     * renders a second chip with no pulse.
+     */
+    stateRules?: {
+        primaryState: EntityStateRule;
+        secondaryState?: EntityStateRule;
+    };
+    /**
+     * Static-properties block config (MR-07 step 2). Feeds the `data.stat-list`
+     * block — nameplate/GIS attributes that are *properties*, not *now*. Present
+     * on grid entities (transcribed from `grid-element-config.metadataFields` via
+     * `GRID_ELEMENT_TYPE_BY_ENTITY`); absent on devices and platform objects,
+     * which surface their data through other blocks. This is the genuinely
+     * unblocked, data-backed grid path — distinct from the design-gated live
+     * `fields`/`stateRules` above.
+     */
+    properties?: {
+        /** The static property rows shown by the `data.stat-list` block. */
+        statList: GridStatField[];
+    };
 }
 /** One open/closed state's presentation: an optional glyph override and/or a
  *  status color. Omitting `icon` means "use the entity's base icon, recolored". */
@@ -2200,10 +2380,282 @@ declare const ENTITY_CATEGORY_CONFIG: {
         readonly order: 2;
     };
 };
+/** The coarse element-type axis (mirrors `@texturehq/grid-element-config`'s
+ *  `GridElementType`; kept in sync by transcription). */
+type GridElementSourceType = "CAPACITOR" | "CONSUMER" | "GENERATOR" | "MOTOR" | "NODE" | "OVERCURRENT_DEVICE" | "OVERHEAD_LINE" | "REGULATOR" | "SOURCE" | "SWITCH" | "TRANSFORMER" | "UNDERGROUND_LINE";
+/**
+ * JSONB keys that are ABSENT or PII-zeroed in prod (MR-07 coverage table). No
+ * grid stat-list row (or headline metric) may reference one of these — enforced
+ * by the conformance test, not just documented.
+ */
+declare const ABSENT_GRID_FIELDS: readonly ["energized", "customerName", "gs_max_continuous_current"];
+/**
+ * Static property rows per `GridElementType`, transcribed from
+ * `grid-element-config/src/configs/*.config.ts` `metadataFields`. Serializable:
+ * no `showWhen`, no functions. Referenced by grid entities' `properties.statList`.
+ */
+declare const GRID_STAT_LIST: {
+    readonly TRANSFORMER: [{
+        readonly key: "primaryRatedVoltage";
+        readonly label: "Primary Voltage";
+        readonly format: {
+            readonly type: "voltage";
+            readonly unit: "V";
+            readonly decimals: 0;
+        };
+    }, {
+        readonly key: "ratedOutputVoltage";
+        readonly label: "Output 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";
+        readonly label: "Meter Number";
+        readonly format: {
+            readonly type: "text";
+        };
+    }];
+    readonly SOURCE: [{
+        readonly key: "busVoltage";
+        readonly label: "Bus Voltage";
+        readonly format: {
+            readonly type: "voltage";
+            readonly unit: "V";
+            readonly decimals: 0;
+        };
+    }, {
+        readonly key: "nominalVoltage";
+        readonly label: "Nominal Voltage";
+        readonly format: {
+            readonly type: "voltage";
+            readonly unit: "V";
+            readonly decimals: 0;
+        };
+    }, {
+        readonly key: "substationNumber";
+        readonly label: "Substation Number";
+        readonly format: {
+            readonly type: "text";
+        };
+    }];
+    readonly SWITCH: [{
+        readonly key: "switchId";
+        readonly label: "Switch ID";
+        readonly format: {
+            readonly type: "text";
+        };
+    }, {
+        readonly key: "ratedCurrent";
+        readonly label: "Rated Current";
+        readonly format: {
+            readonly type: "number";
+            readonly unit: "A";
+            readonly decimals: 0;
+        };
+    }, {
+        readonly key: "normalState";
+        readonly label: "Normal State";
+        readonly format: {
+            readonly type: "text";
+        };
+    }];
+    readonly CAPACITOR: [{
+        readonly key: "unitSizeKvar";
+        readonly label: "Capacity";
+        readonly format: {
+            readonly type: "power";
+            readonly unit: "kVar";
+            readonly decimals: 1;
+        };
+    }, {
+        readonly key: "nominalVoltage";
+        readonly label: "Nominal Voltage";
+        readonly format: {
+            readonly type: "voltage";
+            readonly unit: "V";
+            readonly decimals: 0;
+        };
+    }];
+    readonly OVERCURRENT_DEVICE: [{
+        readonly key: "ratedCurrent";
+        readonly label: "Rated Current";
+        readonly format: {
+            readonly type: "number";
+            readonly unit: "A";
+            readonly decimals: 0;
+        };
+    }, {
+        readonly key: "deviceType";
+        readonly label: "Device Type";
+        readonly format: {
+            readonly type: "text";
+        };
+    }];
+    readonly REGULATOR: [{
+        readonly key: "outputVoltagePhA";
+        readonly label: "Output Voltage Phase A";
+        readonly format: {
+            readonly type: "voltage";
+            readonly unit: "V";
+            readonly decimals: 0;
+        };
+    }, {
+        readonly key: "outputVoltagePhB";
+        readonly label: "Output Voltage Phase B";
+        readonly format: {
+            readonly type: "voltage";
+            readonly unit: "V";
+            readonly decimals: 0;
+        };
+    }, {
+        readonly key: "outputVoltagePhC";
+        readonly label: "Output Voltage Phase C";
+        readonly format: {
+            readonly type: "voltage";
+            readonly unit: "V";
+            readonly decimals: 0;
+        };
+    }, {
+        readonly key: "ratedPower";
+        readonly label: "Rated Power";
+        readonly format: {
+            readonly type: "power";
+            readonly unit: "kVA";
+            readonly decimals: 1;
+        };
+    }];
+    readonly OVERHEAD_LINE: [{
+        readonly key: "impedanceLength";
+        readonly label: "Length";
+        readonly format: {
+            readonly type: "distance";
+            readonly unit: "ft";
+            readonly decimals: 0;
+        };
+    }, {
+        readonly key: "conductorDescPhA";
+        readonly label: "Conductor Phase A";
+        readonly format: {
+            readonly type: "text";
+        };
+    }, {
+        readonly key: "conductorDescPhB";
+        readonly label: "Conductor Phase B";
+        readonly format: {
+            readonly type: "text";
+        };
+    }, {
+        readonly key: "conductorDescPhC";
+        readonly label: "Conductor Phase C";
+        readonly format: {
+            readonly type: "text";
+        };
+    }];
+    readonly UNDERGROUND_LINE: [{
+        readonly key: "impedanceLength";
+        readonly label: "Length";
+        readonly format: {
+            readonly type: "distance";
+            readonly unit: "ft";
+            readonly decimals: 0;
+        };
+    }, {
+        readonly key: "conductorDescPhA";
+        readonly label: "Conductor Phase A";
+        readonly format: {
+            readonly type: "text";
+        };
+    }, {
+        readonly key: "conductorDescPhB";
+        readonly label: "Conductor Phase B";
+        readonly format: {
+            readonly type: "text";
+        };
+    }, {
+        readonly key: "conductorDescPhC";
+        readonly label: "Conductor Phase C";
+        readonly format: {
+            readonly type: "text";
+        };
+    }];
+    readonly NODE: [{
+        readonly key: "nominalVoltage";
+        readonly label: "Nominal Voltage";
+        readonly format: {
+            readonly type: "voltage";
+            readonly unit: "V";
+            readonly decimals: 0;
+        };
+    }];
+    readonly GENERATOR: [{
+        readonly key: "ratedPower";
+        readonly label: "Rated Power";
+        readonly format: {
+            readonly type: "power";
+            readonly unit: "kW";
+            readonly decimals: 1;
+        };
+    }, {
+        readonly key: "outputVoltage";
+        readonly label: "Output Voltage";
+        readonly format: {
+            readonly type: "voltage";
+            readonly unit: "V";
+            readonly decimals: 0;
+        };
+    }];
+    readonly MOTOR: [{
+        readonly key: "ratedPower";
+        readonly label: "Rated Power";
+        readonly format: {
+            readonly type: "power";
+            readonly unit: "kW";
+            readonly decimals: 1;
+        };
+    }, {
+        readonly key: "voltage";
+        readonly label: "Voltage";
+        readonly format: {
+            readonly type: "voltage";
+            readonly unit: "V";
+            readonly decimals: 0;
+        };
+    }];
+};
 declare const ENTITY_CONFIG: {
     readonly app: {
         readonly icon: "AppWindow";
         readonly category: "platform";
+        readonly archetype: "platform";
+        readonly detailPage: false;
         readonly label: {
             readonly singular: "App";
             readonly plural: "Apps";
@@ -2213,6 +2665,8 @@ declare const ENTITY_CONFIG: {
     readonly site: {
         readonly icon: "MapPin";
         readonly category: "platform";
+        readonly archetype: "platform";
+        readonly detailPage: true;
         readonly label: {
             readonly singular: "Site";
             readonly plural: "Sites";
@@ -2222,6 +2676,8 @@ declare const ENTITY_CONFIG: {
     readonly device: {
         readonly icon: "ShareNetwork";
         readonly category: "platform";
+        readonly archetype: "platform";
+        readonly detailPage: false;
         readonly label: {
             readonly singular: "Device";
             readonly plural: "Devices";
@@ -2231,6 +2687,8 @@ declare const ENTITY_CONFIG: {
     readonly customer: {
         readonly icon: "Users";
         readonly category: "platform";
+        readonly archetype: "platform";
+        readonly detailPage: true;
         readonly label: {
             readonly singular: "Customer";
             readonly plural: "Customers";
@@ -2240,6 +2698,8 @@ declare const ENTITY_CONFIG: {
     readonly contact: {
         readonly icon: "Users";
         readonly category: "platform";
+        readonly archetype: "platform";
+        readonly detailPage: false;
         readonly label: {
             readonly singular: "Contact";
             readonly plural: "Contacts";
@@ -2249,6 +2709,8 @@ declare const ENTITY_CONFIG: {
     readonly program: {
         readonly icon: "ClipboardText";
         readonly category: "platform";
+        readonly archetype: "platform";
+        readonly detailPage: false;
         readonly label: {
             readonly singular: "Program";
             readonly plural: "Programs";
@@ -2258,6 +2720,8 @@ declare const ENTITY_CONFIG: {
     readonly workflow: {
         readonly icon: "FlowArrow";
         readonly category: "platform";
+        readonly archetype: "platform";
+        readonly detailPage: false;
         readonly label: {
             readonly singular: "Workflow";
             readonly plural: "Workflows";
@@ -2267,6 +2731,8 @@ declare const ENTITY_CONFIG: {
     readonly collection: {
         readonly icon: "Stack";
         readonly category: "platform";
+        readonly archetype: "platform";
+        readonly detailPage: false;
         readonly label: {
             readonly singular: "Collection";
             readonly plural: "Collections";
@@ -2276,6 +2742,8 @@ declare const ENTITY_CONFIG: {
     readonly board: {
         readonly icon: "SquaresFour";
         readonly category: "platform";
+        readonly archetype: "platform";
+        readonly detailPage: false;
         readonly label: {
             readonly singular: "Board";
             readonly plural: "Boards";
@@ -2285,6 +2753,8 @@ declare const ENTITY_CONFIG: {
     readonly report: {
         readonly icon: "ChartLine";
         readonly category: "platform";
+        readonly archetype: "platform";
+        readonly detailPage: false;
         readonly label: {
             readonly singular: "Report";
             readonly plural: "Reports";
@@ -2294,6 +2764,8 @@ declare const ENTITY_CONFIG: {
     readonly event: {
         readonly icon: "ClockCounterClockwise";
         readonly category: "platform";
+        readonly archetype: "platform";
+        readonly detailPage: false;
         readonly label: {
             readonly singular: "Event";
             readonly plural: "Events";
@@ -2303,6 +2775,8 @@ declare const ENTITY_CONFIG: {
     readonly alert: {
         readonly icon: "Warning";
         readonly category: "platform";
+        readonly archetype: "platform";
+        readonly detailPage: false;
         readonly label: {
             readonly singular: "Alert";
             readonly plural: "Alerts";
@@ -2312,6 +2786,8 @@ declare const ENTITY_CONFIG: {
     readonly monitor: {
         readonly icon: "Pulse";
         readonly category: "platform";
+        readonly archetype: "platform";
+        readonly detailPage: false;
         readonly label: {
             readonly singular: "Monitor";
             readonly plural: "Monitors";
@@ -2321,6 +2797,8 @@ declare const ENTITY_CONFIG: {
     readonly command: {
         readonly icon: "Play";
         readonly category: "platform";
+        readonly archetype: "platform";
+        readonly detailPage: false;
         readonly label: {
             readonly singular: "Command";
             readonly plural: "Commands";
@@ -2330,6 +2808,33 @@ declare const ENTITY_CONFIG: {
     readonly source: {
         readonly icon: "TextureSource";
         readonly category: "grid";
+        readonly archetype: "grid-energized";
+        readonly detailPage: true;
+        readonly properties: {
+            readonly statList: [{
+                readonly key: "busVoltage";
+                readonly label: "Bus Voltage";
+                readonly format: {
+                    readonly type: "voltage";
+                    readonly unit: "V";
+                    readonly decimals: 0;
+                };
+            }, {
+                readonly key: "nominalVoltage";
+                readonly label: "Nominal Voltage";
+                readonly format: {
+                    readonly type: "voltage";
+                    readonly unit: "V";
+                    readonly decimals: 0;
+                };
+            }, {
+                readonly key: "substationNumber";
+                readonly label: "Substation Number";
+                readonly format: {
+                    readonly type: "text";
+                };
+            }];
+        };
         readonly label: {
             readonly singular: "Source";
             readonly plural: "Sources";
@@ -2339,6 +2844,33 @@ declare const ENTITY_CONFIG: {
     readonly substation: {
         readonly icon: "TextureSource";
         readonly category: "grid";
+        readonly archetype: "grid-energized";
+        readonly detailPage: true;
+        readonly properties: {
+            readonly statList: [{
+                readonly key: "busVoltage";
+                readonly label: "Bus Voltage";
+                readonly format: {
+                    readonly type: "voltage";
+                    readonly unit: "V";
+                    readonly decimals: 0;
+                };
+            }, {
+                readonly key: "nominalVoltage";
+                readonly label: "Nominal Voltage";
+                readonly format: {
+                    readonly type: "voltage";
+                    readonly unit: "V";
+                    readonly decimals: 0;
+                };
+            }, {
+                readonly key: "substationNumber";
+                readonly label: "Substation Number";
+                readonly format: {
+                    readonly type: "text";
+                };
+            }];
+        };
         readonly label: {
             readonly singular: "Substation";
             readonly plural: "Substations";
@@ -2348,6 +2880,27 @@ declare const ENTITY_CONFIG: {
     readonly capacitor: {
         readonly icon: "TextureCapacitor";
         readonly category: "grid";
+        readonly archetype: "grid-energized";
+        readonly detailPage: true;
+        readonly properties: {
+            readonly statList: [{
+                readonly key: "unitSizeKvar";
+                readonly label: "Capacity";
+                readonly format: {
+                    readonly type: "power";
+                    readonly unit: "kVar";
+                    readonly decimals: 1;
+                };
+            }, {
+                readonly key: "nominalVoltage";
+                readonly label: "Nominal Voltage";
+                readonly format: {
+                    readonly type: "voltage";
+                    readonly unit: "V";
+                    readonly decimals: 0;
+                };
+            }];
+        };
         readonly label: {
             readonly singular: "Capacitor";
             readonly plural: "Capacitors";
@@ -2357,6 +2910,31 @@ declare const ENTITY_CONFIG: {
     readonly switch: {
         readonly icon: "TextureSwitchClosed";
         readonly category: "grid";
+        readonly archetype: "grid-energized";
+        readonly detailPage: true;
+        readonly properties: {
+            readonly statList: [{
+                readonly key: "switchId";
+                readonly label: "Switch ID";
+                readonly format: {
+                    readonly type: "text";
+                };
+            }, {
+                readonly key: "ratedCurrent";
+                readonly label: "Rated Current";
+                readonly format: {
+                    readonly type: "number";
+                    readonly unit: "A";
+                    readonly decimals: 0;
+                };
+            }, {
+                readonly key: "normalState";
+                readonly label: "Normal State";
+                readonly format: {
+                    readonly type: "text";
+                };
+            }];
+        };
         readonly label: {
             readonly singular: "Switch";
             readonly plural: "Switches";
@@ -2376,6 +2954,31 @@ declare const ENTITY_CONFIG: {
     readonly sectionalizer: {
         readonly icon: "TextureSectionalizerClosed";
         readonly category: "grid";
+        readonly archetype: "grid-energized";
+        readonly detailPage: true;
+        readonly properties: {
+            readonly statList: [{
+                readonly key: "switchId";
+                readonly label: "Switch ID";
+                readonly format: {
+                    readonly type: "text";
+                };
+            }, {
+                readonly key: "ratedCurrent";
+                readonly label: "Rated Current";
+                readonly format: {
+                    readonly type: "number";
+                    readonly unit: "A";
+                    readonly decimals: 0;
+                };
+            }, {
+                readonly key: "normalState";
+                readonly label: "Normal State";
+                readonly format: {
+                    readonly type: "text";
+                };
+            }];
+        };
         readonly label: {
             readonly singular: "Sectionalizer";
             readonly plural: "Sectionalizers";
@@ -2395,6 +2998,19 @@ declare const ENTITY_CONFIG: {
     readonly relay: {
         readonly icon: "Cpu";
         readonly category: "grid";
+        readonly archetype: "grid-energized";
+        readonly detailPage: true;
+        readonly properties: {
+            readonly statList: [{
+                readonly key: "nominalVoltage";
+                readonly label: "Nominal Voltage";
+                readonly format: {
+                    readonly type: "voltage";
+                    readonly unit: "V";
+                    readonly decimals: 0;
+                };
+            }];
+        };
         readonly label: {
             readonly singular: "Relay";
             readonly plural: "Relays";
@@ -2404,6 +3020,51 @@ declare const ENTITY_CONFIG: {
     readonly transformer: {
         readonly icon: "TextureTransformer";
         readonly category: "grid";
+        readonly archetype: "grid-energized";
+        readonly detailPage: true;
+        readonly properties: {
+            readonly statList: [{
+                readonly key: "primaryRatedVoltage";
+                readonly label: "Primary Voltage";
+                readonly format: {
+                    readonly type: "voltage";
+                    readonly unit: "V";
+                    readonly decimals: 0;
+                };
+            }, {
+                readonly key: "ratedOutputVoltage";
+                readonly label: "Output 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: {
             readonly singular: "Transformer";
             readonly plural: "Transformers";
@@ -2413,15 +3074,66 @@ declare const ENTITY_CONFIG: {
     readonly meter: {
         readonly icon: "Gauge";
         readonly category: "grid";
+        readonly archetype: "grid-energized";
+        readonly detailPage: true;
+        readonly properties: {
+            readonly statList: [{
+                readonly key: "meterNumber";
+                readonly label: "Meter Number";
+                readonly format: {
+                    readonly type: "text";
+                };
+            }];
+        };
         readonly label: {
             readonly singular: "Meter";
             readonly plural: "Meters";
         };
         readonly description: "Revenue meter at the point of consumption";
+        readonly fields: {
+            readonly headlineMetrics: [{
+                readonly id: "power";
+                readonly label: "device.meter.fields.power";
+                readonly source: {
+                    readonly kind: "state";
+                    readonly path: "state.phaseARealPower";
+                };
+                readonly format: {
+                    readonly type: "power";
+                    readonly unit: "kW";
+                    readonly decimals: 2;
+                };
+                readonly icon: "Pulse";
+            }, {
+                readonly id: "consumption";
+                readonly label: "device.meter.fields.consumption";
+                readonly source: {
+                    readonly kind: "state";
+                    readonly path: "state.latestKwhUsage";
+                };
+                readonly format: {
+                    readonly type: "energy";
+                    readonly sourceUnit: "kWh";
+                    readonly decimals: 2;
+                };
+                readonly icon: "Lightning";
+            }];
+        };
     };
     readonly consumer: {
         readonly icon: "Gauge";
         readonly category: "grid";
+        readonly archetype: "grid-energized";
+        readonly detailPage: true;
+        readonly properties: {
+            readonly statList: [{
+                readonly key: "meterNumber";
+                readonly label: "Meter Number";
+                readonly format: {
+                    readonly type: "text";
+                };
+            }];
+        };
         readonly label: {
             readonly singular: "Consumer";
             readonly plural: "Consumers";
@@ -2431,6 +3143,37 @@ declare const ENTITY_CONFIG: {
     readonly singlePhaseOverheadLine: {
         readonly icon: "TextureSinglePhaseOverheadLine";
         readonly category: "grid";
+        readonly archetype: "grid-line";
+        readonly detailPage: true;
+        readonly properties: {
+            readonly statList: [{
+                readonly key: "impedanceLength";
+                readonly label: "Length";
+                readonly format: {
+                    readonly type: "distance";
+                    readonly unit: "ft";
+                    readonly decimals: 0;
+                };
+            }, {
+                readonly key: "conductorDescPhA";
+                readonly label: "Conductor Phase A";
+                readonly format: {
+                    readonly type: "text";
+                };
+            }, {
+                readonly key: "conductorDescPhB";
+                readonly label: "Conductor Phase B";
+                readonly format: {
+                    readonly type: "text";
+                };
+            }, {
+                readonly key: "conductorDescPhC";
+                readonly label: "Conductor Phase C";
+                readonly format: {
+                    readonly type: "text";
+                };
+            }];
+        };
         readonly label: {
             readonly singular: "Single-Phase Overhead Line";
             readonly plural: "Single-Phase Overhead Lines";
@@ -2440,6 +3183,37 @@ declare const ENTITY_CONFIG: {
     readonly twoPhaseOverheadLine: {
         readonly icon: "TextureTwoPhaseOverheadLine";
         readonly category: "grid";
+        readonly archetype: "grid-line";
+        readonly detailPage: true;
+        readonly properties: {
+            readonly statList: [{
+                readonly key: "impedanceLength";
+                readonly label: "Length";
+                readonly format: {
+                    readonly type: "distance";
+                    readonly unit: "ft";
+                    readonly decimals: 0;
+                };
+            }, {
+                readonly key: "conductorDescPhA";
+                readonly label: "Conductor Phase A";
+                readonly format: {
+                    readonly type: "text";
+                };
+            }, {
+                readonly key: "conductorDescPhB";
+                readonly label: "Conductor Phase B";
+                readonly format: {
+                    readonly type: "text";
+                };
+            }, {
+                readonly key: "conductorDescPhC";
+                readonly label: "Conductor Phase C";
+                readonly format: {
+                    readonly type: "text";
+                };
+            }];
+        };
         readonly label: {
             readonly singular: "Two-Phase Overhead Line";
             readonly plural: "Two-Phase Overhead Lines";
@@ -2449,6 +3223,37 @@ declare const ENTITY_CONFIG: {
     readonly threePhaseOverheadLine: {
         readonly icon: "TextureThreePhaseOverheadLine";
         readonly category: "grid";
+        readonly archetype: "grid-line";
+        readonly detailPage: true;
+        readonly properties: {
+            readonly statList: [{
+                readonly key: "impedanceLength";
+                readonly label: "Length";
+                readonly format: {
+                    readonly type: "distance";
+                    readonly unit: "ft";
+                    readonly decimals: 0;
+                };
+            }, {
+                readonly key: "conductorDescPhA";
+                readonly label: "Conductor Phase A";
+                readonly format: {
+                    readonly type: "text";
+                };
+            }, {
+                readonly key: "conductorDescPhB";
+                readonly label: "Conductor Phase B";
+                readonly format: {
+                    readonly type: "text";
+                };
+            }, {
+                readonly key: "conductorDescPhC";
+                readonly label: "Conductor Phase C";
+                readonly format: {
+                    readonly type: "text";
+                };
+            }];
+        };
         readonly label: {
             readonly singular: "Three-Phase Overhead Line";
             readonly plural: "Three-Phase Overhead Lines";
@@ -2458,6 +3263,37 @@ declare const ENTITY_CONFIG: {
     readonly singlePhaseUndergroundLine: {
         readonly icon: "TextureSinglePhaseUndergroundLine";
         readonly category: "grid";
+        readonly archetype: "grid-line";
+        readonly detailPage: true;
+        readonly properties: {
+            readonly statList: [{
+                readonly key: "impedanceLength";
+                readonly label: "Length";
+                readonly format: {
+                    readonly type: "distance";
+                    readonly unit: "ft";
+                    readonly decimals: 0;
+                };
+            }, {
+                readonly key: "conductorDescPhA";
+                readonly label: "Conductor Phase A";
+                readonly format: {
+                    readonly type: "text";
+                };
+            }, {
+                readonly key: "conductorDescPhB";
+                readonly label: "Conductor Phase B";
+                readonly format: {
+                    readonly type: "text";
+                };
+            }, {
+                readonly key: "conductorDescPhC";
+                readonly label: "Conductor Phase C";
+                readonly format: {
+                    readonly type: "text";
+                };
+            }];
+        };
         readonly label: {
             readonly singular: "Single-Phase Underground Line";
             readonly plural: "Single-Phase Underground Lines";
@@ -2467,6 +3303,37 @@ declare const ENTITY_CONFIG: {
     readonly twoPhaseUndergroundLine: {
         readonly icon: "TextureTwoPhaseUndergroundLine";
         readonly category: "grid";
+        readonly archetype: "grid-line";
+        readonly detailPage: true;
+        readonly properties: {
+            readonly statList: [{
+                readonly key: "impedanceLength";
+                readonly label: "Length";
+                readonly format: {
+                    readonly type: "distance";
+                    readonly unit: "ft";
+                    readonly decimals: 0;
+                };
+            }, {
+                readonly key: "conductorDescPhA";
+                readonly label: "Conductor Phase A";
+                readonly format: {
+                    readonly type: "text";
+                };
+            }, {
+                readonly key: "conductorDescPhB";
+                readonly label: "Conductor Phase B";
+                readonly format: {
+                    readonly type: "text";
+                };
+            }, {
+                readonly key: "conductorDescPhC";
+                readonly label: "Conductor Phase C";
+                readonly format: {
+                    readonly type: "text";
+                };
+            }];
+        };
         readonly label: {
             readonly singular: "Two-Phase Underground Line";
             readonly plural: "Two-Phase Underground Lines";
@@ -2476,6 +3343,37 @@ declare const ENTITY_CONFIG: {
     readonly threePhaseUndergroundLine: {
         readonly icon: "TextureThreePhaseUndergroundLine";
         readonly category: "grid";
+        readonly archetype: "grid-line";
+        readonly detailPage: true;
+        readonly properties: {
+            readonly statList: [{
+                readonly key: "impedanceLength";
+                readonly label: "Length";
+                readonly format: {
+                    readonly type: "distance";
+                    readonly unit: "ft";
+                    readonly decimals: 0;
+                };
+            }, {
+                readonly key: "conductorDescPhA";
+                readonly label: "Conductor Phase A";
+                readonly format: {
+                    readonly type: "text";
+                };
+            }, {
+                readonly key: "conductorDescPhB";
+                readonly label: "Conductor Phase B";
+                readonly format: {
+                    readonly type: "text";
+                };
+            }, {
+                readonly key: "conductorDescPhC";
+                readonly label: "Conductor Phase C";
+                readonly format: {
+                    readonly type: "text";
+                };
+            }];
+        };
         readonly label: {
             readonly singular: "Three-Phase Underground Line";
             readonly plural: "Three-Phase Underground Lines";
@@ -2485,6 +3383,27 @@ declare const ENTITY_CONFIG: {
     readonly motorSwitch: {
         readonly icon: "Diamond";
         readonly category: "grid";
+        readonly archetype: "grid-energized";
+        readonly detailPage: true;
+        readonly properties: {
+            readonly statList: [{
+                readonly key: "ratedPower";
+                readonly label: "Rated Power";
+                readonly format: {
+                    readonly type: "power";
+                    readonly unit: "kW";
+                    readonly decimals: 1;
+                };
+            }, {
+                readonly key: "voltage";
+                readonly label: "Voltage";
+                readonly format: {
+                    readonly type: "voltage";
+                    readonly unit: "V";
+                    readonly decimals: 0;
+                };
+            }];
+        };
         readonly label: {
             readonly singular: "Motor Switch";
             readonly plural: "Motor Switches";
@@ -2494,6 +3413,25 @@ declare const ENTITY_CONFIG: {
     readonly recloser: {
         readonly icon: "TextureRecloser";
         readonly category: "grid";
+        readonly archetype: "grid-energized";
+        readonly detailPage: true;
+        readonly properties: {
+            readonly statList: [{
+                readonly key: "ratedCurrent";
+                readonly label: "Rated Current";
+                readonly format: {
+                    readonly type: "number";
+                    readonly unit: "A";
+                    readonly decimals: 0;
+                };
+            }, {
+                readonly key: "deviceType";
+                readonly label: "Device Type";
+                readonly format: {
+                    readonly type: "text";
+                };
+            }];
+        };
         readonly label: {
             readonly singular: "Recloser";
             readonly plural: "Reclosers";
@@ -2511,6 +3449,25 @@ declare const ENTITY_CONFIG: {
     readonly fuse: {
         readonly icon: "TextureFuse";
         readonly category: "grid";
+        readonly archetype: "grid-energized";
+        readonly detailPage: true;
+        readonly properties: {
+            readonly statList: [{
+                readonly key: "ratedCurrent";
+                readonly label: "Rated Current";
+                readonly format: {
+                    readonly type: "number";
+                    readonly unit: "A";
+                    readonly decimals: 0;
+                };
+            }, {
+                readonly key: "deviceType";
+                readonly label: "Device Type";
+                readonly format: {
+                    readonly type: "text";
+                };
+            }];
+        };
         readonly label: {
             readonly singular: "Fuse";
             readonly plural: "Fuses";
@@ -2520,6 +3477,25 @@ declare const ENTITY_CONFIG: {
     readonly breaker: {
         readonly icon: "TextureBreaker";
         readonly category: "grid";
+        readonly archetype: "grid-energized";
+        readonly detailPage: true;
+        readonly properties: {
+            readonly statList: [{
+                readonly key: "ratedCurrent";
+                readonly label: "Rated Current";
+                readonly format: {
+                    readonly type: "number";
+                    readonly unit: "A";
+                    readonly decimals: 0;
+                };
+            }, {
+                readonly key: "deviceType";
+                readonly label: "Device Type";
+                readonly format: {
+                    readonly type: "text";
+                };
+            }];
+        };
         readonly label: {
             readonly singular: "Breaker";
             readonly plural: "Breakers";
@@ -2537,6 +3513,27 @@ declare const ENTITY_CONFIG: {
     readonly generator: {
         readonly icon: "Wind";
         readonly category: "grid";
+        readonly archetype: "grid-energized";
+        readonly detailPage: true;
+        readonly properties: {
+            readonly statList: [{
+                readonly key: "ratedPower";
+                readonly label: "Rated Power";
+                readonly format: {
+                    readonly type: "power";
+                    readonly unit: "kW";
+                    readonly decimals: 1;
+                };
+            }, {
+                readonly key: "outputVoltage";
+                readonly label: "Output Voltage";
+                readonly format: {
+                    readonly type: "voltage";
+                    readonly unit: "V";
+                    readonly decimals: 0;
+                };
+            }];
+        };
         readonly label: {
             readonly singular: "Generator";
             readonly plural: "Generators";
@@ -2546,6 +3543,43 @@ declare const ENTITY_CONFIG: {
     readonly regulator: {
         readonly icon: "TextureRegulator";
         readonly category: "grid";
+        readonly archetype: "grid-energized";
+        readonly detailPage: true;
+        readonly properties: {
+            readonly statList: [{
+                readonly key: "outputVoltagePhA";
+                readonly label: "Output Voltage Phase A";
+                readonly format: {
+                    readonly type: "voltage";
+                    readonly unit: "V";
+                    readonly decimals: 0;
+                };
+            }, {
+                readonly key: "outputVoltagePhB";
+                readonly label: "Output Voltage Phase B";
+                readonly format: {
+                    readonly type: "voltage";
+                    readonly unit: "V";
+                    readonly decimals: 0;
+                };
+            }, {
+                readonly key: "outputVoltagePhC";
+                readonly label: "Output Voltage Phase C";
+                readonly format: {
+                    readonly type: "voltage";
+                    readonly unit: "V";
+                    readonly decimals: 0;
+                };
+            }, {
+                readonly key: "ratedPower";
+                readonly label: "Rated Power";
+                readonly format: {
+                    readonly type: "power";
+                    readonly unit: "kVA";
+                    readonly decimals: 1;
+                };
+            }];
+        };
         readonly label: {
             readonly singular: "Regulator";
             readonly plural: "Regulators";
@@ -2555,6 +3589,19 @@ declare const ENTITY_CONFIG: {
     readonly supportStructure: {
         readonly icon: "TextureSupportStructure";
         readonly category: "grid";
+        readonly archetype: "grid-line";
+        readonly detailPage: true;
+        readonly properties: {
+            readonly statList: [{
+                readonly key: "nominalVoltage";
+                readonly label: "Nominal Voltage";
+                readonly format: {
+                    readonly type: "voltage";
+                    readonly unit: "V";
+                    readonly decimals: 0;
+                };
+            }];
+        };
         readonly label: {
             readonly singular: "Support Structure";
             readonly plural: "Support Structures";
@@ -2564,51 +3611,289 @@ declare const ENTITY_CONFIG: {
     readonly battery: {
         readonly icon: "BatteryHigh";
         readonly category: "device";
+        readonly archetype: "device";
+        readonly detailPage: true;
         readonly label: {
             readonly singular: "Battery";
             readonly plural: "Batteries";
         };
         readonly description: "Behind-the-meter battery or storage system";
+        readonly fields: {
+            readonly headlineMetrics: [{
+                readonly id: "power";
+                readonly label: "device.battery.fields.power";
+                readonly source: {
+                    readonly kind: "state";
+                    readonly path: "state.gridPower";
+                };
+                readonly format: {
+                    readonly type: "power";
+                    readonly decimals: 1;
+                };
+                readonly icon: "Lightning";
+            }, {
+                readonly id: "soc";
+                readonly label: "device.battery.fields.soc";
+                readonly source: {
+                    readonly kind: "state";
+                    readonly path: "state.chargePercentage";
+                };
+                readonly format: {
+                    readonly type: "percentage";
+                    readonly decimals: 0;
+                };
+                readonly icon: "BatteryCharging";
+            }];
+        };
+        readonly stateRules: {
+            readonly primaryState: {
+                readonly label: "device.battery.fields.status";
+                readonly fieldPath: "state.chargingState";
+                readonly mapping: {
+                    readonly charging: "charging";
+                    readonly discharging: "discharging";
+                    readonly idle: "idle";
+                    readonly unknown: "unknown";
+                };
+                readonly fallback: "unknown";
+            };
+            readonly secondaryState: {
+                readonly label: "device.battery.fields.gridState";
+                readonly fieldPath: "state.gridStatus";
+                readonly mapping: {
+                    readonly importing: "importing";
+                    readonly exporting: "exporting";
+                    readonly idle: "importing";
+                    readonly unknown: "importing";
+                };
+                readonly fallback: "importing";
+            };
+        };
     };
     readonly evCharger: {
         readonly icon: "ChargingStation";
         readonly category: "device";
+        readonly archetype: "device";
+        readonly detailPage: true;
         readonly label: {
             readonly singular: "EV Charger";
             readonly plural: "EV Chargers";
         };
         readonly description: "Electric-vehicle charging station or port";
+        readonly fields: {
+            readonly headlineMetrics: [{
+                readonly id: "power";
+                readonly label: "device.evCharger.fields.power";
+                readonly source: {
+                    readonly kind: "state";
+                    readonly path: "state.chargerWattage";
+                };
+                readonly format: {
+                    readonly type: "power";
+                    readonly decimals: 1;
+                };
+                readonly icon: "Lightning";
+            }, {
+                readonly id: "isPluggedIn";
+                readonly label: "device.evCharger.fields.isPluggedIn";
+                readonly source: {
+                    readonly kind: "state";
+                    readonly path: "state.isPluggedIn";
+                };
+                readonly format: {
+                    readonly type: "boolean";
+                    readonly trueText: "Yes";
+                    readonly falseText: "No";
+                };
+                readonly icon: "Plug";
+            }];
+        };
+        readonly stateRules: {
+            readonly primaryState: {
+                readonly label: "device.evCharger.fields.status";
+                readonly fieldPath: "state.chargingState";
+                readonly mapping: {
+                    readonly charging: "charging";
+                    readonly discharging: "discharging";
+                    readonly idle: "idle";
+                    readonly unknown: "unknown";
+                };
+                readonly fallback: "unknown";
+            };
+        };
     };
     readonly inverter: {
         readonly icon: "Sun";
         readonly category: "device";
+        readonly archetype: "device";
+        readonly detailPage: true;
         readonly label: {
             readonly singular: "Solar / Inverter";
             readonly plural: "Solar / Inverters";
         };
         readonly description: "Solar PV inverter and its connected array";
+        readonly fields: {
+            readonly headlineMetrics: [{
+                readonly id: "power";
+                readonly label: "device.inverter.fields.power";
+                readonly source: {
+                    readonly kind: "state";
+                    readonly path: "state.power";
+                };
+                readonly format: {
+                    readonly type: "power";
+                    readonly decimals: 0;
+                };
+                readonly icon: "Lightning";
+            }, {
+                readonly id: "gridPower";
+                readonly label: "device.inverter.fields.gridPower";
+                readonly source: {
+                    readonly kind: "state";
+                    readonly path: "state.gridPower";
+                };
+                readonly format: {
+                    readonly type: "power";
+                    readonly decimals: 0;
+                };
+                readonly icon: "GridFour";
+            }];
+        };
+        readonly stateRules: {
+            readonly primaryState: {
+                readonly label: "device.inverter.fields.gridStatus";
+                readonly fieldPath: "state.gridStatus";
+                readonly mapping: {
+                    readonly exporting: "exporting";
+                    readonly importing: "importing";
+                    readonly idle: "idle";
+                };
+                readonly fallback: "unknown";
+            };
+        };
     };
     readonly thermostat: {
         readonly icon: "Thermometer";
         readonly category: "device";
+        readonly archetype: "device";
+        readonly detailPage: true;
         readonly label: {
             readonly singular: "Thermostat";
             readonly plural: "Thermostats";
         };
         readonly description: "Smart thermostat or connected HVAC control";
+        readonly fields: {
+            readonly headlineMetrics: [{
+                readonly id: "ambientTemperature";
+                readonly label: "device.thermostat.fields.ambientTemperature";
+                readonly source: {
+                    readonly kind: "state";
+                    readonly path: "state.ambientTemperature";
+                };
+                readonly format: {
+                    readonly type: "temperature";
+                    readonly decimals: 0;
+                };
+                readonly icon: "Thermometer";
+            }, {
+                readonly id: "heatTarget";
+                readonly label: "device.thermostat.fields.heatTarget";
+                readonly source: {
+                    readonly kind: "state";
+                    readonly path: "state.heatTarget";
+                };
+                readonly format: {
+                    readonly type: "temperature";
+                    readonly decimals: 0;
+                };
+                readonly icon: "Flame";
+            }, {
+                readonly id: "coolTarget";
+                readonly label: "device.thermostat.fields.coolTarget";
+                readonly source: {
+                    readonly kind: "state";
+                    readonly path: "state.coolTarget";
+                };
+                readonly format: {
+                    readonly type: "temperature";
+                    readonly decimals: 0;
+                };
+                readonly icon: "Snowflake";
+            }];
+        };
+        readonly stateRules: {
+            readonly primaryState: {
+                readonly label: "device.thermostat.fields.operatingMode";
+                readonly fieldPath: "state.operatingMode";
+                readonly mapping: {
+                    readonly heat: "heat";
+                    readonly cool: "cool";
+                    readonly auto: "auto";
+                    readonly off: "off";
+                    readonly eco: "eco";
+                    readonly unknown: "unknown";
+                };
+                readonly fallback: "unknown";
+            };
+        };
     };
     readonly vehicle: {
         readonly icon: "Car";
         readonly category: "device";
+        readonly archetype: "device";
+        readonly detailPage: true;
         readonly label: {
             readonly singular: "EV";
             readonly plural: "EVs";
         };
         readonly description: "Electric vehicle managed as a flexible load";
+        readonly fields: {
+            readonly headlineMetrics: [{
+                readonly id: "chargePercentage";
+                readonly label: "device.vehicle.fields.chargePercentage";
+                readonly source: {
+                    readonly kind: "state";
+                    readonly path: "state.chargePercentage";
+                };
+                readonly format: {
+                    readonly type: "percentage";
+                    readonly decimals: 0;
+                };
+                readonly icon: "BatteryCharging";
+            }, {
+                readonly id: "range";
+                readonly label: "device.vehicle.fields.range";
+                readonly source: {
+                    readonly kind: "state";
+                    readonly path: "state.range";
+                };
+                readonly format: {
+                    readonly type: "distance";
+                    readonly unit: "mi";
+                    readonly decimals: 0;
+                };
+                readonly icon: "GasPump";
+            }];
+        };
+        readonly stateRules: {
+            readonly primaryState: {
+                readonly label: "device.vehicle.fields.status";
+                readonly fieldPath: "state.chargingState";
+                readonly mapping: {
+                    readonly charging: "charging";
+                    readonly discharging: "discharging";
+                    readonly idle: "idle";
+                    readonly unknown: "unknown";
+                };
+                readonly fallback: "unknown";
+            };
+        };
     };
     readonly waterHeater: {
         readonly icon: "Drop";
         readonly category: "device";
+        readonly archetype: "device";
+        readonly detailPage: true;
         readonly label: {
             readonly singular: "Water Heater";
             readonly plural: "Water Heaters";
@@ -2617,6 +3902,39 @@ declare const ENTITY_CONFIG: {
     };
 };
 type EntityType = keyof typeof ENTITY_CONFIG;
+/**
+ * The 22→12 mapping (MR-07 step 6): every grid registry key resolved to its
+ * coarse `GridElementType`. The registry splits some element types by phase
+ * count or sub-class (lines → 1P/2P/3P, overcurrent → recloser/fuse/breaker,
+ * `NODE` → pole/relay/support structure), so several keys share one element
+ * type. This is the recorded source-of-truth for which `GRID_STAT_LIST` a grid
+ * entity's `properties.statList` was transcribed from; a conformance test asserts
+ * each grid entity's stat-list is exactly `GRID_STAT_LIST[mapping[key]]`.
+ */
+declare const GRID_ELEMENT_TYPE_BY_ENTITY: {
+    readonly source: "SOURCE";
+    readonly substation: "SOURCE";
+    readonly capacitor: "CAPACITOR";
+    readonly switch: "SWITCH";
+    readonly sectionalizer: "SWITCH";
+    readonly relay: "NODE";
+    readonly transformer: "TRANSFORMER";
+    readonly meter: "CONSUMER";
+    readonly consumer: "CONSUMER";
+    readonly singlePhaseOverheadLine: "OVERHEAD_LINE";
+    readonly twoPhaseOverheadLine: "OVERHEAD_LINE";
+    readonly threePhaseOverheadLine: "OVERHEAD_LINE";
+    readonly singlePhaseUndergroundLine: "UNDERGROUND_LINE";
+    readonly twoPhaseUndergroundLine: "UNDERGROUND_LINE";
+    readonly threePhaseUndergroundLine: "UNDERGROUND_LINE";
+    readonly motorSwitch: "MOTOR";
+    readonly recloser: "OVERCURRENT_DEVICE";
+    readonly fuse: "OVERCURRENT_DEVICE";
+    readonly breaker: "OVERCURRENT_DEVICE";
+    readonly generator: "GENERATOR";
+    readonly regulator: "REGULATOR";
+    readonly supportStructure: "NODE";
+};
 /**
  * Get entity configuration by type
  *
@@ -2663,6 +3981,66 @@ declare function getEntityLabel(entityType: EntityType, plural?: boolean): strin
  * @returns The entity's category
  */
 declare function getEntityCategory(entityType: EntityType): EntityCategory;
+/**
+ * Inclusive bounds on `fields.headlineMetrics`. The design's `entity.now`
+ * acceptance criteria say the cell count adapts across this range. Exported so
+ * the conformance test enforces the bound rather than documenting it.
+ */
+declare const HEADLINE_METRIC_BOUNDS: {
+    readonly min: 2;
+    readonly max: 4;
+};
+/**
+ * Resolve the base page composition for an entity. This is what lets the 30
+ * in-scope entities share five compositions instead of 30 pages of page code.
+ *
+ * @param entityType - The entity type key
+ * @returns The entity's archetype
+ * @throws If `entityType` is not a known entity (never returns `undefined`, so
+ *   a typo surfaces as a loud error rather than a silently missing composition).
+ *
+ * @example
+ * ```tsx
+ * archetypeFor("battery");     // "device"
+ * archetypeFor("transformer"); // "grid-energized"
+ * archetypeFor("nope");        // throws
+ * ```
+ */
+declare function archetypeFor(entityType: EntityType): EntityArchetype;
+/**
+ * Whether an entity has a reachable detail page. The registry is the single
+ * answer to "does this entity have a page?".
+ *
+ * @param entityType - The entity type key
+ */
+declare function entityHasDetailPage(entityType: EntityType): boolean;
+/**
+ * Whether `entity.now` renders a metric grid for this entity. True iff the
+ * entity declares at least one headline metric. Grid elements (no metric
+ * registry yet), Site, Customer and Water Heater return `false` — `entity.now`
+ * declines to render its cells rather than crashing or rendering empty.
+ *
+ * @param entityType - The entity type key
+ */
+declare function entityShowsNow(entityType: EntityType): boolean;
+/**
+ * The static-property (`data.stat-list`) rows for an entity, or an empty array
+ * when it has none. Grid entities carry a non-empty stat-list transcribed from
+ * `grid-element-config`; devices and platform objects return `[]`.
+ *
+ * Note this is independent of `entityShowsNow`: a static stat-list is *not* an
+ * `entity.now`. A grid line has `properties.statList` (structural nameplate) yet
+ * `entityShowsNow` is `false` — that is the intended MR-07 split.
+ *
+ * @param entityType - The entity type key
+ */
+declare function getEntityStatList(entityType: EntityType): readonly GridStatField[];
+/**
+ * Whether an entity has a non-empty static-property (`data.stat-list`) block.
+ *
+ * @param entityType - The entity type key
+ */
+declare function entityHasStatList(entityType: EntityType): boolean;
 
 /**
  * Resolves a CSS variable to its computed color value.
@@ -2723,4 +4101,4 @@ declare const getContrastingTextColor: (backgroundColor: string) => string;
  */
 declare const mapValuesToCategoricalColors: (values: (string | number)[]) => Record<string | number, string>;
 
-export { type DistanceFormat as $, type ActionItem as A, type BadgeProps as B, type ChartMargin as C, getContrastingTextColor as D, ENTITY_CONFIG as E, getDefaultChartColor as F, getDefaultColors as G, Heading as H, type InteractiveMapProps as I, getEntityConfig as J, getEntityIcon as K, Loader as L, type MapPoint as M, getEntityLabel as N, getResolvedColor as O, getThemeCategoricalColors as P, getYFormatSettings as Q, isLightColor as R, type SegmentOption as S, TextLink as T, type FieldValue as U, type BooleanFormat as V, type FormattedValue as W, type FieldFormat as X, type YFormatSettings as Y, type CurrentFormat as Z, type DateFormat as _, type ActionMenuProps as a, type VoltageUnit as a$, type EnergyUnit as a0, type EnergyFormat as a1, type CurrencyFormat as a2, type NumberFormat as a3, type PhoneFormat as a4, type PowerFormat as a5, type FormatterFunction as a6, type ResistanceFormat as a7, type TemperatureFormat as a8, type TemperatureUnitString as a9, ENTITY_CATEGORY_CONFIG as aA, type EntityCategory as aB, type EntityCategoryConfig as aC, GRID_STATE_COLORS as aD, type GridStateColor as aE, InteractiveMap as aF, type InteractiveMapHandle as aG, type LayerFeature as aH, type LayerStyle as aI, MAP_TYPES as aJ, type MapType as aK, Meter as aL, type MetricFormat as aM, type PercentageFormat as aN, type PowerUnit as aO, type RenderType as aP, type ResistanceUnit as aQ, SegmentedControl as aR, StackNav as aS, type StackNavGroup as aT, type StackNavItem as aU, type StackNavLinkComponentProps as aV, type StackNavProps as aW, type StackNavTheme as aX, StaticMap as aY, type TextTransform as aZ, type TextTruncatePosition as a_, type TemperatureUnit as aa, type TextFormat as ab, type VoltageFormat as ac, type DeviceState as ad, type GridState as ae, type ComponentFormatter as af, type LayerSpec as ag, type CustomPinsSpec as ah, type GeoJsonLayerSpec as ai, type RasterLayerSpec as aj, type VectorLayerSpec as ak, type ClusteredVectorLayerSpec as al, ActionMenu as am, AppShell as an, Avatar as ao, Badge as ap, type BaseFormat as aq, ChartContext as ar, CodeEditor as as, type ColorSpec as at, type ComponentFormatOptions as au, type CurrentUnit as av, type CustomFormat as aw, DEFAULT_MAP_TYPE as ax, type DateFormatStyle as ay, type DistanceUnit as az, type AppShellProps as b, type ZoomStops as b0, activeDeviceStates as b1, baselineFromPoint as b2, deviceStateLabels as b3, deviceStateMetricFormats as b4, formatComponentValue as b5, getDeviceStateLabel as b6, getEntityCategory as b7, getGridStateLabel as b8, gridStateLabels as b9, isActiveState as ba, mapValuesToCategoricalColors as bb, useChartContext as bc, useComponentFormatter as bd, type AvatarProps as c, type BaseDataPoint as d, type CodeEditorProps as e, type CodeLanguage as f, type CodeTheme as g, type EntityConfig as h, type EntityType as i, Logo as j, type MeterProps as k, type SegmentedControlProps as l, SideNav as m, type SideNavItem as n, type SideNavProps as o, type StaticMapProps as p, type TooltipData as q, type TooltipSeries as r, TopNav as s, type TopNavProps as t, type YFormatType as u, clearColorCache as v, createCategoryColorMap as w, createXScale as x, createYScale as y, defaultMargin as z };
+export { getContrastingTextColor as $, ABSENT_GRID_FIELDS as A, type BadgeProps as B, type ChartMargin as C, type StaticMapProps as D, ENTITY_CONFIG as E, type TooltipData as F, GRID_ELEMENT_TYPE_BY_ENTITY as G, HEADLINE_METRIC_BOUNDS as H, type InteractiveMapProps as I, type TooltipSeries as J, TopNav as K, Loader as L, type MapPoint as M, type TopNavProps as N, type YFormatType as O, archetypeFor as P, clearColorCache as Q, createCategoryColorMap as R, type SegmentOption as S, TextLink as T, createXScale as U, createYScale as V, defaultMargin as W, entityHasDetailPage as X, type YFormatSettings as Y, entityHasStatList as Z, entityShowsNow as _, type ActionItem as a, type MapType as a$, getDefaultChartColor as a0, getDefaultColors as a1, getEntityConfig as a2, getEntityIcon as a3, getEntityLabel as a4, getEntityStatList as a5, getResolvedColor as a6, getThemeCategoricalColors as a7, getYFormatSettings as a8, isLightColor as a9, type RasterLayerSpec as aA, type VectorLayerSpec as aB, type ClusteredVectorLayerSpec as aC, ActionMenu as aD, AppShell as aE, Avatar as aF, Badge as aG, type BaseFormat as aH, ChartContext as aI, CodeEditor as aJ, type ColorSpec as aK, type ComponentFormatOptions as aL, type CurrentUnit as aM, type CustomFormat as aN, DEFAULT_MAP_TYPE as aO, type DateFormatStyle as aP, type DistanceUnit as aQ, ENTITY_CATEGORY_CONFIG as aR, type EntityCategory as aS, type EntityCategoryConfig as aT, GRID_STATE_COLORS as aU, type GridStateColor as aV, InteractiveMap as aW, type InteractiveMapHandle as aX, type LayerFeature as aY, type LayerStyle as aZ, MAP_TYPES as a_, type FieldValue as aa, type BooleanFormat as ab, type FormattedValue as ac, type FieldFormat as ad, type CurrentFormat as ae, type DateFormat as af, type DistanceFormat as ag, type EnergyUnit as ah, type EnergyFormat as ai, type CurrencyFormat as aj, type NumberFormat as ak, type PhoneFormat as al, type PowerFormat as am, type FormatterFunction as an, type ResistanceFormat as ao, type TemperatureFormat as ap, type TemperatureUnitString as aq, type TemperatureUnit as ar, type TextFormat as as, type VoltageFormat as at, type DeviceState as au, type GridState as av, type ComponentFormatter as aw, type LayerSpec as ax, type CustomPinsSpec as ay, type GeoJsonLayerSpec as az, type ActionMenuProps as b, Meter as b0, type MetricFormat as b1, type PercentageFormat as b2, type PowerUnit as b3, type RenderType as b4, type ResistanceUnit as b5, SegmentedControl as b6, StackNav as b7, type StackNavGroup as b8, type StackNavItem as b9, type StackNavLinkComponentProps as ba, type StackNavProps as bb, type StackNavTheme as bc, StaticMap as bd, type TextTransform as be, type TextTruncatePosition as bf, type VoltageUnit as bg, type ZoomStops as bh, activeDeviceStates as bi, baselineFromPoint as bj, deviceStateLabels as bk, deviceStateMetricFormats as bl, formatComponentValue as bm, getDeviceStateLabel as bn, getEntityCategory as bo, getGridStateLabel as bp, gridStateLabels as bq, isActiveState as br, mapValuesToCategoricalColors as bs, useChartContext as bt, useComponentFormatter as bu, type AppShellProps as c, type AvatarProps as d, type BaseDataPoint as e, type CodeEditorProps as f, type CodeLanguage as g, type CodeTheme as h, type EntityArchetype as i, type EntityConfig as j, type EntityStateRule as k, type EntityType as l, GRID_STAT_LIST as m, type GridElementSourceType as n, type GridStatField as o, type GridStatFieldFormat as p, Heading as q, type HeadlineMetric as r, Logo as s, type MeterProps as t, type MetricSource as u, type SegmentedControlProps as v, type SerializableFieldFormat as w, SideNav as x, type SideNavItem as y, type SideNavProps as z };