@texturehq/edges 2.4.5 → 2.4.7

package/dist/{colors-Z6qVFuKf.d.cts → colors-Ci45KEwz.d.cts}

@@ -1226,6 +1226,19 @@ interface BaseLayerSpec {
         color?: string;
         /** Optional grouping for organizing layers in the control */
         group?: string;
+        /**
+         * Mutually-exclusive sub-modes, rendered as a dropdown beneath the layer's
+         * checkbox. `selectedId` is a single value rather than a set so "two modes
+         * at once" is unrepresentable, not merely discouraged. Layers without this
+         * render as a plain checkbox.
+         */
+        variants?: {
+            options: ReadonlyArray<{
+                id: string;
+                label: string;
+            }>;
+            selectedId: string;
+        };
     };
     /** Event handlers for user interactions */
     events?: {
@@ -1563,6 +1576,11 @@ interface LayersControl extends BaseControl {
      * Callback to clear all layer selections (hide all layers)
      */
     onClearAll?: () => void;
+    /**
+     * Callback when a layer's selected variant changes. Only fires for layers
+     * declaring `legend.variants`.
+     */
+    onLayerVariantChange?: (layerId: string, variantId: string) => void;
 }
 /**
  * Search control configuration
@@ -2099,6 +2117,71 @@ 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";
+}>;
+/**
+ * One headline metric shown by `entity.now`. A serializable declaration only —
+ * `path` is a dot-path into the resolved entity data, `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 `path`/`format` at render.
+ *
+ * The shape is the serializable subset of `device-config`'s `FieldConfig`
+ * (`id`/`label`/`path`/`format`/`icon`) — `showWhen`/`resolver`/`custom`
+ * formatters are intentionally dropped.
+ */
+interface HeadlineMetric {
+    /** Stable identifier for the metric (unique within an entity). */
+    id: string;
+    /** Translation key for the display label. */
+    label: string;
+    /** Dot-path into the resolved entity data (e.g. "state.gridPower"). */
+    path: string;
+    /** 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;
+}
 interface EntityConfig {
     /** Phosphor icon name. The canonical (resting / default) glyph. For switchable
      *  elements this mirrors `states.closed.icon` (or the base glyph when the
@@ -2127,6 +2210,40 @@ 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;
+    };
 }
 /** 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". */
@@ -2186,6 +2303,8 @@ 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";
@@ -2195,6 +2314,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";
@@ -2204,6 +2325,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";
@@ -2213,6 +2336,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";
@@ -2222,6 +2347,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";
@@ -2231,6 +2358,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";
@@ -2240,6 +2369,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";
@@ -2249,6 +2380,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";
@@ -2258,6 +2391,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";
@@ -2267,6 +2402,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";
@@ -2276,6 +2413,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";
@@ -2285,6 +2424,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";
@@ -2294,6 +2435,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";
@@ -2303,6 +2446,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";
@@ -2312,6 +2457,8 @@ declare const ENTITY_CONFIG: {
     readonly source: {
         readonly icon: "TextureSource";
         readonly category: "grid";
+        readonly archetype: "grid-energized";
+        readonly detailPage: true;
         readonly label: {
             readonly singular: "Source";
             readonly plural: "Sources";
@@ -2321,6 +2468,8 @@ declare const ENTITY_CONFIG: {
     readonly substation: {
         readonly icon: "TextureSource";
         readonly category: "grid";
+        readonly archetype: "grid-energized";
+        readonly detailPage: true;
         readonly label: {
             readonly singular: "Substation";
             readonly plural: "Substations";
@@ -2330,6 +2479,8 @@ declare const ENTITY_CONFIG: {
     readonly capacitor: {
         readonly icon: "TextureCapacitor";
         readonly category: "grid";
+        readonly archetype: "grid-energized";
+        readonly detailPage: true;
         readonly label: {
             readonly singular: "Capacitor";
             readonly plural: "Capacitors";
@@ -2339,6 +2490,8 @@ declare const ENTITY_CONFIG: {
     readonly switch: {
         readonly icon: "TextureSwitchClosed";
         readonly category: "grid";
+        readonly archetype: "grid-energized";
+        readonly detailPage: true;
         readonly label: {
             readonly singular: "Switch";
             readonly plural: "Switches";
@@ -2358,6 +2511,8 @@ declare const ENTITY_CONFIG: {
     readonly sectionalizer: {
         readonly icon: "TextureSectionalizerClosed";
         readonly category: "grid";
+        readonly archetype: "grid-energized";
+        readonly detailPage: true;
         readonly label: {
             readonly singular: "Sectionalizer";
             readonly plural: "Sectionalizers";
@@ -2377,6 +2532,8 @@ declare const ENTITY_CONFIG: {
     readonly relay: {
         readonly icon: "Cpu";
         readonly category: "grid";
+        readonly archetype: "grid-energized";
+        readonly detailPage: true;
         readonly label: {
             readonly singular: "Relay";
             readonly plural: "Relays";
@@ -2386,6 +2543,8 @@ declare const ENTITY_CONFIG: {
     readonly transformer: {
         readonly icon: "TextureTransformer";
         readonly category: "grid";
+        readonly archetype: "grid-energized";
+        readonly detailPage: true;
         readonly label: {
             readonly singular: "Transformer";
             readonly plural: "Transformers";
@@ -2395,15 +2554,42 @@ declare const ENTITY_CONFIG: {
     readonly meter: {
         readonly icon: "Gauge";
         readonly category: "grid";
+        readonly archetype: "grid-energized";
+        readonly detailPage: true;
         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 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 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 label: {
             readonly singular: "Consumer";
             readonly plural: "Consumers";
@@ -2413,6 +2599,8 @@ declare const ENTITY_CONFIG: {
     readonly singlePhaseOverheadLine: {
         readonly icon: "TextureSinglePhaseOverheadLine";
         readonly category: "grid";
+        readonly archetype: "grid-line";
+        readonly detailPage: true;
         readonly label: {
             readonly singular: "Single-Phase Overhead Line";
             readonly plural: "Single-Phase Overhead Lines";
@@ -2422,6 +2610,8 @@ declare const ENTITY_CONFIG: {
     readonly twoPhaseOverheadLine: {
         readonly icon: "TextureTwoPhaseOverheadLine";
         readonly category: "grid";
+        readonly archetype: "grid-line";
+        readonly detailPage: true;
         readonly label: {
             readonly singular: "Two-Phase Overhead Line";
             readonly plural: "Two-Phase Overhead Lines";
@@ -2431,6 +2621,8 @@ declare const ENTITY_CONFIG: {
     readonly threePhaseOverheadLine: {
         readonly icon: "TextureThreePhaseOverheadLine";
         readonly category: "grid";
+        readonly archetype: "grid-line";
+        readonly detailPage: true;
         readonly label: {
             readonly singular: "Three-Phase Overhead Line";
             readonly plural: "Three-Phase Overhead Lines";
@@ -2440,6 +2632,8 @@ declare const ENTITY_CONFIG: {
     readonly singlePhaseUndergroundLine: {
         readonly icon: "TextureSinglePhaseUndergroundLine";
         readonly category: "grid";
+        readonly archetype: "grid-line";
+        readonly detailPage: true;
         readonly label: {
             readonly singular: "Single-Phase Underground Line";
             readonly plural: "Single-Phase Underground Lines";
@@ -2449,6 +2643,8 @@ declare const ENTITY_CONFIG: {
     readonly twoPhaseUndergroundLine: {
         readonly icon: "TextureTwoPhaseUndergroundLine";
         readonly category: "grid";
+        readonly archetype: "grid-line";
+        readonly detailPage: true;
         readonly label: {
             readonly singular: "Two-Phase Underground Line";
             readonly plural: "Two-Phase Underground Lines";
@@ -2458,6 +2654,8 @@ declare const ENTITY_CONFIG: {
     readonly threePhaseUndergroundLine: {
         readonly icon: "TextureThreePhaseUndergroundLine";
         readonly category: "grid";
+        readonly archetype: "grid-line";
+        readonly detailPage: true;
         readonly label: {
             readonly singular: "Three-Phase Underground Line";
             readonly plural: "Three-Phase Underground Lines";
@@ -2467,6 +2665,8 @@ declare const ENTITY_CONFIG: {
     readonly motorSwitch: {
         readonly icon: "Diamond";
         readonly category: "grid";
+        readonly archetype: "grid-energized";
+        readonly detailPage: true;
         readonly label: {
             readonly singular: "Motor Switch";
             readonly plural: "Motor Switches";
@@ -2476,6 +2676,8 @@ declare const ENTITY_CONFIG: {
     readonly recloser: {
         readonly icon: "TextureRecloser";
         readonly category: "grid";
+        readonly archetype: "grid-energized";
+        readonly detailPage: true;
         readonly label: {
             readonly singular: "Recloser";
             readonly plural: "Reclosers";
@@ -2493,6 +2695,8 @@ declare const ENTITY_CONFIG: {
     readonly fuse: {
         readonly icon: "TextureFuse";
         readonly category: "grid";
+        readonly archetype: "grid-energized";
+        readonly detailPage: true;
         readonly label: {
             readonly singular: "Fuse";
             readonly plural: "Fuses";
@@ -2502,6 +2706,8 @@ declare const ENTITY_CONFIG: {
     readonly breaker: {
         readonly icon: "TextureBreaker";
         readonly category: "grid";
+        readonly archetype: "grid-energized";
+        readonly detailPage: true;
         readonly label: {
             readonly singular: "Breaker";
             readonly plural: "Breakers";
@@ -2519,6 +2725,8 @@ declare const ENTITY_CONFIG: {
     readonly generator: {
         readonly icon: "Wind";
         readonly category: "grid";
+        readonly archetype: "grid-energized";
+        readonly detailPage: true;
         readonly label: {
             readonly singular: "Generator";
             readonly plural: "Generators";
@@ -2528,6 +2736,8 @@ declare const ENTITY_CONFIG: {
     readonly regulator: {
         readonly icon: "TextureRegulator";
         readonly category: "grid";
+        readonly archetype: "grid-energized";
+        readonly detailPage: true;
         readonly label: {
             readonly singular: "Regulator";
             readonly plural: "Regulators";
@@ -2537,6 +2747,8 @@ declare const ENTITY_CONFIG: {
     readonly supportStructure: {
         readonly icon: "TextureSupportStructure";
         readonly category: "grid";
+        readonly archetype: "grid-line";
+        readonly detailPage: true;
         readonly label: {
             readonly singular: "Support Structure";
             readonly plural: "Support Structures";
@@ -2546,51 +2758,256 @@ 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 path: "state.gridPower";
+                readonly format: {
+                    readonly type: "power";
+                    readonly decimals: 1;
+                };
+                readonly icon: "Lightning";
+            }, {
+                readonly id: "soc";
+                readonly label: "device.battery.fields.soc";
+                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 path: "state.chargerWattage";
+                readonly format: {
+                    readonly type: "power";
+                    readonly decimals: 1;
+                };
+                readonly icon: "Lightning";
+            }, {
+                readonly id: "isPluggedIn";
+                readonly label: "device.evCharger.fields.isPluggedIn";
+                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 path: "state.power";
+                readonly format: {
+                    readonly type: "power";
+                    readonly decimals: 0;
+                };
+                readonly icon: "Lightning";
+            }, {
+                readonly id: "gridPower";
+                readonly label: "device.inverter.fields.gridPower";
+                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 path: "state.ambientTemperature";
+                readonly format: {
+                    readonly type: "temperature";
+                    readonly decimals: 0;
+                };
+                readonly icon: "Thermometer";
+            }, {
+                readonly id: "heatTarget";
+                readonly label: "device.thermostat.fields.heatTarget";
+                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 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 path: "state.chargePercentage";
+                readonly format: {
+                    readonly type: "percentage";
+                    readonly decimals: 0;
+                };
+                readonly icon: "BatteryCharging";
+            }, {
+                readonly id: "range";
+                readonly label: "device.vehicle.fields.range";
+                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";
@@ -2645,6 +3062,48 @@ 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;
 
 /**
  * Resolves a CSS variable to its computed color value.
@@ -2705,4 +3164,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 { getYFormatSettings as $, type ActionItem as A, type BadgeProps as B, type ChartMargin as C, archetypeFor as D, ENTITY_CONFIG as E, clearColorCache as F, createCategoryColorMap as G, HEADLINE_METRIC_BOUNDS as H, type InteractiveMapProps as I, createXScale as J, createYScale as K, Loader as L, type MapPoint as M, defaultMargin as N, entityHasDetailPage as O, entityShowsNow as P, getContrastingTextColor as Q, getDefaultChartColor as R, type SegmentOption as S, TextLink as T, getDefaultColors as U, getEntityConfig as V, getEntityIcon as W, getEntityLabel as X, type YFormatSettings as Y, getResolvedColor as Z, getThemeCategoricalColors as _, type ActionMenuProps as a, type StackNavGroup as a$, isLightColor as a0, type FieldValue as a1, type BooleanFormat as a2, type FormattedValue as a3, type FieldFormat as a4, type CurrentFormat as a5, type DateFormat as a6, type DistanceFormat as a7, type EnergyUnit as a8, type EnergyFormat as a9, CodeEditor as aA, type ColorSpec as aB, type ComponentFormatOptions as aC, type CurrentUnit as aD, type CustomFormat as aE, DEFAULT_MAP_TYPE as aF, type DateFormatStyle as aG, type DistanceUnit as aH, ENTITY_CATEGORY_CONFIG as aI, type EntityCategory as aJ, type EntityCategoryConfig as aK, GRID_STATE_COLORS as aL, type GridStateColor as aM, InteractiveMap as aN, type InteractiveMapHandle as aO, type LayerFeature as aP, type LayerStyle as aQ, MAP_TYPES as aR, type MapType as aS, Meter as aT, type MetricFormat as aU, type PercentageFormat as aV, type PowerUnit as aW, type RenderType as aX, type ResistanceUnit as aY, SegmentedControl as aZ, StackNav as a_, type CurrencyFormat as aa, type NumberFormat as ab, type PhoneFormat as ac, type PowerFormat as ad, type FormatterFunction as ae, type ResistanceFormat as af, type TemperatureFormat as ag, type TemperatureUnitString as ah, type TemperatureUnit as ai, type TextFormat as aj, type VoltageFormat as ak, type DeviceState as al, type GridState as am, type ComponentFormatter as an, type LayerSpec as ao, type CustomPinsSpec as ap, type GeoJsonLayerSpec as aq, type RasterLayerSpec as ar, type VectorLayerSpec as as, type ClusteredVectorLayerSpec as at, ActionMenu as au, AppShell as av, Avatar as aw, Badge as ax, type BaseFormat as ay, ChartContext as az, type AppShellProps as b, type StackNavItem as b0, type StackNavLinkComponentProps as b1, type StackNavProps as b2, type StackNavTheme as b3, StaticMap as b4, type TextTransform as b5, type TextTruncatePosition as b6, type VoltageUnit as b7, type ZoomStops as b8, activeDeviceStates as b9, baselineFromPoint as ba, deviceStateLabels as bb, deviceStateMetricFormats as bc, formatComponentValue as bd, getDeviceStateLabel as be, getEntityCategory as bf, getGridStateLabel as bg, gridStateLabels as bh, isActiveState as bi, mapValuesToCategoricalColors as bj, useChartContext as bk, useComponentFormatter as bl, type AvatarProps as c, type BaseDataPoint as d, type CodeEditorProps as e, type CodeLanguage as f, type CodeTheme as g, type EntityArchetype as h, type EntityConfig as i, type EntityStateRule as j, type EntityType as k, Heading as l, type HeadlineMetric as m, Logo as n, type MeterProps as o, type SegmentedControlProps as p, type SerializableFieldFormat as q, SideNav as r, type SideNavItem as s, type SideNavProps as t, type StaticMapProps as u, type TooltipData as v, type TooltipSeries as w, TopNav as x, type TopNavProps as y, type YFormatType as z };