@texturehq/edges 5.13.0 → 5.15.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -256,7 +256,9 @@ type StackNavItem = {
256
256
  *
257
257
  * If both `href` and `children` are present, clicking the row both navigates
258
258
  * to `href` (a section overview) and pushes its sub-pane onto the stack.
259
- * This mirrors the Vercel/Linear/Edges dashboard pattern.
259
+ * This mirrors the Vercel/Linear/Edges dashboard pattern. Set
260
+ * `pushOnSelect: false` to split the two: the row becomes a plain link and a
261
+ * separate chevron button drills into the sub-pane.
260
262
  */
261
263
  href?: string;
262
264
  /** Optional leading-edge icon. Alias-friendly for item models shared with SideNav. */
@@ -272,10 +274,12 @@ type StackNavItem = {
272
274
  /** Nested children. Triggers the drill-in arrow and pushes a new pane. */
273
275
  children?: StackNavItem[];
274
276
  /**
275
- * When `false` and the row has `children`, selecting the row only navigates
276
- * to `href` (if present) — it does not push a sub-pane. Useful for
277
- * "Overview" leaves that live in the same array as their siblings. Defaults
278
- * to `true`.
277
+ * When `false` and the row has both `children` and an `href`, selecting the
278
+ * row only navigates — it does not push a sub-pane; the row's chevron becomes
279
+ * a separate drill-in button, and a `value` matching the row keeps its own
280
+ * pane open rather than auto-opening the children. Without an `href` the row
281
+ * still drills in on click (there is nothing else it could do). Defaults to
282
+ * `true`.
279
283
  */
280
284
  pushOnSelect?: boolean;
281
285
  /** Aria-label override for screen readers. */
@@ -296,13 +300,13 @@ type StackNavRowRenderProps = {
296
300
  * Whether the item has children. Use it to decide whether to draw a drill-in
297
301
  * affordance.
298
302
  *
299
- * Note this reports child presence, not a guarantee about `select`: the click
300
- * path pushes a pane whenever children exist and does not consult
301
- * `pushOnSelect`, which today only affects deep-link resolution. That
302
- * discrepancy predates this prop and is left alone here rather than changed
303
- * underneath existing consumers.
303
+ * Note this reports child presence, not a guarantee about `select`: `select`
304
+ * pushes a pane when children exist unless the item is an `href` row with
305
+ * `pushOnSelect: false`, whose pane is pushed by `drillIn` instead.
304
306
  */
305
307
  hasChildren: boolean;
308
+ /** Push the item's sub-pane without navigating — the chevron affordance for split rows. */
309
+ drillIn: () => void;
306
310
  /**
307
311
  * Run StackNav's selection: report through `onSelect` and push the sub-pane
308
312
  * when the item has children.
@@ -986,6 +990,12 @@ interface Column<T> {
986
990
  showArrow?: boolean;
987
991
  trigger?: "hover" | "click";
988
992
  };
993
+ /**
994
+ * Tooltip text shown to the right of the column header label via an info icon.
995
+ * When set, a small help icon appears beside the label; hovering it reveals the
996
+ * tooltip. Useful for explaining column semantics without cluttering the header.
997
+ */
998
+ headerTooltip?: string;
989
999
  /** Label to use for this column in CSV export headers. Falls back to `label` if not provided. */
990
1000
  exportLabel?: string;
991
1001
  /**
@@ -1342,6 +1352,14 @@ interface TooltipSeries {
1342
1352
  interface SeriesMetadata {
1343
1353
  label: string;
1344
1354
  color: string;
1355
+ /**
1356
+ * Set only by a banded `AreaSeries` that opted into the min-max range tooltip.
1357
+ * `ChartContainer` has always put these on the metadata it provides; they were
1358
+ * simply not declared, so anything reading series off the context built tooltip
1359
+ * rows that silently dropped the lower bound.
1360
+ */
1361
+ baseline?: TooltipBaseline;
1362
+ tooltipRange?: boolean;
1345
1363
  }
1346
1364
  interface ChartContextType {
1347
1365
  xScale: ScaleTime<number, number>;
@@ -1376,6 +1394,13 @@ interface ChartContextType {
1376
1394
  declare const ChartContext: React$1.Context<ChartContextType | null>;
1377
1395
  declare const useChartContext: () => ChartContextType;
1378
1396
 
1397
+ /**
1398
+ * A banded area series' lower bound: a constant, or resolved per point.
1399
+ *
1400
+ * Structurally identical to `AreaSeriesBaseline`, restated here so this module
1401
+ * does not have to import from a component.
1402
+ */
1403
+ type TooltipBaseline = number | ((point: BaseDataPoint, index: number) => number);
1379
1404
  interface BaseDataPoint {
1380
1405
  xValue: Date;
1381
1406
  /**
@@ -5127,6 +5152,32 @@ declare const ENTITY_CONFIG: {
5127
5152
  };
5128
5153
  };
5129
5154
  type EntityType = keyof typeof ENTITY_CONFIG;
5155
+ /**
5156
+ * Every entity key in the `grid` category, as runtime data.
5157
+ *
5158
+ * Derived from `ENTITY_CONFIG` rather than written out, so a grid entity added
5159
+ * to the registry joins this set with no second edit — the failure mode a
5160
+ * hand-maintained list has, and the one that already cost us once: two
5161
+ * `GridElementType` values added to a *generated* union compiled cleanly, fell
5162
+ * through to a `default:`, and gave 6,571 Device Leaders the wrong icon and
5163
+ * label (see `gridEntityTypeFor` in the dashboard).
5164
+ *
5165
+ * Exists because a grid element's type key is the block/agent boundary where the
5166
+ * key is a *value* rather than a TypeScript type: `content.grid-element-link`
5167
+ * receives it as JSON from a model, so nothing checks it at compile time and the
5168
+ * icon lookup fails silently to a generic glyph. This is what a runtime
5169
+ * validator and a prop contract can name.
5170
+ */
5171
+ declare const gridEntityTypeKeys: readonly EntityType[];
5172
+ /**
5173
+ * Whether `value` is an entity key in the `grid` category.
5174
+ *
5175
+ * The guard a caller needs before handing an untrusted string — an agent-authored
5176
+ * block prop, a URL segment — to `ENTITY_CONFIG` for a glyph. `ENTITY_CONFIG` is
5177
+ * typed as a complete record, so an unknown key type-checks and resolves to
5178
+ * `undefined` at runtime; this is what turns that into an answer.
5179
+ */
5180
+ declare function isGridEntityTypeKey(value: unknown): value is EntityType;
5130
5181
  /**
5131
5182
  * The 22→12 mapping (MR-07 step 6): every grid registry key resolved to its
5132
5183
  * coarse `GridElementType`. The registry splits some element types by phase
@@ -5336,4 +5387,4 @@ declare const getContrastingTextColor: (backgroundColor: string) => string;
5336
5387
  */
5337
5388
  declare const mapValuesToCategoricalColors: (values: (string | number)[]) => Record<string | number, string>;
5338
5389
 
5339
- export { type YFormatType as $, ABSENT_GRID_FIELDS as A, type BadgeProps as B, CATEGORY_COLOR_TOKENS as C, type DeviceState as D, ENTITY_CONFIG as E, type SegmentedControlProps as F, GRID_ELEMENT_TYPE_BY_ENTITY as G, HEADLINE_METRIC_BOUNDS as H, type InteractiveMapProps as I, type SerializableFieldFormat as J, SideNav as K, Loader as L, type MapPoint as M, type SideNavItem as N, type SideNavProps as O, type PercentThresholdLevel as P, type StaticMapProps as Q, type TooltipData as R, type SegmentOption as S, TextLink as T, type TooltipSeries as U, TopNav as V, type TopNavProps as W, UNARY_FILTER_OPERATORS as X, UNARY_OPERATOR_LABELS as Y, type UnaryFilterOperator as Z, type YFormatSettings as _, type ActionItem as a, type GeoJsonLayerSpec as a$, activeDeviceStates as a0, archetypeFor as a1, clearColorCache as a2, createCategoryColorMap as a3, createXScale as a4, createYScale as a5, defaultMargin as a6, deviceStateLabels as a7, deviceStateMetricFormats as a8, entityHasDetailPage as a9, 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 CellComponentProps as aU, type CellAlignment as aV, type LinkBehavior as aW, type ComponentFormatter as aX, type DataTableProps as aY, type LayerSpec as aZ, type CustomPinsSpec as a_, entityHasStatList as aa, entityShowsNow as ab, getContrastingTextColor as ac, getDefaultChartColor as ad, getDefaultColors as ae, getDeviceStateLabel as af, getEntityConfig as ag, getEntityIcon as ah, getEntityLabel as ai, getEntityStatList as aj, getGridStateLabel as ak, getResolvedColor as al, getThemeCategoricalColors as am, getYFormatSettings as an, gridStateLabels as ao, isActiveState as ap, isLightColor as aq, isUnaryFilterOperator as ar, type LoadingState as as, type FilterState as at, type SortState as au, type SearchConfig as av, type FacetConfig as aw, type FacetCounts as ax, type Column as ay, type CellEmphasis as az, type ActionMenuProps as b, type TableDensity as b$, type RasterLayerSpec as b0, type VectorLayerSpec as b1, type ClusteredVectorLayerSpec as b2, type ColorSpec as b3, ActionMenu as b4, AppShell as b5, Avatar as b6, Badge as b7, type BaseFormat as b8, type CellComponent as b9, type LayerStyle as bA, type LayerTreeNode as bB, type LayerVisibilityPatch as bC, MAP_TYPES as bD, type MapType as bE, Meter as bF, type MobileBreakpoint as bG, type MobileConfig as bH, type MobileRenderer as bI, PercentBarCell as bJ, type PercentBarCellProps as bK, type PercentageFormat as bL, type PowerUnit as bM, type RenderType as bN, type ResistanceUnit as bO, SegmentedControl as bP, type SortConfig as bQ, type SortDirection as bR, StackNav as bS, type StackNavGroup as bT, type StackNavItem as bU, type StackNavLinkComponentProps as bV, type StackNavProps as bW, type StackNavRenderRow as bX, type StackNavRowRenderProps as bY, type StackNavTheme as bZ, StaticMap as b_, type CellContext as ba, ChartContext as bb, CodeEditor as bc, type ComponentFormatOptions as bd, type CurrentUnit as be, type CustomFormat as bf, DEFAULT_MAP_TYPE as bg, type DateFormatStyle as bh, type DistanceUnit as bi, ENTITY_CATEGORY_CONFIG as bj, type EntityCategory as bk, type EntityCategoryConfig as bl, type FacetType as bm, type FilterChip as bn, type FilterCondition as bo, type FilterGroup as bp, type FilterOperator as bq, GRID_STATE_COLORS as br, GRID_STAT_LIST_CAPACITOR_PER_PHASE_KVAR as bs, GRID_STAT_LIST_CAPACITOR_TOTAL_KVAR as bt, type GridStateColor as bu, InteractiveMap as bv, type InteractiveMapHandle as bw, type LayerCheckState as bx, type LayerFeature as by, type LayerSelection as bz, type AppShellProps as c, type TableLayout as c0, type TableWidth as c1, type TextTransform as c2, type TextTruncatePosition as c3, UNVERIFIED_VOLTAGE_UNIT_ROWS as c4, type UseInfiniteScrollOptions as c5, type UseInfiniteScrollReturn as c6, type VoltageUnit as c7, type ZoomStops as c8, addFilterCondition as c9, baselineFromPoint as ca, createEmptyFilter as cb, createFilter as cc, createFilters as cd, filterToChips as ce, formatComponentValue as cf, getEntityCategory as cg, getFilterFields as ch, isFilterEmpty as ci, mapValuesToCategoricalColors as cj, percentThresholdLevel as ck, removeFilterCondition as cl, useChartContext as cm, useComponentFormatter as cn, useInfiniteScroll as co, type AvatarProps as d, type BaseDataPoint as e, CATEGORY_NEUTRAL_COLOR as f, type ChartMargin as g, type CodeEditorProps as h, type CodeLanguage as i, type CodeTheme as j, type EntityArchetype as k, type EntityConfig as l, type EntityStateRule as m, type EntityType as n, GRID_STAT_LIST as o, type GridElementSourceType as p, type GridStatField as q, type GridStatFieldFormat as r, type GridState as s, Heading as t, type HeadlineMetric as u, Logo as v, type MeterProps as w, type MetricFormat as x, type MetricSource as y, type PercentThresholds as z };
5390
+ export { type YFormatType as $, ABSENT_GRID_FIELDS as A, type BadgeProps as B, CATEGORY_COLOR_TOKENS as C, type DeviceState as D, ENTITY_CONFIG as E, type SegmentedControlProps as F, GRID_ELEMENT_TYPE_BY_ENTITY as G, HEADLINE_METRIC_BOUNDS as H, type InteractiveMapProps as I, type SerializableFieldFormat as J, SideNav as K, Loader as L, type MapPoint as M, type SideNavItem as N, type SideNavProps as O, type PercentThresholdLevel as P, type StaticMapProps as Q, type TooltipData as R, type SegmentOption as S, TextLink as T, type TooltipSeries as U, TopNav as V, type TopNavProps as W, UNARY_FILTER_OPERATORS as X, UNARY_OPERATOR_LABELS as Y, type UnaryFilterOperator as Z, type YFormatSettings as _, type ActionItem as a, type LayerSpec as a$, activeDeviceStates as a0, archetypeFor as a1, clearColorCache as a2, createCategoryColorMap as a3, createXScale as a4, createYScale as a5, defaultMargin as a6, deviceStateLabels as a7, deviceStateMetricFormats as a8, entityHasDetailPage as a9, type Column as aA, type CellEmphasis as aB, type FieldValue as aC, type BooleanFormat as aD, type FormattedValue as aE, type FieldFormat as aF, type CurrentFormat as aG, type DateFormat as aH, type DistanceFormat as aI, type EnergyUnit as aJ, type EnergyFormat as aK, type CurrencyFormat as aL, type NumberFormat as aM, type PhoneFormat as aN, type PowerFormat as aO, type FormatterFunction as aP, type ResistanceFormat as aQ, type TemperatureFormat as aR, type TemperatureUnitString as aS, type TemperatureUnit as aT, type TextFormat as aU, type VoltageFormat as aV, type CellComponentProps as aW, type CellAlignment as aX, type LinkBehavior as aY, type ComponentFormatter as aZ, type DataTableProps as a_, entityHasStatList as aa, entityShowsNow as ab, getContrastingTextColor as ac, getDefaultChartColor as ad, getDefaultColors as ae, getDeviceStateLabel as af, getEntityConfig as ag, getEntityIcon as ah, getEntityLabel as ai, getEntityStatList as aj, getGridStateLabel as ak, getResolvedColor as al, getThemeCategoricalColors as am, getYFormatSettings as an, gridEntityTypeKeys as ao, gridStateLabels as ap, isActiveState as aq, isGridEntityTypeKey as ar, isLightColor as as, isUnaryFilterOperator as at, type LoadingState as au, type FilterState as av, type SortState as aw, type SearchConfig as ax, type FacetConfig as ay, type FacetCounts as az, type ActionMenuProps as b, type StackNavTheme as b$, type CustomPinsSpec as b0, type GeoJsonLayerSpec as b1, type RasterLayerSpec as b2, type VectorLayerSpec as b3, type ClusteredVectorLayerSpec as b4, type ColorSpec as b5, ActionMenu as b6, AppShell as b7, Avatar as b8, Badge as b9, type LayerFeature as bA, type LayerSelection as bB, type LayerStyle as bC, type LayerTreeNode as bD, type LayerVisibilityPatch as bE, MAP_TYPES as bF, type MapType as bG, Meter as bH, type MobileBreakpoint as bI, type MobileConfig as bJ, type MobileRenderer as bK, PercentBarCell as bL, type PercentBarCellProps as bM, type PercentageFormat as bN, type PowerUnit as bO, type RenderType as bP, type ResistanceUnit as bQ, SegmentedControl as bR, type SortConfig as bS, type SortDirection as bT, StackNav as bU, type StackNavGroup as bV, type StackNavItem as bW, type StackNavLinkComponentProps as bX, type StackNavProps as bY, type StackNavRenderRow as bZ, type StackNavRowRenderProps as b_, type BaseFormat as ba, type CellComponent as bb, type CellContext as bc, ChartContext as bd, CodeEditor as be, type ComponentFormatOptions as bf, type CurrentUnit as bg, type CustomFormat as bh, DEFAULT_MAP_TYPE as bi, type DateFormatStyle as bj, type DistanceUnit as bk, ENTITY_CATEGORY_CONFIG as bl, type EntityCategory as bm, type EntityCategoryConfig as bn, type FacetType as bo, type FilterChip as bp, type FilterCondition as bq, type FilterGroup as br, type FilterOperator as bs, GRID_STATE_COLORS as bt, GRID_STAT_LIST_CAPACITOR_PER_PHASE_KVAR as bu, GRID_STAT_LIST_CAPACITOR_TOTAL_KVAR as bv, type GridStateColor as bw, InteractiveMap as bx, type InteractiveMapHandle as by, type LayerCheckState as bz, type AppShellProps as c, StaticMap as c0, type TableDensity as c1, type TableLayout as c2, type TableWidth as c3, type TextTransform as c4, type TextTruncatePosition as c5, UNVERIFIED_VOLTAGE_UNIT_ROWS as c6, type UseInfiniteScrollOptions as c7, type UseInfiniteScrollReturn as c8, type VoltageUnit as c9, type ZoomStops as ca, addFilterCondition as cb, baselineFromPoint as cc, createEmptyFilter as cd, createFilter as ce, createFilters as cf, filterToChips as cg, formatComponentValue as ch, getEntityCategory as ci, getFilterFields as cj, isFilterEmpty as ck, mapValuesToCategoricalColors as cl, percentThresholdLevel as cm, removeFilterCondition as cn, useChartContext as co, useComponentFormatter as cp, useInfiniteScroll as cq, type AvatarProps as d, type BaseDataPoint as e, CATEGORY_NEUTRAL_COLOR as f, type ChartMargin as g, type CodeEditorProps as h, type CodeLanguage as i, type CodeTheme as j, type EntityArchetype as k, type EntityConfig as l, type EntityStateRule as m, type EntityType as n, GRID_STAT_LIST as o, type GridElementSourceType as p, type GridStatField as q, type GridStatFieldFormat as r, type GridState as s, Heading as t, type HeadlineMetric as u, Logo as v, type MeterProps as w, type MetricFormat as x, type MetricSource as y, type PercentThresholds as z };
@@ -256,7 +256,9 @@ type StackNavItem = {
256
256
  *
257
257
  * If both `href` and `children` are present, clicking the row both navigates
258
258
  * to `href` (a section overview) and pushes its sub-pane onto the stack.
259
- * This mirrors the Vercel/Linear/Edges dashboard pattern.
259
+ * This mirrors the Vercel/Linear/Edges dashboard pattern. Set
260
+ * `pushOnSelect: false` to split the two: the row becomes a plain link and a
261
+ * separate chevron button drills into the sub-pane.
260
262
  */
261
263
  href?: string;
262
264
  /** Optional leading-edge icon. Alias-friendly for item models shared with SideNav. */
@@ -272,10 +274,12 @@ type StackNavItem = {
272
274
  /** Nested children. Triggers the drill-in arrow and pushes a new pane. */
273
275
  children?: StackNavItem[];
274
276
  /**
275
- * When `false` and the row has `children`, selecting the row only navigates
276
- * to `href` (if present) — it does not push a sub-pane. Useful for
277
- * "Overview" leaves that live in the same array as their siblings. Defaults
278
- * to `true`.
277
+ * When `false` and the row has both `children` and an `href`, selecting the
278
+ * row only navigates — it does not push a sub-pane; the row's chevron becomes
279
+ * a separate drill-in button, and a `value` matching the row keeps its own
280
+ * pane open rather than auto-opening the children. Without an `href` the row
281
+ * still drills in on click (there is nothing else it could do). Defaults to
282
+ * `true`.
279
283
  */
280
284
  pushOnSelect?: boolean;
281
285
  /** Aria-label override for screen readers. */
@@ -296,13 +300,13 @@ type StackNavRowRenderProps = {
296
300
  * Whether the item has children. Use it to decide whether to draw a drill-in
297
301
  * affordance.
298
302
  *
299
- * Note this reports child presence, not a guarantee about `select`: the click
300
- * path pushes a pane whenever children exist and does not consult
301
- * `pushOnSelect`, which today only affects deep-link resolution. That
302
- * discrepancy predates this prop and is left alone here rather than changed
303
- * underneath existing consumers.
303
+ * Note this reports child presence, not a guarantee about `select`: `select`
304
+ * pushes a pane when children exist unless the item is an `href` row with
305
+ * `pushOnSelect: false`, whose pane is pushed by `drillIn` instead.
304
306
  */
305
307
  hasChildren: boolean;
308
+ /** Push the item's sub-pane without navigating — the chevron affordance for split rows. */
309
+ drillIn: () => void;
306
310
  /**
307
311
  * Run StackNav's selection: report through `onSelect` and push the sub-pane
308
312
  * when the item has children.
@@ -986,6 +990,12 @@ interface Column<T> {
986
990
  showArrow?: boolean;
987
991
  trigger?: "hover" | "click";
988
992
  };
993
+ /**
994
+ * Tooltip text shown to the right of the column header label via an info icon.
995
+ * When set, a small help icon appears beside the label; hovering it reveals the
996
+ * tooltip. Useful for explaining column semantics without cluttering the header.
997
+ */
998
+ headerTooltip?: string;
989
999
  /** Label to use for this column in CSV export headers. Falls back to `label` if not provided. */
990
1000
  exportLabel?: string;
991
1001
  /**
@@ -1342,6 +1352,14 @@ interface TooltipSeries {
1342
1352
  interface SeriesMetadata {
1343
1353
  label: string;
1344
1354
  color: string;
1355
+ /**
1356
+ * Set only by a banded `AreaSeries` that opted into the min-max range tooltip.
1357
+ * `ChartContainer` has always put these on the metadata it provides; they were
1358
+ * simply not declared, so anything reading series off the context built tooltip
1359
+ * rows that silently dropped the lower bound.
1360
+ */
1361
+ baseline?: TooltipBaseline;
1362
+ tooltipRange?: boolean;
1345
1363
  }
1346
1364
  interface ChartContextType {
1347
1365
  xScale: ScaleTime<number, number>;
@@ -1376,6 +1394,13 @@ interface ChartContextType {
1376
1394
  declare const ChartContext: React$1.Context<ChartContextType | null>;
1377
1395
  declare const useChartContext: () => ChartContextType;
1378
1396
 
1397
+ /**
1398
+ * A banded area series' lower bound: a constant, or resolved per point.
1399
+ *
1400
+ * Structurally identical to `AreaSeriesBaseline`, restated here so this module
1401
+ * does not have to import from a component.
1402
+ */
1403
+ type TooltipBaseline = number | ((point: BaseDataPoint, index: number) => number);
1379
1404
  interface BaseDataPoint {
1380
1405
  xValue: Date;
1381
1406
  /**
@@ -5127,6 +5152,32 @@ declare const ENTITY_CONFIG: {
5127
5152
  };
5128
5153
  };
5129
5154
  type EntityType = keyof typeof ENTITY_CONFIG;
5155
+ /**
5156
+ * Every entity key in the `grid` category, as runtime data.
5157
+ *
5158
+ * Derived from `ENTITY_CONFIG` rather than written out, so a grid entity added
5159
+ * to the registry joins this set with no second edit — the failure mode a
5160
+ * hand-maintained list has, and the one that already cost us once: two
5161
+ * `GridElementType` values added to a *generated* union compiled cleanly, fell
5162
+ * through to a `default:`, and gave 6,571 Device Leaders the wrong icon and
5163
+ * label (see `gridEntityTypeFor` in the dashboard).
5164
+ *
5165
+ * Exists because a grid element's type key is the block/agent boundary where the
5166
+ * key is a *value* rather than a TypeScript type: `content.grid-element-link`
5167
+ * receives it as JSON from a model, so nothing checks it at compile time and the
5168
+ * icon lookup fails silently to a generic glyph. This is what a runtime
5169
+ * validator and a prop contract can name.
5170
+ */
5171
+ declare const gridEntityTypeKeys: readonly EntityType[];
5172
+ /**
5173
+ * Whether `value` is an entity key in the `grid` category.
5174
+ *
5175
+ * The guard a caller needs before handing an untrusted string — an agent-authored
5176
+ * block prop, a URL segment — to `ENTITY_CONFIG` for a glyph. `ENTITY_CONFIG` is
5177
+ * typed as a complete record, so an unknown key type-checks and resolves to
5178
+ * `undefined` at runtime; this is what turns that into an answer.
5179
+ */
5180
+ declare function isGridEntityTypeKey(value: unknown): value is EntityType;
5130
5181
  /**
5131
5182
  * The 22→12 mapping (MR-07 step 6): every grid registry key resolved to its
5132
5183
  * coarse `GridElementType`. The registry splits some element types by phase
@@ -5336,4 +5387,4 @@ declare const getContrastingTextColor: (backgroundColor: string) => string;
5336
5387
  */
5337
5388
  declare const mapValuesToCategoricalColors: (values: (string | number)[]) => Record<string | number, string>;
5338
5389
 
5339
- export { type YFormatType as $, ABSENT_GRID_FIELDS as A, type BadgeProps as B, CATEGORY_COLOR_TOKENS as C, type DeviceState as D, ENTITY_CONFIG as E, type SegmentedControlProps as F, GRID_ELEMENT_TYPE_BY_ENTITY as G, HEADLINE_METRIC_BOUNDS as H, type InteractiveMapProps as I, type SerializableFieldFormat as J, SideNav as K, Loader as L, type MapPoint as M, type SideNavItem as N, type SideNavProps as O, type PercentThresholdLevel as P, type StaticMapProps as Q, type TooltipData as R, type SegmentOption as S, TextLink as T, type TooltipSeries as U, TopNav as V, type TopNavProps as W, UNARY_FILTER_OPERATORS as X, UNARY_OPERATOR_LABELS as Y, type UnaryFilterOperator as Z, type YFormatSettings as _, type ActionItem as a, type GeoJsonLayerSpec as a$, activeDeviceStates as a0, archetypeFor as a1, clearColorCache as a2, createCategoryColorMap as a3, createXScale as a4, createYScale as a5, defaultMargin as a6, deviceStateLabels as a7, deviceStateMetricFormats as a8, entityHasDetailPage as a9, 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 CellComponentProps as aU, type CellAlignment as aV, type LinkBehavior as aW, type ComponentFormatter as aX, type DataTableProps as aY, type LayerSpec as aZ, type CustomPinsSpec as a_, entityHasStatList as aa, entityShowsNow as ab, getContrastingTextColor as ac, getDefaultChartColor as ad, getDefaultColors as ae, getDeviceStateLabel as af, getEntityConfig as ag, getEntityIcon as ah, getEntityLabel as ai, getEntityStatList as aj, getGridStateLabel as ak, getResolvedColor as al, getThemeCategoricalColors as am, getYFormatSettings as an, gridStateLabels as ao, isActiveState as ap, isLightColor as aq, isUnaryFilterOperator as ar, type LoadingState as as, type FilterState as at, type SortState as au, type SearchConfig as av, type FacetConfig as aw, type FacetCounts as ax, type Column as ay, type CellEmphasis as az, type ActionMenuProps as b, type TableDensity as b$, type RasterLayerSpec as b0, type VectorLayerSpec as b1, type ClusteredVectorLayerSpec as b2, type ColorSpec as b3, ActionMenu as b4, AppShell as b5, Avatar as b6, Badge as b7, type BaseFormat as b8, type CellComponent as b9, type LayerStyle as bA, type LayerTreeNode as bB, type LayerVisibilityPatch as bC, MAP_TYPES as bD, type MapType as bE, Meter as bF, type MobileBreakpoint as bG, type MobileConfig as bH, type MobileRenderer as bI, PercentBarCell as bJ, type PercentBarCellProps as bK, type PercentageFormat as bL, type PowerUnit as bM, type RenderType as bN, type ResistanceUnit as bO, SegmentedControl as bP, type SortConfig as bQ, type SortDirection as bR, StackNav as bS, type StackNavGroup as bT, type StackNavItem as bU, type StackNavLinkComponentProps as bV, type StackNavProps as bW, type StackNavRenderRow as bX, type StackNavRowRenderProps as bY, type StackNavTheme as bZ, StaticMap as b_, type CellContext as ba, ChartContext as bb, CodeEditor as bc, type ComponentFormatOptions as bd, type CurrentUnit as be, type CustomFormat as bf, DEFAULT_MAP_TYPE as bg, type DateFormatStyle as bh, type DistanceUnit as bi, ENTITY_CATEGORY_CONFIG as bj, type EntityCategory as bk, type EntityCategoryConfig as bl, type FacetType as bm, type FilterChip as bn, type FilterCondition as bo, type FilterGroup as bp, type FilterOperator as bq, GRID_STATE_COLORS as br, GRID_STAT_LIST_CAPACITOR_PER_PHASE_KVAR as bs, GRID_STAT_LIST_CAPACITOR_TOTAL_KVAR as bt, type GridStateColor as bu, InteractiveMap as bv, type InteractiveMapHandle as bw, type LayerCheckState as bx, type LayerFeature as by, type LayerSelection as bz, type AppShellProps as c, type TableLayout as c0, type TableWidth as c1, type TextTransform as c2, type TextTruncatePosition as c3, UNVERIFIED_VOLTAGE_UNIT_ROWS as c4, type UseInfiniteScrollOptions as c5, type UseInfiniteScrollReturn as c6, type VoltageUnit as c7, type ZoomStops as c8, addFilterCondition as c9, baselineFromPoint as ca, createEmptyFilter as cb, createFilter as cc, createFilters as cd, filterToChips as ce, formatComponentValue as cf, getEntityCategory as cg, getFilterFields as ch, isFilterEmpty as ci, mapValuesToCategoricalColors as cj, percentThresholdLevel as ck, removeFilterCondition as cl, useChartContext as cm, useComponentFormatter as cn, useInfiniteScroll as co, type AvatarProps as d, type BaseDataPoint as e, CATEGORY_NEUTRAL_COLOR as f, type ChartMargin as g, type CodeEditorProps as h, type CodeLanguage as i, type CodeTheme as j, type EntityArchetype as k, type EntityConfig as l, type EntityStateRule as m, type EntityType as n, GRID_STAT_LIST as o, type GridElementSourceType as p, type GridStatField as q, type GridStatFieldFormat as r, type GridState as s, Heading as t, type HeadlineMetric as u, Logo as v, type MeterProps as w, type MetricFormat as x, type MetricSource as y, type PercentThresholds as z };
5390
+ export { type YFormatType as $, ABSENT_GRID_FIELDS as A, type BadgeProps as B, CATEGORY_COLOR_TOKENS as C, type DeviceState as D, ENTITY_CONFIG as E, type SegmentedControlProps as F, GRID_ELEMENT_TYPE_BY_ENTITY as G, HEADLINE_METRIC_BOUNDS as H, type InteractiveMapProps as I, type SerializableFieldFormat as J, SideNav as K, Loader as L, type MapPoint as M, type SideNavItem as N, type SideNavProps as O, type PercentThresholdLevel as P, type StaticMapProps as Q, type TooltipData as R, type SegmentOption as S, TextLink as T, type TooltipSeries as U, TopNav as V, type TopNavProps as W, UNARY_FILTER_OPERATORS as X, UNARY_OPERATOR_LABELS as Y, type UnaryFilterOperator as Z, type YFormatSettings as _, type ActionItem as a, type LayerSpec as a$, activeDeviceStates as a0, archetypeFor as a1, clearColorCache as a2, createCategoryColorMap as a3, createXScale as a4, createYScale as a5, defaultMargin as a6, deviceStateLabels as a7, deviceStateMetricFormats as a8, entityHasDetailPage as a9, type Column as aA, type CellEmphasis as aB, type FieldValue as aC, type BooleanFormat as aD, type FormattedValue as aE, type FieldFormat as aF, type CurrentFormat as aG, type DateFormat as aH, type DistanceFormat as aI, type EnergyUnit as aJ, type EnergyFormat as aK, type CurrencyFormat as aL, type NumberFormat as aM, type PhoneFormat as aN, type PowerFormat as aO, type FormatterFunction as aP, type ResistanceFormat as aQ, type TemperatureFormat as aR, type TemperatureUnitString as aS, type TemperatureUnit as aT, type TextFormat as aU, type VoltageFormat as aV, type CellComponentProps as aW, type CellAlignment as aX, type LinkBehavior as aY, type ComponentFormatter as aZ, type DataTableProps as a_, entityHasStatList as aa, entityShowsNow as ab, getContrastingTextColor as ac, getDefaultChartColor as ad, getDefaultColors as ae, getDeviceStateLabel as af, getEntityConfig as ag, getEntityIcon as ah, getEntityLabel as ai, getEntityStatList as aj, getGridStateLabel as ak, getResolvedColor as al, getThemeCategoricalColors as am, getYFormatSettings as an, gridEntityTypeKeys as ao, gridStateLabels as ap, isActiveState as aq, isGridEntityTypeKey as ar, isLightColor as as, isUnaryFilterOperator as at, type LoadingState as au, type FilterState as av, type SortState as aw, type SearchConfig as ax, type FacetConfig as ay, type FacetCounts as az, type ActionMenuProps as b, type StackNavTheme as b$, type CustomPinsSpec as b0, type GeoJsonLayerSpec as b1, type RasterLayerSpec as b2, type VectorLayerSpec as b3, type ClusteredVectorLayerSpec as b4, type ColorSpec as b5, ActionMenu as b6, AppShell as b7, Avatar as b8, Badge as b9, type LayerFeature as bA, type LayerSelection as bB, type LayerStyle as bC, type LayerTreeNode as bD, type LayerVisibilityPatch as bE, MAP_TYPES as bF, type MapType as bG, Meter as bH, type MobileBreakpoint as bI, type MobileConfig as bJ, type MobileRenderer as bK, PercentBarCell as bL, type PercentBarCellProps as bM, type PercentageFormat as bN, type PowerUnit as bO, type RenderType as bP, type ResistanceUnit as bQ, SegmentedControl as bR, type SortConfig as bS, type SortDirection as bT, StackNav as bU, type StackNavGroup as bV, type StackNavItem as bW, type StackNavLinkComponentProps as bX, type StackNavProps as bY, type StackNavRenderRow as bZ, type StackNavRowRenderProps as b_, type BaseFormat as ba, type CellComponent as bb, type CellContext as bc, ChartContext as bd, CodeEditor as be, type ComponentFormatOptions as bf, type CurrentUnit as bg, type CustomFormat as bh, DEFAULT_MAP_TYPE as bi, type DateFormatStyle as bj, type DistanceUnit as bk, ENTITY_CATEGORY_CONFIG as bl, type EntityCategory as bm, type EntityCategoryConfig as bn, type FacetType as bo, type FilterChip as bp, type FilterCondition as bq, type FilterGroup as br, type FilterOperator as bs, GRID_STATE_COLORS as bt, GRID_STAT_LIST_CAPACITOR_PER_PHASE_KVAR as bu, GRID_STAT_LIST_CAPACITOR_TOTAL_KVAR as bv, type GridStateColor as bw, InteractiveMap as bx, type InteractiveMapHandle as by, type LayerCheckState as bz, type AppShellProps as c, StaticMap as c0, type TableDensity as c1, type TableLayout as c2, type TableWidth as c3, type TextTransform as c4, type TextTruncatePosition as c5, UNVERIFIED_VOLTAGE_UNIT_ROWS as c6, type UseInfiniteScrollOptions as c7, type UseInfiniteScrollReturn as c8, type VoltageUnit as c9, type ZoomStops as ca, addFilterCondition as cb, baselineFromPoint as cc, createEmptyFilter as cd, createFilter as ce, createFilters as cf, filterToChips as cg, formatComponentValue as ch, getEntityCategory as ci, getFilterFields as cj, isFilterEmpty as ck, mapValuesToCategoricalColors as cl, percentThresholdLevel as cm, removeFilterCondition as cn, useChartContext as co, useComponentFormatter as cp, useInfiniteScroll as cq, type AvatarProps as d, type BaseDataPoint as e, CATEGORY_NEUTRAL_COLOR as f, type ChartMargin as g, type CodeEditorProps as h, type CodeLanguage as i, type CodeTheme as j, type EntityArchetype as k, type EntityConfig as l, type EntityStateRule as m, type EntityType as n, GRID_STAT_LIST as o, type GridElementSourceType as p, type GridStatField as q, type GridStatFieldFormat as r, type GridState as s, Heading as t, type HeadlineMetric as u, Logo as v, type MeterProps as w, type MetricFormat as x, type MetricSource as y, type PercentThresholds as z };