@texturehq/edges 3.1.0 → 3.1.2

package/dist/{colors-DJDkptUU.d.cts → colors-BJ7jego1.d.cts}

@@ -227,6 +227,43 @@ type StackNavLinkComponentProps = {
     "aria-current"?: "page" | undefined;
     onClick?: (event: React$1.MouseEvent<HTMLAnchorElement>) => void;
 };
+type StackNavRowRenderProps = {
+    item: StackNavItem;
+    isActive: boolean;
+    /**
+     * Whether the item has children. Use it to decide whether to draw a drill-in
+     * affordance.
+     *
+     * Note this reports child presence, not a guarantee about `select`: the click
+     * path pushes a pane whenever children exist and does not consult
+     * `pushOnSelect`, which today only affects deep-link resolution. That
+     * discrepancy predates this prop and is left alone here rather than changed
+     * underneath existing consumers.
+     */
+    hasChildren: boolean;
+    /**
+     * Run StackNav's selection: report through `onSelect` and push the sub-pane
+     * when the item has children.
+     *
+     * This does **not** navigate `href`. The built-in row navigates because it is
+     * itself an anchor and the browser follows it; a custom row must render its
+     * own anchor — `LinkComponent` below — for `href` to do anything.
+     */
+    select: (event: React$1.MouseEvent) => void;
+    /**
+     * The anchor component configured on the nav (`linkComponent`, defaulting to
+     * a native `<a>`). Render `href` rows through this so router integration and
+     * navigation keep working.
+     */
+    LinkComponent: React$1.ComponentType<StackNavLinkComponentProps>;
+    /** Class list the built-in row uses, for custom rows that want its base styling. */
+    className: string;
+};
+/**
+ * Renders one row in place of the built-in one. Return any node; the pane stack,
+ * back affordance, and drill-in logic stay with StackNav.
+ */
+type StackNavRenderRow = (props: StackNavRowRenderProps) => React$1.ReactNode;
 /**
  * Color overrides for the rail surface and row affordances. Any value accepted
  * by CSS (`#hex`, `rgb()`, `var(--token)`, etc.) is fine; each entry maps to a
@@ -318,6 +355,20 @@ type StackNavProps = {
      * Defaults to a native `<a>`.
      */
     linkComponent?: React$1.ComponentType<StackNavLinkComponentProps>;
+    /**
+     * Take over rendering of the rows, keeping this component's pane stack, back
+     * affordance, and drill-in behavior.
+     *
+     * Needed when a row must carry its own interactive control — a checkbox, a
+     * switch — which cannot go in `leading`, since that renders inside the row's
+     * link/button, making it invalid markup and giving one click target two
+     * actions. A custom row can place the control as a sibling of whatever it
+     * makes navigable.
+     *
+     * Dividers and group labels are unaffected. Omit this and rows render exactly
+     * as they always have.
+     */
+    renderRow?: StackNavRenderRow | undefined;
     /**
      * Render the Texture logo at the top of the rail (above any `header` slot).
      * Set `logo` to override the default mark; otherwise the standard `<Logo />`
@@ -382,7 +433,7 @@ type StackNavProps = {
      */
     sidebarCollapseId?: string;
 };
