@texturehq/edges 5.8.0 → 5.10.0

package/dist/{colors-Bw7a6pAI.d.ts → colors-B7iUqDUu.d.ts}

@@ -1886,6 +1886,20 @@ interface VectorLayerSpec extends BaseLayerSpec {
      * rendered as a bracket over the conductor line. Ignored for non-circle layers.
      */
     hideChipWhen?: any;
+    /**
+     * Reveal the chip (circle fill + border) only while the feature is hovered —
+     * the resting render is fully transparent, so only a glyph drawn on top
+     * occupies the map. For dense point layers (e.g. tens of thousands of
+     * support structures) where a permanent chip per feature is visual noise.
+     *
+     * Driven by the `hover` feature-state, which `InteractiveMap` sets/clears in
+     * its shared mouse handlers — so this only works for layers rendered inside
+     * an InteractiveMap, and **requires `promoteId`** (feature-state needs
+     * feature ids, and vector-tile features usually have none). Composes with
+     * `hideChipWhen`: features matching that expression stay chipless even while
+     * hovered. Ignored for non-circle layers.
+     */
+    revealChipOnHover?: boolean;
 }
 /**
  * GeoJSON layer (client-side data or URL)
@@ -2804,7 +2818,7 @@ type EntityCategory = "platform" | "grid" | "device";
  * - `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 —
+ * `ENTITY_CONFIG` carries an archetype, even the 13 that have no detail page —
  * the archetype is the composition it *would* use; `detailPage` gates whether a
  * page is actually reachable.
  */
@@ -2977,13 +2991,13 @@ interface EntityConfig {
         closed: EntityStateVariant;
     };
     /**
-     * The base page composition this entity renders with. Required on all 42
+     * The base page composition this entity renders with. Required on all 43
      * 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
+     * Whether this entity has a reachable detail page. 30 of 43 are `true`; the
      * registry is the single answer to "does this entity have a page?".
      */
     detailPage: boolean;
