@texturehq/edges 3.1.1 → 3.1.2

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

@@ -1531,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
@@ -1650,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
@@ -4278,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 StackNavRenderRow as bc, type StackNavRowRenderProps as bd, type StackNavTheme as be, StaticMap as bf, type TextTransform as bg, type TextTruncatePosition as bh, UNVERIFIED_VOLTAGE_UNIT_ROWS as bi, type VoltageUnit as bj, type ZoomStops as bk, activeDeviceStates as bl, baselineFromPoint as bm, deviceStateLabels as bn, deviceStateMetricFormats as bo, formatComponentValue as bp, getDeviceStateLabel as bq, getEntityCategory as br, getGridStateLabel as bs, gridStateLabels as bt, isActiveState as bu, mapValuesToCategoricalColors as bv, useChartContext as bw, useComponentFormatter as bx, 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-3zFRtH8q.d.ts → colors-vcCsLoIo.d.ts}

@@ -1531,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
@@ -1650,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
@@ -4278,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 StackNavRenderRow as bc, type StackNavRowRenderProps as bd, type StackNavTheme as be, StaticMap as bf, type TextTransform as bg, type TextTruncatePosition as bh, UNVERIFIED_VOLTAGE_UNIT_ROWS as bi, type VoltageUnit as bj, type ZoomStops as bk, activeDeviceStates as bl, baselineFromPoint as bm, deviceStateLabels as bn, deviceStateMetricFormats as bo, formatComponentValue as bp, getDeviceStateLabel as bq, getEntityCategory as br, getGridStateLabel as bs, gridStateLabels as bt, isActiveState as bu, mapValuesToCategoricalColors as bv, useChartContext as bw, useComponentFormatter as bx, 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 };