-declare function StackNav({ items, groups, bottomItems, value, defaultStack, stack: controlledStack, onStackChange, onSelect, linkComponent: LinkComponent, showLogo, logo, header, footer, mobileMenuId, sidebarCollapseId, rootLabel, sticky, width, ariaLabel, theme, animated, style, className, }: StackNavProps): react_jsx_runtime.JSX.Element;
+declare function StackNav({ items, groups, bottomItems, value, defaultStack, stack: controlledStack, onStackChange, onSelect, linkComponent: LinkComponent, renderRow, showLogo, logo, header, footer, mobileMenuId, sidebarCollapseId, rootLabel, sticky, width, ariaLabel, theme, animated, style, className, }: StackNavProps): react_jsx_runtime.JSX.Element;
 
 type ColorMode = "system" | "light" | "dark";
 type TopNavProps = {
@@ -1480,6 +1531,60 @@ interface ClusteredVectorLayerSpec extends Omit<BaseLayerSpec, "tooltip"> {
  * Union of all layer types
  */
 type LayerSpec = VectorLayerSpec | GeoJsonLayerSpec | CustomPinsSpec | RasterLayerSpec | ClusteredVectorLayerSpec;
+/**
+ * One row in the layers panel.
+ *
+ * Depth is whatever the config declares — a node with `children` is a container
+ * the panel drills into, a node with `layerId` is a leaf controlling that layer.
+ * The shape mirrors `StackNavItem`/`SideNavItem`, with `layerId` playing the
+ * role `href` plays there.
+ *
+ * Kept separate from `LayerSpec` because containers have no geometry of their
+ * own: "Grid infrastructure" is a heading over Transformers and Feeders, not a
+ * layer that could be rendered.
+ */
+interface LayerTreeNode {
+    /** Stable identifier, unique across the tree. */
+    id: string;
+    label: string;
+    /** Leaf only: the `LayerSpec.id` this row shows and hides. */
+    layerId?: string;
+    /** Container only: nested rows, to any depth. */
+    children?: LayerTreeNode[];
+    /**
+     * How many of this node's children may be on at once. Defaults to `multi`.
+     *
+     * `single` is for a layer whose children are alternatives rather than
+     * additions — weather showing temperature *or* wind, never both. Those render
+     * as radios, and choosing one turns its siblings off.
+     */
+    selection?: LayerSelection;
+}
+/**
+ * Children of a `single` node are mutually exclusive. `allowNone` lets the user
+ * clear the choice from within the child pane; without it the only way back to
+ * nothing-selected is the parent's own checkbox.
+ */
+type LayerSelection = {
+    mode: "multi";
+} | {
+    mode: "single";
+    allowNone?: boolean;
+};
+/**
+ * A row's checkbox state. Containers are `indeterminate` when only some of the
+ * leaves beneath them are visible — impossible under `single` selection, where a
+ * node is either off or showing exactly one child.
+ */
+type LayerCheckState = "checked" | "unchecked" | "indeterminate";
+/**
+ * A visibility change as an explicit target state per layer.
+ *
+ * A map rather than `(ids, visible)` because single-select changes two things at
+ * once — one layer on, its siblings off — and splitting that across two calls
+ * would let the map render a moment with everything off.
+ */
+type LayerVisibilityPatch = Record<string, boolean>;
 
 /**
  * Unified map style configuration for all map components
@@ -1599,6 +1704,17 @@ interface LayersControl extends BaseControl {
      * declaring `legend.variants`.
      */
     onLayerVariantChange?: (layerId: string, variantId: string) => void;
+    /**
+     * Recursive layer tree. When provided, the control renders the drill-down
+     * layers panel in place of the flat list.
+     */
+    layerTree?: LayerTreeNode[];
+    /**
+     * Apply a visibility change from the panel, given as the target state per
+     * affected layer. Container toggles and single-select choices both arrive as
+     * one patch. Only used alongside `layerTree`.
+     */
+    onVisibilityChange?: (patch: LayerVisibilityPatch) => void;
 }
 /**
  * Search control configuration
@@ -2463,6 +2579,31 @@ type GridElementSourceType = "CAPACITOR" | "CONSUMER" | "GENERATOR" | "MOTOR" |
  * by the conformance test, not just documented.
  */
 declare const ABSENT_GRID_FIELDS: readonly ["energized", "customerName", "gs_max_continuous_current"];
+/**
+ * MR-G12 §5 -- voltage stat-list rows still sourced from a RAW metadata key whose
+ * unit has NOT been measured against prod.
+ *
+ * The conformance rule (`entities.test.ts`): a `GRID_STAT_LIST` row with
+ * `format.type === "voltage"` must EITHER reference a normalized/decoded key
+ * (suffix `Kv`, i.e. the unit is established by construction) OR be listed here.
+ * `formatGridStatValue` takes the unit straight from this config and performs no
+ * conversion, so an unmeasured raw key is a three-order-of-magnitude error waiting
+ * to ship -- exactly how `TRANSFORMER.primaryRatedVoltage` shipped "7 V" for a
+ * 7.2 kV transformer. Listing a row here is a deliberate, reviewable admission
+ * that its unit is unverified, not an oversight.
+ *
+ * Status per row (as of 2026-08-17):
+ *   • CAPACITOR / NODE `nominalVoltage` -- NOT measured; DQ-3 covered transformers
+ *     only. Deliberately NOT fixed blind: added to the next DB round (DQ-10). If
+ *     they show the transformer pattern, one decision fixes both.
+ *   • REGULATOR `outputVoltagePh{A,B,C}` -- lower risk: the SCADA audit observed
+ *     regulator volts in the 7,261...20,538 V range, but that is TELEMETRY, not
+ *     this metadata key.
+ *   • GENERATOR `outputVoltage` / MOTOR `voltage` -- small populations.
+ *
+ * Entries are `${GridElementSourceType}.${key}`.
+ */
+declare const UNVERIFIED_VOLTAGE_UNIT_ROWS: readonly ["CAPACITOR.nominalVoltage", "NODE.nominalVoltage", "REGULATOR.outputVoltagePhA", "REGULATOR.outputVoltagePhB", "REGULATOR.outputVoltagePhC", "GENERATOR.outputVoltage", "MOTOR.voltage"];
 /**
  * Static property rows per `GridElementType`, transcribed from
  * `grid-element-config/src/configs/*.config.ts` `metadataFields`. Serializable:
@@ -2478,12 +2619,20 @@ declare const GRID_STAT_LIST: {
             readonly decimals: 0;
         };
     }, {
-        readonly key: "primaryRatedVoltage";
+        readonly key: "primaryVoltageKv";
         readonly label: "Primary Voltage";
         readonly format: {
             readonly type: "voltage";
-            readonly unit: "V";
-            readonly decimals: 0;
+            readonly unit: "kV";
+            readonly decimals: 1;
+        };
+    }, {
+        readonly key: "outputVoltageKv";
+        readonly label: "Output Voltage";
+        readonly format: {
+            readonly type: "voltage";
+            readonly unit: "kV";
+            readonly decimals: 2;
         };
     }];
     readonly CONSUMER: [{
@@ -3058,12 +3207,20 @@ declare const ENTITY_CONFIG: {
                     readonly decimals: 0;
                 };
             }, {
-                readonly key: "primaryRatedVoltage";
+                readonly key: "primaryVoltageKv";
                 readonly label: "Primary Voltage";
                 readonly format: {
                     readonly type: "voltage";
-                    readonly unit: "V";
-                    readonly decimals: 0;
+                    readonly unit: "kV";
+                    readonly decimals: 1;
+                };
+            }, {
+                readonly key: "outputVoltageKv";
+                readonly label: "Output Voltage";
+                readonly format: {
+                    readonly type: "voltage";
+                    readonly unit: "kV";
+                    readonly decimals: 2;
                 };
             }];
         };
@@ -4186,4 +4343,4 @@ declare const getContrastingTextColor: (backgroundColor: string) => string;
  */
 declare const mapValuesToCategoricalColors: (values: (string | number)[]) => Record<string | number, string>;
 
-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 };
+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 LayerStyle 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, type ColorSpec as aD, ActionMenu as aE, AppShell as aF, Avatar as aG, Badge as aH, type BaseFormat as aI, ChartContext as aJ, CodeEditor 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 LayerCheckState as aY, type LayerFeature as aZ, type LayerSelection 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, type LayerTreeNode as b0, type LayerVisibilityPatch as b1, MAP_TYPES as b2, type MapType as b3, Meter as b4, type MetricFormat as b5, type PercentageFormat as b6, type PowerUnit as b7, type RenderType as b8, type ResistanceUnit as b9, useChartContext as bA, useComponentFormatter as bB, SegmentedControl as ba, StackNav as bb, type StackNavGroup as bc, type StackNavItem as bd, type StackNavLinkComponentProps as be, type StackNavProps as bf, type StackNavRenderRow as bg, type StackNavRowRenderProps as bh, type StackNavTheme as bi, StaticMap as bj, type TextTransform as bk, type TextTruncatePosition as bl, UNVERIFIED_VOLTAGE_UNIT_ROWS as bm, type VoltageUnit as bn, type ZoomStops as bo, activeDeviceStates as bp, baselineFromPoint as bq, deviceStateLabels as br, deviceStateMetricFormats as bs, formatComponentValue as bt, getDeviceStateLabel as bu, getEntityCategory as bv, getGridStateLabel as bw, gridStateLabels as bx, isActiveState as by, mapValuesToCategoricalColors as bz, 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 };