@@ -3014,8 +3028,13 @@ interface EntityConfig {
     fusedMetricId?: string;
     /**
      * 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.
+     * pulsing primary chip; `secondaryState` renders a second chip with no pulse.
+     *
+     * Only `battery` declares a `secondaryState` today (charge + grid). This
+     * docstring used to say "battery/inverter" — `inverter` has never had one, and
+     * the fix is this comment, not the code: adding a `secondaryState` to inverter
+     * would put a new chip on a live page, which is a product change wearing a
+     * typo's clothes.
      */
     stateRules?: {
         primaryState: EntityStateRule;
@@ -3091,7 +3110,7 @@ declare const ENTITY_CATEGORY_CONFIG: {
 };
 /** 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" | "SUPPORT_STRUCTURE" | "SWITCH" | "TRANSFORMER" | "UNDERGROUND_LINE";
+type GridElementSourceType = "CAPACITOR" | "CONSUMER" | "DEVICE_LEADER" | "GENERATOR" | "MOTOR" | "NODE" | "OVERCURRENT_DEVICE" | "OVERHEAD_LINE" | "REGULATOR" | "SOURCE" | "SUPPORT_STRUCTURE" | "SWITCH" | "TRANSFORMER" | "TRANSFORMER_BANK" | "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
@@ -3266,6 +3285,14 @@ declare const GRID_STAT_LIST: {
         readonly format: {
             readonly type: "text";
         };
+    }, {
+        readonly key: "max_continuous_current";
+        readonly label: "Max Continuous Current";
+        readonly format: {
+            readonly type: "number";
+            readonly unit: "A";
+            readonly decimals: 0;
+        };
     }, {
         readonly key: "switchIsOpen";
         readonly label: "Position";
@@ -3472,6 +3499,13 @@ declare const GRID_STAT_LIST: {
         readonly format: {
             readonly type: "text";
         };
+    }, {
+        readonly key: "generator_system_size";
+        readonly label: "System Size";
+        readonly format: {
+            readonly type: "number";
+            readonly decimals: 1;
+        };
     }];
     readonly MOTOR: [{
         readonly key: "ratedPower";
@@ -3490,6 +3524,8 @@ declare const GRID_STAT_LIST: {
             readonly decimals: 0;
         };
     }];
+    readonly DEVICE_LEADER: [];
+    readonly TRANSFORMER_BANK: [];
 };
 declare const ENTITY_CONFIG: {
     readonly app: {
@@ -3635,6 +3671,17 @@ declare const ENTITY_CONFIG: {
         };
         readonly description: "Rule that watches a metric against a threshold";
     };
+    readonly insight: {
+        readonly icon: "LightbulbFilament";
+        readonly category: "platform";
+        readonly archetype: "platform";
+        readonly detailPage: false;
+        readonly label: {
+            readonly singular: "Insight";
+            readonly plural: "Insights";
+        };
+        readonly description: "Derived finding surfaced from platform data";
+    };
     readonly command: {
         readonly icon: "Play";
         readonly category: "platform";
@@ -3772,6 +3819,14 @@ declare const ENTITY_CONFIG: {
                 readonly format: {
                     readonly type: "text";
                 };
+            }, {
+                readonly key: "max_continuous_current";
+                readonly label: "Max Continuous Current";
+                readonly format: {
+                    readonly type: "number";
+                    readonly unit: "A";
+                    readonly decimals: 0;
+                };
             }, {
                 readonly key: "switchIsOpen";
                 readonly label: "Position";
@@ -3826,6 +3881,14 @@ declare const ENTITY_CONFIG: {
                 readonly format: {
                     readonly type: "text";
                 };
+            }, {
+                readonly key: "max_continuous_current";
+                readonly label: "Max Continuous Current";
+                readonly format: {
+                    readonly type: "number";
+                    readonly unit: "A";
+                    readonly decimals: 0;
+                };
             }, {
                 readonly key: "switchIsOpen";
                 readonly label: "Position";
@@ -4486,6 +4549,13 @@ declare const ENTITY_CONFIG: {
                 readonly format: {
                     readonly type: "text";
                 };
+            }, {
+                readonly key: "generator_system_size";
+                readonly label: "System Size";
+                readonly format: {
+                    readonly type: "number";
+                    readonly decimals: 1;
+                };
             }];
         };
         readonly label: {
@@ -4588,6 +4658,34 @@ declare const ENTITY_CONFIG: {
         };
         readonly description: "Structure carrying overhead line equipment";
     };
+    readonly deviceLeader: {
+        readonly icon: "FlowArrow";
+        readonly category: "grid";
+        readonly archetype: "grid-line";
+        readonly detailPage: true;
+        readonly properties: {
+            readonly statList: [];
+        };
+        readonly label: {
+            readonly singular: "Device Leader";
+            readonly plural: "Device Leaders";
+        };
+        readonly description: "Cartographic leader line pointing an offset device symbol to its true location";
+    };
+    readonly transformerBank: {
+        readonly icon: "TextureTransformer";
+        readonly category: "grid";
+        readonly archetype: "grid-energized";
+        readonly detailPage: true;
+        readonly properties: {
+            readonly statList: [];
+        };
+        readonly label: {
+            readonly singular: "Transformer Bank";
+            readonly plural: "Transformer Banks";
+        };
+        readonly description: "Grouping of single-phase transformer units sharing a bank id";
+    };
     readonly battery: {
         readonly icon: "BatteryHigh";
         readonly category: "device";
@@ -5026,6 +5124,8 @@ declare const GRID_ELEMENT_TYPE_BY_ENTITY: {
     readonly generator: "GENERATOR";
     readonly regulator: "REGULATOR";
     readonly supportStructure: "SUPPORT_STRUCTURE";
+    readonly deviceLeader: "DEVICE_LEADER";
+    readonly transformerBank: "TRANSFORMER_BANK";
 };
 /**
  * Get entity configuration by type
@@ -5112,6 +5212,14 @@ declare function entityHasDetailPage(entityType: EntityType): boolean;
  * registry yet), Site, Customer and Water Heater return `false` — `entity.now`
  * declines to render its cells rather than crashing or rendering empty.
  *
+ * Exported deliberately, with no host consumer yet (MR-P02-4). Inside this package
+ * it backs the conformance assertions in `entities.test.ts`; outside it, the
+ * intended consumer is P11's `visible-when` work, which needs "does this entity
+ * have a Now at all?" to decide whether to place the block. Checked rather than
+ * guessed: knip (`--workspace packages/edges --include exports`) does not flag it,
+ * because `src/index.ts` and `src/server.ts` are configured entry points. If that
+ * changes, drop the `export` — it is used internally either way.
+ *
  * @param entityType - The entity type key
  */
 declare function entityShowsNow(entityType: EntityType): boolean;

package/dist/{colors-CM2yXnpR.d.cts → colors-DyB9mRDa.d.cts}

@@ -1886,6 +1886,20 @@ interface VectorLayerSpec extends BaseLayerSpec {
      * rendered as a bracket over the conductor line. Ignored for non-circle layers.
      */
     hideChipWhen?: any;
+    /**
+     * Reveal the chip (circle fill + border) only while the feature is hovered —
+     * the resting render is fully transparent, so only a glyph drawn on top
+     * occupies the map. For dense point layers (e.g. tens of thousands of
+     * support structures) where a permanent chip per feature is visual noise.
+     *
+     * Driven by the `hover` feature-state, which `InteractiveMap` sets/clears in
+     * its shared mouse handlers — so this only works for layers rendered inside
+     * an InteractiveMap, and **requires `promoteId`** (feature-state needs
+     * feature ids, and vector-tile features usually have none). Composes with
+     * `hideChipWhen`: features matching that expression stay chipless even while
+     * hovered. Ignored for non-circle layers.
+     */
+    revealChipOnHover?: boolean;
 }
 /**
  * GeoJSON layer (client-side data or URL)
@@ -2804,7 +2818,7 @@ type EntityCategory = "platform" | "grid" | "device";
  * - `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 —
+ * `ENTITY_CONFIG` carries an archetype, even the 13 that have no detail page —
  * the archetype is the composition it *would* use; `detailPage` gates whether a
  * page is actually reachable.
  */
@@ -2977,13 +2991,13 @@ interface EntityConfig {
         closed: EntityStateVariant;
     };
     /**
-     * The base page composition this entity renders with. Required on all 42
+     * The base page composition this entity renders with. Required on all 43
      * 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
+     * Whether this entity has a reachable detail page. 30 of 43 are `true`; the
      * registry is the single answer to "does this entity have a page?".
      */
     detailPage: boolean;
@@ -3014,8 +3028,13 @@ interface EntityConfig {
     fusedMetricId?: string;
     /**
      * 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.
+     * pulsing primary chip; `secondaryState` renders a second chip with no pulse.
+     *
+     * Only `battery` declares a `secondaryState` today (charge + grid). This
+     * docstring used to say "battery/inverter" — `inverter` has never had one, and
+     * the fix is this comment, not the code: adding a `secondaryState` to inverter
+     * would put a new chip on a live page, which is a product change wearing a
+     * typo's clothes.
      */
     stateRules?: {
         primaryState: EntityStateRule;
@@ -3091,7 +3110,7 @@ declare const ENTITY_CATEGORY_CONFIG: {
 };
 /** 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" | "SUPPORT_STRUCTURE" | "SWITCH" | "TRANSFORMER" | "UNDERGROUND_LINE";
+type GridElementSourceType = "CAPACITOR" | "CONSUMER" | "DEVICE_LEADER" | "GENERATOR" | "MOTOR" | "NODE" | "OVERCURRENT_DEVICE" | "OVERHEAD_LINE" | "REGULATOR" | "SOURCE" | "SUPPORT_STRUCTURE" | "SWITCH" | "TRANSFORMER" | "TRANSFORMER_BANK" | "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
@@ -3266,6 +3285,14 @@ declare const GRID_STAT_LIST: {
         readonly format: {
             readonly type: "text";
         };
+    }, {
+        readonly key: "max_continuous_current";
+        readonly label: "Max Continuous Current";
+        readonly format: {
+            readonly type: "number";
+            readonly unit: "A";
+            readonly decimals: 0;
+        };
     }, {
         readonly key: "switchIsOpen";
         readonly label: "Position";
@@ -3472,6 +3499,13 @@ declare const GRID_STAT_LIST: {
         readonly format: {
             readonly type: "text";
         };
+    }, {
+        readonly key: "generator_system_size";
+        readonly label: "System Size";
+        readonly format: {
+            readonly type: "number";
+            readonly decimals: 1;
+        };
     }];
     readonly MOTOR: [{
         readonly key: "ratedPower";
@@ -3490,6 +3524,8 @@ declare const GRID_STAT_LIST: {
             readonly decimals: 0;
         };
     }];
+    readonly DEVICE_LEADER: [];
+    readonly TRANSFORMER_BANK: [];
 };
 declare const ENTITY_CONFIG: {
     readonly app: {
@@ -3635,6 +3671,17 @@ declare const ENTITY_CONFIG: {
         };
         readonly description: "Rule that watches a metric against a threshold";
     };
+    readonly insight: {
+        readonly icon: "LightbulbFilament";
+        readonly category: "platform";
+        readonly archetype: "platform";
+        readonly detailPage: false;
+        readonly label: {
+            readonly singular: "Insight";
+            readonly plural: "Insights";
+        };
+        readonly description: "Derived finding surfaced from platform data";
+    };
     readonly command: {
         readonly icon: "Play";
         readonly category: "platform";
@@ -3772,6 +3819,14 @@ declare const ENTITY_CONFIG: {
                 readonly format: {
                     readonly type: "text";
                 };
+            }, {
+                readonly key: "max_continuous_current";
+                readonly label: "Max Continuous Current";
+                readonly format: {
+                    readonly type: "number";
+                    readonly unit: "A";
+                    readonly decimals: 0;
+                };
             }, {
                 readonly key: "switchIsOpen";
                 readonly label: "Position";
@@ -3826,6 +3881,14 @@ declare const ENTITY_CONFIG: {
                 readonly format: {
                     readonly type: "text";
                 };
+            }, {
+                readonly key: "max_continuous_current";
+                readonly label: "Max Continuous Current";
+                readonly format: {
+                    readonly type: "number";
+                    readonly unit: "A";
+                    readonly decimals: 0;
+                };
             }, {
                 readonly key: "switchIsOpen";
                 readonly label: "Position";
@@ -4486,6 +4549,13 @@ declare const ENTITY_CONFIG: {
                 readonly format: {
                     readonly type: "text";
                 };
+            }, {
+                readonly key: "generator_system_size";
+                readonly label: "System Size";
+                readonly format: {
+                    readonly type: "number";
+                    readonly decimals: 1;
+                };
             }];
         };
         readonly label: {
@@ -4588,6 +4658,34 @@ declare const ENTITY_CONFIG: {
         };
         readonly description: "Structure carrying overhead line equipment";
     };
+    readonly deviceLeader: {
+        readonly icon: "FlowArrow";
+        readonly category: "grid";
+        readonly archetype: "grid-line";
+        readonly detailPage: true;
+        readonly properties: {
+            readonly statList: [];
+        };
+        readonly label: {
+            readonly singular: "Device Leader";
+            readonly plural: "Device Leaders";
+        };
+        readonly description: "Cartographic leader line pointing an offset device symbol to its true location";
+    };
+    readonly transformerBank: {
+        readonly icon: "TextureTransformer";
+        readonly category: "grid";
+        readonly archetype: "grid-energized";
+        readonly detailPage: true;
+        readonly properties: {
+            readonly statList: [];
+        };
+        readonly label: {
+            readonly singular: "Transformer Bank";
+            readonly plural: "Transformer Banks";
+        };
+        readonly description: "Grouping of single-phase transformer units sharing a bank id";
+    };
     readonly battery: {
         readonly icon: "BatteryHigh";
         readonly category: "device";
@@ -5026,6 +5124,8 @@ declare const GRID_ELEMENT_TYPE_BY_ENTITY: {
     readonly generator: "GENERATOR";
     readonly regulator: "REGULATOR";
     readonly supportStructure: "SUPPORT_STRUCTURE";
+    readonly deviceLeader: "DEVICE_LEADER";
+    readonly transformerBank: "TRANSFORMER_BANK";
 };
 /**
  * Get entity configuration by type
@@ -5112,6 +5212,14 @@ declare function entityHasDetailPage(entityType: EntityType): boolean;
  * registry yet), Site, Customer and Water Heater return `false` — `entity.now`
  * declines to render its cells rather than crashing or rendering empty.
  *
+ * Exported deliberately, with no host consumer yet (MR-P02-4). Inside this package
+ * it backs the conformance assertions in `entities.test.ts`; outside it, the
+ * intended consumer is P11's `visible-when` work, which needs "does this entity
+ * have a Now at all?" to decide whether to place the block. Checked rather than
+ * guessed: knip (`--workspace packages/edges --include exports`) does not flag it,
+ * because `src/index.ts` and `src/server.ts` are configured entry points. If that
+ * changes, drop the `export` — it is used internally either way.
+ *
  * @param entityType - The entity type key
  */
 declare function entityShowsNow(entityType: EntityType): boolean;