package/dist/{colors-JkpMFxrb.d.ts → colors-vcCsLoIo.d.ts}

@@ -227,6 +227,43 @@ type StackNavLinkComponentProps = {
     "aria-current"?: "page" | undefined;
     onClick?: (event: React$1.MouseEvent<HTMLAnchorElement>) => void;
 };
+type StackNavRowRenderProps = {
+    item: StackNavItem;
+    isActive: boolean;
+    /**
+     * Whether the item has children. Use it to decide whether to draw a drill-in
+     * affordance.
+     *
+     * Note this reports child presence, not a guarantee about `select`: the click
+     * path pushes a pane whenever children exist and does not consult
+     * `pushOnSelect`, which today only affects deep-link resolution. That
+     * discrepancy predates this prop and is left alone here rather than changed
+     * underneath existing consumers.
+     */
+    hasChildren: boolean;
+    /**
+     * Run StackNav's selection: report through `onSelect` and push the sub-pane
+     * when the item has children.
+     *
+     * This does **not** navigate `href`. The built-in row navigates because it is
+     * itself an anchor and the browser follows it; a custom row must render its
+     * own anchor — `LinkComponent` below — for `href` to do anything.
+     */
+    select: (event: React$1.MouseEvent) => void;
+    /**
+     * The anchor component configured on the nav (`linkComponent`, defaulting to
+     * a native `<a>`). Render `href` rows through this so router integration and
+     * navigation keep working.
+     */
+    LinkComponent: React$1.ComponentType<StackNavLinkComponentProps>;
+    /** Class list the built-in row uses, for custom rows that want its base styling. */
+    className: string;
+};
+/**
+ * Renders one row in place of the built-in one. Return any node; the pane stack,
+ * back affordance, and drill-in logic stay with StackNav.
+ */
+type StackNavRenderRow = (props: StackNavRowRenderProps) => React$1.ReactNode;
 /**
  * Color overrides for the rail surface and row affordances. Any value accepted
  * by CSS (`#hex`, `rgb()`, `var(--token)`, etc.) is fine; each entry maps to a
@@ -318,6 +355,20 @@ type StackNavProps = {
      * Defaults to a native `<a>`.
      */
     linkComponent?: React$1.ComponentType<StackNavLinkComponentProps>;
+    /**
+     * Take over rendering of the rows, keeping this component's pane stack, back
+     * affordance, and drill-in behavior.
+     *
+     * Needed when a row must carry its own interactive control — a checkbox, a
+     * switch — which cannot go in `leading`, since that renders inside the row's
+     * link/button, making it invalid markup and giving one click target two
+     * actions. A custom row can place the control as a sibling of whatever it
+     * makes navigable.
+     *
+     * Dividers and group labels are unaffected. Omit this and rows render exactly
+     * as they always have.
+     */
+    renderRow?: StackNavRenderRow | undefined;
     /**
      * Render the Texture logo at the top of the rail (above any `header` slot).
      * Set `logo` to override the default mark; otherwise the standard `<Logo />`
@@ -382,7 +433,7 @@ type StackNavProps = {
      */
     sidebarCollapseId?: string;
 };
-declare function StackNav({ items, groups, bottomItems, value, defaultStack, stack: controlledStack, onStackChange, onSelect, linkComponent: LinkComponent, showLogo, logo, header, footer, mobileMenuId, sidebarCollapseId, rootLabel, sticky, width, ariaLabel, theme, animated, style, className, }: StackNavProps): react_jsx_runtime.JSX.Element;
+declare function StackNav({ items, groups, bottomItems, value, defaultStack, stack: controlledStack, onStackChange, onSelect, linkComponent: LinkComponent, renderRow, showLogo, logo, header, footer, mobileMenuId, sidebarCollapseId, rootLabel, sticky, width, ariaLabel, theme, animated, style, className, }: StackNavProps): react_jsx_runtime.JSX.Element;
 
 type ColorMode = "system" | "light" | "dark";
 type TopNavProps = {
@@ -1480,6 +1531,60 @@ interface ClusteredVectorLayerSpec extends Omit<BaseLayerSpec, "tooltip"> {
  * Union of all layer types
  */
 type LayerSpec = VectorLayerSpec | GeoJsonLayerSpec | CustomPinsSpec | RasterLayerSpec | ClusteredVectorLayerSpec;
+/**
+ * One row in the layers panel.
+ *
+ * Depth is whatever the config declares — a node with `children` is a container
+ * the panel drills into, a node with `layerId` is a leaf controlling that layer.
+ * The shape mirrors `StackNavItem`/`SideNavItem`, with `layerId` playing the
+ * role `href` plays there.
+ *
+ * Kept separate from `LayerSpec` because containers have no geometry of their
+ * own: "Grid infrastructure" is a heading over Transformers and Feeders, not a
+ * layer that could be rendered.
+ */
+interface LayerTreeNode {
+    /** Stable identifier, unique across the tree. */
+    id: string;
+    label: string;
+    /** Leaf only: the `LayerSpec.id` this row shows and hides. */
+    layerId?: string;
+    /** Container only: nested rows, to any depth. */
+    children?: LayerTreeNode[];
+    /**
+     * How many of this node's children may be on at once. Defaults to `multi`.
+     *
+     * `single` is for a layer whose children are alternatives rather than
+     * additions — weather showing temperature *or* wind, never both. Those render
+     * as radios, and choosing one turns its siblings off.
+     */
+    selection?: LayerSelection;
+}
+/**
+ * Children of a `single` node are mutually exclusive. `allowNone` lets the user
+ * clear the choice from within the child pane; without it the only way back to
+ * nothing-selected is the parent's own checkbox.
+ */
+type LayerSelection = {
+    mode: "multi";
+} | {
+    mode: "single";
+    allowNone?: boolean;
+};
+/**
+ * A row's checkbox state. Containers are `indeterminate` when only some of the
+ * leaves beneath them are visible — impossible under `single` selection, where a
+ * node is either off or showing exactly one child.
+ */
+type LayerCheckState = "checked" | "unchecked" | "indeterminate";
+/**
+ * A visibility change as an explicit target state per layer.
+ *
+ * A map rather than `(ids, visible)` because single-select changes two things at
+ * once — one layer on, its siblings off — and splitting that across two calls
+ * would let the map render a moment with everything off.
+ */
+type LayerVisibilityPatch = Record<string, boolean>;
 
 /**
  * Unified map style configuration for all map components
@@ -1599,6 +1704,17 @@ interface LayersControl extends BaseControl {
      * declaring `legend.variants`.
      */
     onLayerVariantChange?: (layerId: string, variantId: string) => void;
+    /**
+     * Recursive layer tree. When provided, the control renders the drill-down
+     * layers panel in place of the flat list.
+     */
+    layerTree?: LayerTreeNode[];
+    /**
+     * Apply a visibility change from the panel, given as the target state per
+     * affected layer. Container toggles and single-select choices both arrive as
+     * one patch. Only used alongside `layerTree`.
+     */
+    onVisibilityChange?: (patch: LayerVisibilityPatch) => void;
 }
 /**
  * Search control configuration
@@ -2463,6 +2579,31 @@ type GridElementSourceType = "CAPACITOR" | "CONSUMER" | "GENERATOR" | "MOTOR" |
  * by the conformance test, not just documented.
  */
 declare const ABSENT_GRID_FIELDS: readonly ["energized", "customerName", "gs_max_continuous_current"];
+/**
+ * MR-G12 §5 -- voltage stat-list rows still sourced from a RAW metadata key whose
+ * unit has NOT been measured against prod.
+ *
+ * The conformance rule (`entities.test.ts`): a `GRID_STAT_LIST` row with
+ * `format.type === "voltage"` must EITHER reference a normalized/decoded key
+ * (suffix `Kv`, i.e. the unit is established by construction) OR be listed here.
+ * `formatGridStatValue` takes the unit straight from this config and performs no
+ * conversion, so an unmeasured raw key is a three-order-of-magnitude error waiting
+ * to ship -- exactly how `TRANSFORMER.primaryRatedVoltage` shipped "7 V" for a
+ * 7.2 kV transformer. Listing a row here is a deliberate, reviewable admission
+ * that its unit is unverified, not an oversight.
+ *
+ * Status per row (as of 2026-08-17):
+ *   • CAPACITOR / NODE `nominalVoltage` -- NOT measured; DQ-3 covered transformers
+ *     only. Deliberately NOT fixed blind: added to the next DB round (DQ-10). If
+ *     they show the transformer pattern, one decision fixes both.
+ *   • REGULATOR `outputVoltagePh{A,B,C}` -- lower risk: the SCADA audit observed
+ *     regulator volts in the 7,261...20,538 V range, but that is TELEMETRY, not
+ *     this metadata key.
+ *   • GENERATOR `outputVoltage` / MOTOR `voltage` -- small populations.
+ *
+ * Entries are `${GridElementSourceType}.${key}`.
+ */
+declare const UNVERIFIED_VOLTAGE_UNIT_ROWS: readonly ["CAPACITOR.nominalVoltage", "NODE.nominalVoltage", "REGULATOR.outputVoltagePhA", "REGULATOR.outputVoltagePhB", "REGULATOR.outputVoltagePhC", "GENERATOR.outputVoltage", "MOTOR.voltage"];
 /**
  * Static property rows per `GridElementType`, transcribed from
  * `grid-element-config/src/configs/*.config.ts` `metadataFields`. Serializable:
@@ -2478,12 +2619,20 @@ declare const GRID_STAT_LIST: {
             readonly decimals: 0;
         };
     }, {
-        readonly key: "primaryRatedVoltage";
+        readonly key: "primaryVoltageKv";
         readonly label: "Primary Voltage";
         readonly format: {
             readonly type: "voltage";
-            readonly unit: "V";
-            readonly decimals: 0;
+            readonly unit: "kV";
+            readonly decimals: 1;
+        };
+    }, {
+        readonly key: "outputVoltageKv";
+        readonly label: "Output Voltage";
+        readonly format: {
+            readonly type: "voltage";
+            readonly unit: "kV";
+            readonly decimals: 2;
         };
     }];
     readonly CONSUMER: [{
@@ -3058,12 +3207,20 @@ declare const ENTITY_CONFIG: {
                     readonly decimals: 0;
                 };
             }, {
-                readonly key: "primaryRatedVoltage";
+                readonly key: "primaryVoltageKv";
                 readonly label: "Primary Voltage";
                 readonly format: {
                     readonly type: "voltage";
-                    readonly unit: "V";
-                    readonly decimals: 0;
+                    readonly unit: "kV";
+                    readonly decimals: 1;
+                };
+            }, {
+                readonly key: "outputVoltageKv";
+                readonly label: "Output Voltage";
+                readonly format: {
+                    readonly type: "voltage";
+                    readonly unit: "kV";
+                    readonly decimals: 2;
                 };
             }];
         };
@@ -4186,4 +4343,4 @@ declare const getContrastingTextColor: (backgroundColor: string) => string;
  */
 declare const mapValuesToCategoricalColors: (values: (string | number)[]) => Record<string | number, string>;
 
-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 };
+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 LayerStyle 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, type ColorSpec as aD, ActionMenu as aE, AppShell as aF, Avatar as aG, Badge as aH, type BaseFormat as aI, ChartContext as aJ, CodeEditor 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 LayerCheckState as aY, type LayerFeature as aZ, type LayerSelection 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, type LayerTreeNode as b0, type LayerVisibilityPatch as b1, MAP_TYPES as b2, type MapType as b3, Meter as b4, type MetricFormat as b5, type PercentageFormat as b6, type PowerUnit as b7, type RenderType as b8, type ResistanceUnit as b9, useChartContext as bA, useComponentFormatter as bB, SegmentedControl as ba, StackNav as bb, type StackNavGroup as bc, type StackNavItem as bd, type StackNavLinkComponentProps as be, type StackNavProps as bf, type StackNavRenderRow as bg, type StackNavRowRenderProps as bh, type StackNavTheme as bi, StaticMap as bj, type TextTransform as bk, type TextTruncatePosition as bl, UNVERIFIED_VOLTAGE_UNIT_ROWS as bm, type VoltageUnit as bn, type ZoomStops as bo, activeDeviceStates as bp, baselineFromPoint as bq, deviceStateLabels as br, deviceStateMetricFormats as bs, formatComponentValue as bt, getDeviceStateLabel as bu, getEntityCategory as bv, getGridStateLabel as bw, gridStateLabels as bx, isActiveState as by, mapValuesToCategoricalColors as bz, 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 };