semiotic 3.8.9 → 3.9.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.
Files changed (500) hide show
  1. package/README.md +83 -67
  2. package/agent-skill/semiotic-charts/SKILL.md +11 -2
  3. package/ai/behaviorContracts.cjs +33 -3
  4. package/ai/cli.js +53 -2
  5. package/ai/componentMetadata.cjs +15 -0
  6. package/ai/dist/mcp-server.js +1530 -611
  7. package/ai/examples.md +48 -42
  8. package/{CLAUDE.md → ai/reference.md} +43 -22
  9. package/ai/schema.json +10603 -986
  10. package/ai/surface-manifest.json +643 -2
  11. package/ai/system-prompt.md +83 -130
  12. package/dist/c-3BLJEQNG.min.js +1 -0
  13. package/dist/c-3KZD6AXJ.min.js +1 -0
  14. package/dist/c-4TWEX5HG.min.js +1 -0
  15. package/dist/c-52TEGIUJ.min.js +1 -0
  16. package/dist/c-5YCIX3VZ.min.js +1 -0
  17. package/dist/c-6FEKTA3U.min.js +1 -0
  18. package/dist/c-6O5EVOPH.min.js +1 -0
  19. package/dist/c-74HEEZGK.min.js +1 -0
  20. package/dist/c-AKAF6JAD.min.js +1 -0
  21. package/dist/c-BBKITSXB.min.js +1 -0
  22. package/dist/c-BWNB6USU.min.js +1 -0
  23. package/dist/c-C25ENHIK.min.js +1 -0
  24. package/dist/c-CDR5AO3R.min.js +1 -0
  25. package/dist/c-COHXCW3Q.min.js +1 -0
  26. package/dist/{chunk-scatterplotMatrixBrushOverlay-SDIZSN66.module.min.js → c-DADXPJXV.min.js} +0 -1
  27. package/dist/c-E3JFRRMI.min.js +1 -0
  28. package/dist/c-EBFPQHHO.min.js +1 -0
  29. package/dist/c-G36WS6LN.min.js +1 -0
  30. package/dist/c-GIKRQI4X.min.js +1 -0
  31. package/dist/c-GPYOFETM.min.js +1 -0
  32. package/dist/c-IDUHYYSI.min.js +1 -0
  33. package/dist/{chunk-chunk-FQPKOAIH.module.min.js → c-IUHFPMHD.min.js} +0 -1
  34. package/dist/c-J5G56TUH.min.js +1 -0
  35. package/dist/c-JAZ73J32.min.js +1 -0
  36. package/dist/c-KG3NXHAL.min.js +1 -0
  37. package/dist/c-KII3PLZE.min.js +1 -0
  38. package/dist/c-LIXGXMNS.min.js +1 -0
  39. package/dist/c-LVEY6D6B.min.js +1 -0
  40. package/dist/c-M4Y3BHFR.min.js +1 -0
  41. package/dist/c-MAIICR2Z.min.js +1 -0
  42. package/dist/c-MG5DM6VE.min.js +1 -0
  43. package/dist/{chunk-minimapBrushOverlay-JU57U7NM.module.min.js → c-MNF2S4AA.min.js} +0 -1
  44. package/dist/c-MT3WBK7M.min.js +1 -0
  45. package/dist/c-NY3JWV2K.min.js +1 -0
  46. package/dist/c-O6U6K4CW.min.js +1 -0
  47. package/dist/c-OCI56QF2.min.js +1 -0
  48. package/dist/c-OQ7M4AGV.min.js +1 -0
  49. package/dist/c-OXYMVK7Q.min.js +1 -0
  50. package/dist/c-PPWDL5ZI.min.js +1 -0
  51. package/dist/c-QHF5YON3.min.js +1 -0
  52. package/dist/c-RR3GO5SW.min.js +1 -0
  53. package/dist/{chunk-chunk-J5QD4RAM.module.min.js → c-RSVIHIQ4.min.js} +0 -1
  54. package/dist/{chunk-chunk-EMO5NUGE.module.min.js → c-S2BXNNJN.min.js} +0 -1
  55. package/dist/{chunk-chunk-YCQYG6J5.module.min.js → c-SLGMUBUL.min.js} +0 -1
  56. package/dist/c-SUILCHWU.min.js +1 -0
  57. package/dist/c-TZW3JGJ5.min.js +1 -0
  58. package/dist/c-US5ZFT6E.min.js +1 -0
  59. package/dist/{chunk-chunk-RZH7VZYS.module.min.js → c-USFMFKIH.min.js} +0 -1
  60. package/dist/c-UUKVD4WB.min.js +1 -0
  61. package/dist/{chunk-chunk-SV4XAZ3Q.module.min.js → c-VGW3VG3I.min.js} +0 -1
  62. package/dist/c-W3CE4A4S.min.js +1 -0
  63. package/dist/{chunk-chunk-2NVFEB7P.module.min.js → c-WJCD5EUY.min.js} +0 -1
  64. package/dist/{chunk-chunk-2JGJ5GUG.module.min.js → c-X5UBGU2V.min.js} +0 -1
  65. package/dist/c-YDAY2WFR.min.js +1 -0
  66. package/dist/c-ZOWWU34K.min.js +1 -0
  67. package/dist/components/AccessibleNavTree.d.ts +1 -1
  68. package/dist/components/CategoryColors.d.ts +1 -1
  69. package/dist/components/GradientLegend.d.ts +14 -0
  70. package/dist/components/Legend.d.ts +2 -7
  71. package/dist/components/LinkedCharts.d.ts +1 -1
  72. package/dist/components/MobileAnnotationCalloutList.d.ts +1 -1
  73. package/dist/components/ObservationReadout.d.ts +45 -0
  74. package/dist/components/ThemeProvider.d.ts +4 -4
  75. package/dist/components/Tooltip/FlippingTooltip.d.ts +5 -7
  76. package/dist/components/Tooltip/Tooltip.d.ts +30 -5
  77. package/dist/components/Tooltip/tooltipChrome.d.ts +43 -0
  78. package/dist/components/ai/chartCapabilityTypes.d.ts +86 -2
  79. package/dist/components/ai/chartClinic.d.ts +2 -0
  80. package/dist/components/ai/deriveProfileFields.d.ts +40 -0
  81. package/dist/components/ai/evaluateChart.d.ts +85 -0
  82. package/dist/components/ai/fieldPolicy.d.ts +7 -0
  83. package/dist/components/ai/fieldRoles.d.ts +24 -0
  84. package/dist/components/ai/generativeChart.d.ts +18 -2
  85. package/dist/components/ai/inferIntent.d.ts +26 -2
  86. package/dist/components/ai/intents.d.ts +35 -0
  87. package/dist/components/ai/navigationTree.d.ts +2 -2
  88. package/dist/components/ai/observedSceneAudit.d.ts +2 -1
  89. package/dist/components/ai/profileData.d.ts +11 -0
  90. package/dist/components/ai/repairChartConfig.d.ts +2 -3
  91. package/dist/components/ai/semanticEvidence.d.ts +4 -0
  92. package/dist/components/ai/semanticViability.d.ts +11 -0
  93. package/dist/components/ai/semanticViabilityRegistry.d.ts +5 -0
  94. package/dist/components/ai/streamingTypes.d.ts +4 -0
  95. package/dist/components/ai/suggestCharts.d.ts +5 -6
  96. package/dist/components/ai/suggestDashboard.d.ts +2 -3
  97. package/dist/components/ai/suggestStreamCharts.d.ts +1 -1
  98. package/dist/components/ai/suggestStretchCharts.d.ts +2 -3
  99. package/dist/components/ai/suggestionPropContracts.d.ts +20 -0
  100. package/dist/components/ai/variantDiscovery.d.ts +3 -1
  101. package/dist/components/charts/custom/NetworkCustomChart.d.ts +3 -0
  102. package/dist/components/charts/custom/OrdinalCustomChart.d.ts +3 -0
  103. package/dist/components/charts/custom/XYCustomChart.d.ts +1 -1
  104. package/dist/components/charts/geo/ChoroplethMap.d.ts +3 -1
  105. package/dist/components/charts/geo/DistanceCartogram.d.ts +2 -7
  106. package/dist/components/charts/geo/cartogramOverlay.d.ts +28 -0
  107. package/dist/components/charts/index.d.ts +4 -3
  108. package/dist/components/charts/network/ProcessSankey.d.ts +2 -136
  109. package/dist/components/charts/network/ProcessSankeyProps.d.ts +139 -0
  110. package/dist/components/charts/network/Treemap.d.ts +2 -1
  111. package/dist/components/charts/network/processSankey/boundaryHubOrdering.d.ts +23 -0
  112. package/dist/components/charts/network/processSankey/layoutGeometry.d.ts +2 -0
  113. package/dist/components/charts/network/processSankey/ordering.d.ts +3 -41
  114. package/dist/components/charts/network/processSankey/orderingTypes.d.ts +32 -0
  115. package/dist/components/charts/network/processSankey/packing.d.ts +1 -1
  116. package/dist/components/charts/network/processSankey/packingCache.d.ts +1 -1
  117. package/dist/components/charts/network/processSankey/packingOptimization.d.ts +72 -0
  118. package/dist/components/charts/ordinal/BarChart.d.ts +4 -3
  119. package/dist/components/charts/ordinal/FunnelChart.d.ts +2 -0
  120. package/dist/components/charts/ordinal/GroupedBarChart.d.ts +3 -2
  121. package/dist/components/charts/ordinal/StackedBarChart.d.ts +4 -3
  122. package/dist/components/charts/ordinal/SwimlaneChart.d.ts +2 -2
  123. package/dist/components/charts/physics/GaltonBoardChart.d.ts +2 -9
  124. package/dist/components/charts/physics/GauntletChart.d.ts +10 -41
  125. package/dist/components/charts/physics/ProcessFlowChart.d.ts +1 -1
  126. package/dist/components/charts/physics/chainReactionAccessibleTable.d.ts +9 -0
  127. package/dist/components/charts/physics/chainReactionRuntime.d.ts +2 -1
  128. package/dist/components/charts/physics/chainReactionTypes.d.ts +5 -1
  129. package/dist/components/charts/physics/crucibleBodyRenderers.d.ts +2 -2
  130. package/dist/components/charts/physics/crucibleClone.d.ts +6 -0
  131. package/dist/components/charts/physics/crucibleEffects.d.ts +1 -2
  132. package/dist/components/charts/physics/crucibleRecord.d.ts +7 -0
  133. package/dist/components/charts/physics/gauntletChrome.d.ts +4 -4
  134. package/dist/components/charts/physics/gauntletPhysics.d.ts +1 -0
  135. package/dist/components/charts/physics/gauntletPublic.d.ts +4 -0
  136. package/dist/components/charts/physics/packetFlowOverlay.d.ts +7 -0
  137. package/dist/components/charts/physics/physicsChartLayout.d.ts +8 -0
  138. package/dist/components/charts/physics/physicsChartShared.d.ts +3 -1
  139. package/dist/components/charts/physics/physicsChartUtils.d.ts +1 -1
  140. package/dist/components/charts/physics/physicsHocUtils.d.ts +25 -12
  141. package/dist/components/charts/physics/physicsProjectionOverlays.d.ts +24 -0
  142. package/dist/components/charts/physics/processFlowOverlays.d.ts +9 -0
  143. package/dist/components/charts/realtime/RealtimeHeatmap.d.ts +15 -12
  144. package/dist/components/charts/realtime/RealtimeHistogram.d.ts +10 -7
  145. package/dist/components/charts/realtime/RealtimeLineChart.d.ts +35 -14
  146. package/dist/components/charts/realtime/RealtimeSwarmChart.d.ts +21 -14
  147. package/dist/components/charts/realtime/RealtimeWaterfallChart.d.ts +20 -13
  148. package/dist/components/charts/realtime/aggregate.d.ts +4 -1
  149. package/dist/components/charts/realtime/eventTime.d.ts +4 -0
  150. package/dist/components/charts/realtime/realtimeChartRuntime.d.ts +27 -0
  151. package/dist/components/charts/realtime/realtimeChartTypes.d.ts +30 -0
  152. package/dist/components/charts/realtime/useRealtimeCategoryColors.d.ts +30 -0
  153. package/dist/components/charts/shared/FrameTextAnnotationSVG.d.ts +10 -0
  154. package/dist/components/charts/shared/annotationActivation.d.ts +3 -7
  155. package/dist/components/charts/shared/annotationBandFill.d.ts +6 -0
  156. package/dist/components/charts/shared/annotationDispatch.d.ts +31 -0
  157. package/dist/components/charts/shared/annotationIdentity.d.ts +8 -0
  158. package/dist/components/charts/shared/annotationRules.d.ts +1 -15
  159. package/dist/components/charts/shared/boundedCategoryRegistry.d.ts +8 -0
  160. package/dist/components/charts/shared/chainReactionChartSpec.d.ts +3 -0
  161. package/dist/components/charts/shared/chartMode.d.ts +3 -2
  162. package/dist/components/charts/shared/chartSpecCore.d.ts +1 -0
  163. package/dist/components/charts/shared/frameTextAnnotation.d.ts +63 -0
  164. package/dist/components/charts/shared/gradient.d.ts +16 -0
  165. package/dist/components/charts/shared/hatchFill.d.ts +15 -0
  166. package/dist/components/charts/shared/hooks.d.ts +4 -4
  167. package/dist/components/charts/shared/legendUtils.d.ts +1 -0
  168. package/dist/components/charts/shared/streamPropsHelpers.d.ts +2 -1
  169. package/dist/components/charts/shared/styleRules.d.ts +9 -2
  170. package/dist/components/charts/shared/styleRulesWireSchema.d.ts +353 -0
  171. package/dist/components/charts/shared/types.d.ts +18 -9
  172. package/dist/components/charts/shared/useChartLegend.d.ts +43 -9
  173. package/dist/components/charts/shared/useChartSetup.d.ts +3 -1
  174. package/dist/components/charts/shared/useCustomChartSetup.d.ts +5 -2
  175. package/dist/components/charts/shared/useNetworkChartSetup.d.ts +5 -1
  176. package/dist/components/charts/shared/useOrdinalBrush.d.ts +3 -3
  177. package/dist/components/charts/shared/useStreamingLegend.d.ts +6 -1
  178. package/dist/components/charts/value/types.d.ts +1 -1
  179. package/dist/components/charts/xy/BubbleChart.d.ts +1 -1
  180. package/dist/components/charts/xy/BumpChart.capability.d.ts +14 -1
  181. package/dist/components/charts/xy/BumpChart.d.ts +13 -73
  182. package/dist/components/charts/xy/BumpChart.semanticViability.d.ts +5 -0
  183. package/dist/components/charts/xy/CandlestickChart.d.ts +2 -2
  184. package/dist/components/charts/xy/LineChart.d.ts +2 -2
  185. package/dist/components/charts/xy/Scatterplot.d.ts +1 -1
  186. package/dist/components/charts/xy/bumpData.d.ts +44 -0
  187. package/dist/components/charts/xy/bumpIdentity.d.ts +2 -0
  188. package/dist/components/charts/xy/bumpLayout.d.ts +45 -0
  189. package/dist/components/charts/xy/bumpTooltip.d.ts +20 -0
  190. package/dist/components/legendLayout.d.ts +131 -4
  191. package/dist/components/realtime/ReorderBuffer.d.ts +2 -0
  192. package/dist/components/realtime/types.d.ts +10 -1
  193. package/dist/components/recipes/balanceSnapshotsToFlows.d.ts +42 -0
  194. package/dist/components/recipes/directedReachability.d.ts +14 -0
  195. package/dist/components/recipes/gofishDisplayListFixtures.generated.d.ts +6 -6
  196. package/dist/components/recipes/gridObservatory.d.ts +1 -1
  197. package/dist/components/recipes/networkAnalysis.d.ts +1 -18
  198. package/dist/components/recipes/physics.d.ts +7 -4
  199. package/dist/components/recipes/processPhysics.d.ts +0 -1
  200. package/dist/components/recipes/waffle.d.ts +7 -4
  201. package/dist/components/semiotic-ai-core.d.ts +13 -4
  202. package/dist/components/semiotic-ai-observations.d.ts +3 -0
  203. package/dist/components/semiotic-ai.d.ts +16 -9
  204. package/dist/components/semiotic-client-shared.d.ts +10 -0
  205. package/dist/components/semiotic-experimental.d.ts +1 -1
  206. package/dist/components/semiotic-geo.d.ts +4 -1
  207. package/dist/components/semiotic-network.d.ts +7 -4
  208. package/dist/components/semiotic-ordinal.d.ts +4 -1
  209. package/dist/components/semiotic-physics.d.ts +11 -4
  210. package/dist/components/semiotic-realtime-core.d.ts +11 -4
  211. package/dist/components/semiotic-realtime-react.d.ts +4 -3
  212. package/dist/components/semiotic-realtime.d.ts +3 -1
  213. package/dist/components/semiotic-recipes-core.d.ts +7 -5
  214. package/dist/components/semiotic-server-edge.d.ts +3 -2
  215. package/dist/components/semiotic-server.d.ts +3 -2
  216. package/dist/components/semiotic-themes-core.d.ts +5 -48
  217. package/dist/components/semiotic-utils-core.d.ts +10 -5
  218. package/dist/components/semiotic-utils-react.d.ts +2 -0
  219. package/dist/components/semiotic-xy.d.ts +4 -1
  220. package/dist/components/semiotic.d.ts +68 -26
  221. package/dist/components/server/animatedGif.d.ts +1 -1
  222. package/dist/components/server/renderEvidence.d.ts +25 -2
  223. package/dist/components/server/renderToStaticSVG.d.ts +15 -7
  224. package/dist/components/server/serverChartConfigShared.d.ts +8 -1
  225. package/dist/components/server/serverChartConfigs.d.ts +1 -0
  226. package/dist/components/server/serverChartConfigsNetwork.d.ts +3 -3
  227. package/dist/components/server/serverChartConfigsNetworkChord.d.ts +2 -0
  228. package/dist/components/server/serverChartConfigsNetworkForce.d.ts +2 -0
  229. package/dist/components/server/serverChartConfigsNetworkHierarchy.d.ts +3 -0
  230. package/dist/components/server/serverChartConfigsXY.d.ts +3 -3
  231. package/dist/components/server/serverChartConfigsXYBubble.d.ts +5 -0
  232. package/dist/components/server/serverChartConfigsXYBump.d.ts +7 -0
  233. package/dist/components/server/serverChartConfigsXYScatter.d.ts +5 -0
  234. package/dist/components/server/staticAnnotationFallbacks.d.ts +10 -0
  235. package/dist/components/server/staticAnnotations.d.ts +28 -1
  236. package/dist/components/server/staticAxisTickLabel.d.ts +13 -0
  237. package/dist/components/server/staticLegend.d.ts +1 -1
  238. package/dist/components/server/staticLegendMargin.d.ts +41 -0
  239. package/dist/components/server/staticOrdinal.d.ts +8 -2
  240. package/dist/components/server/staticPhysics.d.ts +13 -1
  241. package/dist/components/server/staticPhysicsChrome.d.ts +20 -0
  242. package/dist/components/server/staticRawLegend.d.ts +15 -0
  243. package/dist/components/server/staticSVGChrome.d.ts +16 -55
  244. package/dist/components/server/staticXYAxes.d.ts +27 -0
  245. package/dist/components/server/staticXYAxisTicks.d.ts +39 -0
  246. package/dist/components/server/staticXYGrid.d.ts +11 -0
  247. package/dist/components/server/themeResolver.d.ts +5 -1
  248. package/dist/components/store/ThemeStore.d.ts +2 -98
  249. package/dist/components/store/designTokens.d.ts +1 -1
  250. package/dist/components/store/themeCSSVariables.d.ts +10 -0
  251. package/dist/components/store/themeCore.d.ts +91 -0
  252. package/dist/components/store/themePresets.d.ts +81 -0
  253. package/dist/components/store/themeSerialization.d.ts +2 -1
  254. package/dist/components/stream/AccessibleDataTable.d.ts +12 -14
  255. package/dist/components/stream/AccessibleTablePortalImpl.d.ts +6 -0
  256. package/dist/components/stream/GeoTileRenderer.d.ts +2 -0
  257. package/dist/components/stream/NetworkCanvasHitTester.d.ts +3 -1
  258. package/dist/components/stream/NetworkSSRFrame.d.ts +2 -1
  259. package/dist/components/stream/NetworkSVGOverlay.d.ts +3 -31
  260. package/dist/components/stream/OrdinalCanvasHitTester.d.ts +2 -0
  261. package/dist/components/stream/SVGChartTitle.d.ts +9 -0
  262. package/dist/components/stream/SVGOverlay.d.ts +1 -21
  263. package/dist/components/stream/SVGUnderlay.d.ts +24 -0
  264. package/dist/components/stream/SceneToSVG.d.ts +1 -1
  265. package/dist/components/stream/StreamGeoFrame.d.ts +1 -1
  266. package/dist/components/stream/StreamOrdinalFrame.d.ts +1 -1
  267. package/dist/components/stream/StreamXYFrame.d.ts +1 -1
  268. package/dist/components/stream/accessibleDataRows.d.ts +11 -0
  269. package/dist/components/stream/accessibleDataTableModel.d.ts +40 -0
  270. package/dist/components/stream/accessibleTableTypes.d.ts +11 -0
  271. package/dist/components/stream/axisTickUtils.d.ts +19 -0
  272. package/dist/components/stream/canvasBackground.d.ts +10 -0
  273. package/dist/components/stream/canvasSetup.d.ts +9 -0
  274. package/dist/components/stream/frameCursorInteraction.d.ts +25 -0
  275. package/dist/components/stream/frameDefaultMargins.d.ts +37 -0
  276. package/dist/components/stream/frameGraphics.d.ts +18 -0
  277. package/dist/components/stream/frameGraphicsSubscription.d.ts +26 -0
  278. package/dist/components/stream/frameLegendOptions.d.ts +18 -0
  279. package/dist/components/stream/geoFrameCursorInteraction.d.ts +9 -0
  280. package/dist/components/stream/geoFrameHelpers.d.ts +29 -1
  281. package/dist/components/stream/geoTypes.d.ts +10 -11
  282. package/dist/components/stream/hitTarget.d.ts +61 -2
  283. package/dist/components/stream/moduleWorkerSession.d.ts +6 -0
  284. package/dist/components/stream/networkAnnotationAnchors.d.ts +37 -0
  285. package/dist/components/stream/networkCustomLayout.d.ts +2 -2
  286. package/dist/components/stream/networkFrameCursorInteraction.d.ts +12 -0
  287. package/dist/components/stream/networkFrameInteraction.d.ts +2 -0
  288. package/dist/components/stream/networkFramePaint.d.ts +7 -0
  289. package/dist/components/stream/networkPipelineConfig.d.ts +1 -1
  290. package/dist/components/stream/networkTypes.d.ts +30 -32
  291. package/dist/components/stream/normalizeXYData.d.ts +7 -0
  292. package/dist/components/stream/ordinalFrameCursorInteraction.d.ts +7 -0
  293. package/dist/components/stream/ordinalFrameInteraction.d.ts +29 -0
  294. package/dist/components/stream/ordinalSceneSVG.d.ts +10 -0
  295. package/dist/components/stream/ordinalTypes.d.ts +10 -4
  296. package/dist/components/stream/physics/PhysicsBodySpatialIndex.d.ts +9 -1
  297. package/dist/components/stream/physics/PhysicsCanvasTheme.d.ts +25 -0
  298. package/dist/components/stream/physics/PhysicsControllers.d.ts +0 -3
  299. package/dist/components/stream/physics/PhysicsPipelineStore.d.ts +4 -1
  300. package/dist/components/stream/physics/PhysicsSVGOverlay.d.ts +3 -24
  301. package/dist/components/stream/physics/PhysicsSettledSVG.d.ts +9 -21
  302. package/dist/components/stream/physics/PhysicsSettledSVGElement.d.ts +37 -0
  303. package/dist/components/stream/physics/PhysicsSettledScene.d.ts +7 -3
  304. package/dist/components/stream/physics/StreamPhysicsFrame.d.ts +1 -1
  305. package/dist/components/stream/physics/StreamPhysicsTypes.d.ts +23 -4
  306. package/dist/components/stream/physics/physicsAnnotationContext.d.ts +19 -0
  307. package/dist/components/stream/physics/physicsBodyCanvas.d.ts +4 -0
  308. package/dist/components/stream/physics/physicsSettledChrome.d.ts +7 -0
  309. package/dist/components/stream/physics/usePhysicsCanvasPointer.d.ts +32 -0
  310. package/dist/components/stream/physics/usePhysicsSemanticNavigation.d.ts +36 -0
  311. package/dist/components/stream/pipelineConfig.d.ts +6 -17
  312. package/dist/components/stream/pipelineDomainResolution.d.ts +1 -1
  313. package/dist/components/stream/renderBackend.d.ts +2 -0
  314. package/dist/components/stream/renderers/canvasRenderHelpers.d.ts +13 -2
  315. package/dist/components/stream/renderers/resolveCSSColor.d.ts +7 -0
  316. package/dist/components/stream/responsiveSize.d.ts +17 -0
  317. package/dist/components/stream/sceneCursor.d.ts +41 -0
  318. package/dist/components/stream/sceneRevisionDiagnostics.d.ts +1 -1
  319. package/dist/components/stream/svgOverlayUtils.d.ts +22 -1
  320. package/dist/components/stream/types.d.ts +25 -12
  321. package/dist/components/stream/useCanvasFrameHost.d.ts +3 -1
  322. package/dist/components/stream/useFrame.d.ts +24 -1
  323. package/dist/components/stream/useResponsiveSize.d.ts +6 -1
  324. package/dist/components/stream/useStalenessCheck.d.ts +1 -1
  325. package/dist/components/stream/xyFrameAxisTypes.d.ts +15 -4
  326. package/dist/components/stream/xyFrameCursorInteraction.d.ts +6 -0
  327. package/dist/components/stream/xySceneBuilders/swarmScene.d.ts +1 -1
  328. package/dist/components/stream/xySceneBuilders/types.d.ts +6 -26
  329. package/dist/components/types/legendTypes.d.ts +6 -0
  330. package/dist/components/types/marginType.d.ts +7 -8
  331. package/dist/controls.min.js +1 -1
  332. package/dist/controls.module.min.js +1 -1
  333. package/dist/forceLayoutWorker.js +1 -1
  334. package/dist/geo.min.js +1 -1
  335. package/dist/geo.module.min.js +1 -1
  336. package/dist/network.min.js +1 -1
  337. package/dist/network.module.min.js +1 -1
  338. package/dist/ordinal.min.js +1 -1
  339. package/dist/ordinal.module.min.js +1 -1
  340. package/dist/physics-matter.module.min.js +1 -1
  341. package/dist/physics-rapier.module.min.js +1 -1
  342. package/dist/physics.min.js +1 -1
  343. package/dist/physics.module.min.js +1 -1
  344. package/dist/physicsWorker.js +1 -1
  345. package/dist/processSankeyLayoutWorker.js +1 -1
  346. package/dist/realtime.min.js +1 -1
  347. package/dist/realtime.module.min.js +1 -1
  348. package/dist/rough.min.js +1 -1
  349. package/dist/rough.module.min.js +1 -1
  350. package/dist/semiotic-ai-core.d.ts +13 -4
  351. package/dist/semiotic-ai-core.min.js +1 -1
  352. package/dist/semiotic-ai-core.module.min.js +1 -1
  353. package/dist/semiotic-ai.d.ts +16 -9
  354. package/dist/semiotic-ai.min.js +1 -1
  355. package/dist/semiotic-ai.module.min.js +1 -1
  356. package/dist/semiotic-client-cjs-shared.min.js +1 -0
  357. package/dist/semiotic-client-glyph.module.min.js +2 -0
  358. package/dist/semiotic-client-responsive.module.min.js +2 -0
  359. package/dist/semiotic-client-shared.module.min.js +2 -0
  360. package/dist/semiotic-custom-layout-selection-cjs-shared.min.js +2 -0
  361. package/dist/semiotic-data.min.js +1 -1
  362. package/dist/semiotic-data.module.min.js +1 -1
  363. package/dist/semiotic-experimental-auxiliary.module.min.js +2 -0
  364. package/dist/semiotic-experimental-node-auxiliary.module.min.js +2 -0
  365. package/dist/semiotic-experimental-node.module.min.js +2 -0
  366. package/dist/semiotic-experimental-react-shared.module.min.js +2 -0
  367. package/dist/semiotic-experimental-vacp.min.js +1 -1
  368. package/dist/semiotic-experimental-vacp.module.min.js +1 -1
  369. package/dist/semiotic-experimental.d.ts +1 -1
  370. package/dist/semiotic-experimental.min.js +1 -1
  371. package/dist/semiotic-experimental.module.min.js +1 -1
  372. package/dist/semiotic-geo.d.ts +4 -1
  373. package/dist/semiotic-network.d.ts +7 -4
  374. package/dist/semiotic-ordinal.d.ts +4 -1
  375. package/dist/semiotic-physics.d.ts +11 -4
  376. package/dist/semiotic-realtime-core.d.ts +11 -4
  377. package/dist/semiotic-realtime-core.min.js +2 -1
  378. package/dist/semiotic-realtime-core.module.min.js +2 -1
  379. package/dist/semiotic-realtime-react.d.ts +4 -3
  380. package/dist/semiotic-realtime-react.min.js +1 -1
  381. package/dist/semiotic-realtime-react.module.min.js +1 -1
  382. package/dist/semiotic-realtime.d.ts +3 -1
  383. package/dist/semiotic-recipes-core-cjs-base.min.js +1 -0
  384. package/dist/semiotic-recipes-core.d.ts +7 -5
  385. package/dist/semiotic-recipes-core.min.js +9 -1
  386. package/dist/semiotic-recipes-core.module.min.js +1 -1
  387. package/dist/semiotic-recipes-geo-cjs.min.js +1 -0
  388. package/dist/semiotic-recipes-react.min.js +1 -1
  389. package/dist/semiotic-recipes-react.module.min.js +1 -1
  390. package/dist/semiotic-recipes.min.js +7 -1
  391. package/dist/semiotic-recipes.module.min.js +2 -1
  392. package/dist/semiotic-server-edge-node.module.min.js +1 -0
  393. package/dist/semiotic-server-edge.d.ts +3 -2
  394. package/dist/semiotic-server-edge.min.js +1 -1
  395. package/dist/semiotic-server-edge.module.min.js +1 -1
  396. package/dist/semiotic-server-node.min.js +1 -1
  397. package/dist/semiotic-server-node.module.min.js +1 -1
  398. package/dist/semiotic-server.d.ts +3 -2
  399. package/dist/semiotic-themes-core.d.ts +5 -48
  400. package/dist/semiotic-themes-core.min.js +1 -1
  401. package/dist/semiotic-themes-core.module.min.js +1 -1
  402. package/dist/semiotic-themes-react.min.js +1 -1
  403. package/dist/semiotic-themes-react.module.min.js +1 -1
  404. package/dist/semiotic-themes.min.js +1 -1
  405. package/dist/semiotic-themes.module.min.js +1 -1
  406. package/dist/semiotic-utils-core.d.ts +10 -5
  407. package/dist/semiotic-utils-core.min.js +1 -1
  408. package/dist/semiotic-utils-core.module.min.js +1 -1
  409. package/dist/semiotic-utils-react.d.ts +2 -0
  410. package/dist/semiotic-utils-react.min.js +1 -1
  411. package/dist/semiotic-utils-react.module.min.js +1 -1
  412. package/dist/semiotic-utils.min.js +2 -1
  413. package/dist/semiotic-utils.module.min.js +2 -1
  414. package/dist/semiotic-value.min.js +1 -1
  415. package/dist/semiotic-value.module.min.js +1 -1
  416. package/dist/semiotic-xy.d.ts +4 -1
  417. package/dist/semiotic.d.ts +68 -26
  418. package/dist/semiotic.min.js +1 -1
  419. package/dist/semiotic.module.min.js +1 -1
  420. package/dist/server.min.js +1 -1
  421. package/dist/server.module.min.js +1 -1
  422. package/dist/xy.min.js +1 -1
  423. package/dist/xy.module.min.js +1 -1
  424. package/package.json +53 -19
  425. package/dist/__tests__/scenarios/mcpProtocolTypes.d.ts +0 -20
  426. package/dist/chunk-OrdinalBrushOverlay-PXHQYDB2.module.min.js +0 -2
  427. package/dist/chunk-XYBrushOverlay-ECZJJLAJ.module.min.js +0 -1
  428. package/dist/chunk-XYBrushOverlay-EP2SV3UI.module.min.js +0 -2
  429. package/dist/chunk-chartContainerDataAudit-IQ3NBN3Q.module.min.js +0 -2
  430. package/dist/chunk-chunk-2B3AIKUZ.module.min.js +0 -2
  431. package/dist/chunk-chunk-2CXCXRB4.module.min.js +0 -1
  432. package/dist/chunk-chunk-2X3FJCME.module.min.js +0 -1
  433. package/dist/chunk-chunk-2ZHHWZQM.module.min.js +0 -2
  434. package/dist/chunk-chunk-4ITOQRXM.module.min.js +0 -2
  435. package/dist/chunk-chunk-5UKL5W76.module.min.js +0 -2
  436. package/dist/chunk-chunk-5VVNW5AZ.module.min.js +0 -1
  437. package/dist/chunk-chunk-5ZON5NMV.module.min.js +0 -2
  438. package/dist/chunk-chunk-66PCWJUG.module.min.js +0 -1
  439. package/dist/chunk-chunk-6S3YGYW7.module.min.js +0 -1
  440. package/dist/chunk-chunk-6V5VQVCT.module.min.js +0 -2
  441. package/dist/chunk-chunk-7C5EDZ3Z.module.min.js +0 -2
  442. package/dist/chunk-chunk-A3I4HBD5.module.min.js +0 -1
  443. package/dist/chunk-chunk-ACLDBMRH.module.min.js +0 -2
  444. package/dist/chunk-chunk-AFQHURLO.module.min.js +0 -2
  445. package/dist/chunk-chunk-DDB4TLQG.module.min.js +0 -2
  446. package/dist/chunk-chunk-DTH3SUOU.module.min.js +0 -2
  447. package/dist/chunk-chunk-DTSNLGRK.module.min.js +0 -2
  448. package/dist/chunk-chunk-DVCWU7MT.module.min.js +0 -2
  449. package/dist/chunk-chunk-FEPXDKJP.module.min.js +0 -1
  450. package/dist/chunk-chunk-FJ76HWQZ.module.min.js +0 -1
  451. package/dist/chunk-chunk-FSIHAW6L.module.min.js +0 -2
  452. package/dist/chunk-chunk-G2RGVEYY.module.min.js +0 -2
  453. package/dist/chunk-chunk-G75OPF5N.module.min.js +0 -2
  454. package/dist/chunk-chunk-HADHLMY5.module.min.js +0 -1
  455. package/dist/chunk-chunk-HAJVODLO.module.min.js +0 -2
  456. package/dist/chunk-chunk-HBFA4NN6.module.min.js +0 -1
  457. package/dist/chunk-chunk-HIV7AW2V.module.min.js +0 -2
  458. package/dist/chunk-chunk-IY7RYD4S.module.min.js +0 -1
  459. package/dist/chunk-chunk-J3QOW4OE.module.min.js +0 -0
  460. package/dist/chunk-chunk-J3XWETBJ.module.min.js +0 -2
  461. package/dist/chunk-chunk-JZAMMSQQ.module.min.js +0 -2
  462. package/dist/chunk-chunk-KTWEBFMX.module.min.js +0 -2
  463. package/dist/chunk-chunk-LSJUXBMF.module.min.js +0 -1
  464. package/dist/chunk-chunk-MXMRXSCI.module.min.js +0 -2
  465. package/dist/chunk-chunk-MXVBXFKW.module.min.js +0 -2
  466. package/dist/chunk-chunk-NWIGA3UK.module.min.js +0 -1
  467. package/dist/chunk-chunk-OFAP623Y.module.min.js +0 -2
  468. package/dist/chunk-chunk-OHLRAEQZ.module.min.js +0 -2
  469. package/dist/chunk-chunk-OZK46A5U.module.min.js +0 -1
  470. package/dist/chunk-chunk-PMR47KRY.module.min.js +0 -2
  471. package/dist/chunk-chunk-PRNXOCYZ.module.min.js +0 -2
  472. package/dist/chunk-chunk-Q2YADC2V.module.min.js +0 -2
  473. package/dist/chunk-chunk-RLKZVJMQ.module.min.js +0 -2
  474. package/dist/chunk-chunk-ROP4HI7H.module.min.js +0 -2
  475. package/dist/chunk-chunk-SK2TQMG4.module.min.js +0 -2
  476. package/dist/chunk-chunk-SKLYXNYW.module.min.js +0 -2
  477. package/dist/chunk-chunk-TCMHJWFJ.module.min.js +0 -1
  478. package/dist/chunk-chunk-TSCFL235.module.min.js +0 -1
  479. package/dist/chunk-chunk-U4NZCU5T.module.min.js +0 -2
  480. package/dist/chunk-chunk-U66USBWU.module.min.js +0 -1
  481. package/dist/chunk-chunk-UOQRPGPK.module.min.js +0 -2
  482. package/dist/chunk-chunk-VKL6DI43.module.min.js +0 -2
  483. package/dist/chunk-chunk-W62673ZE.module.min.js +0 -1
  484. package/dist/chunk-chunk-WFHZHWT7.module.min.js +0 -1
  485. package/dist/chunk-chunk-XCC25CZZ.module.min.js +0 -2
  486. package/dist/chunk-chunk-XECNOUZY.module.min.js +0 -2
  487. package/dist/chunk-chunk-XYZDTYAF.module.min.js +0 -2
  488. package/dist/chunk-chunk-YHNZCPOZ.module.min.js +0 -2
  489. package/dist/chunk-chunk-YWZB3KPI.module.min.js +0 -2
  490. package/dist/chunk-statisticalOverlays-HMYYSGPE.module.min.js +0 -2
  491. package/dist/components/stream/test-utils/frameScheduler.d.ts +0 -12
  492. package/dist/components/stream/test-utils/revisionConsumption.d.ts +0 -13
  493. package/dist/test-utils/canvasMock.d.ts +0 -86
  494. package/dist/test-utils/capturedFrameProps.d.ts +0 -67
  495. package/dist/test-utils/frameMock.d.ts +0 -81
  496. package/dist/test-utils/ordinalFixtures.d.ts +0 -48
  497. /package/dist/{chunk-chunk-JJ2OOIET.module.min.js → c-GGISSW5E.min.js} +0 -0
  498. /package/dist/{chunk-chunk-SIRIJ3DY.module.min.js → c-N4G2L7ID.min.js} +0 -0
  499. /package/dist/{chunk-chunk-CA3YDW6F.module.min.js → c-S6U5CGT5.min.js} +0 -0
  500. /package/dist/components/recipes/{mobileAnnotationStrategy.d.ts → mobileAnnotationBehavior.d.ts} +0 -0
@@ -1,4 +1,17 @@
1
- import type { ChartCapability } from "../../ai/chartCapabilityTypes";
1
+ import type { ChartCapability, ChartDataProfile } from "../../ai/chartCapabilityTypes";
2
+ export interface RankColumnOccupancy {
3
+ columns: number;
4
+ min: number;
5
+ median: number;
6
+ max: number;
7
+ contestedColumns: number;
8
+ }
9
+ /**
10
+ * Count the distinct ranking series competing in each ranking column. A
11
+ * distinct x count alone is not enough for a bump chart: a resource list with
12
+ * one timestamp per row has plenty of columns but no rank competition.
13
+ */
14
+ export declare function rankColumnOccupancy(profile: Pick<ChartDataProfile, "data" | "primary">): RankColumnOccupancy | undefined;
2
15
  /**
3
16
  * BumpChart capability — the ranking-over-x chart. Its canonical job is the
4
17
  * `rank` intent: several series ranked against each other at each x-column,
@@ -1,81 +1,16 @@
1
1
  import * as React from "react";
2
2
  import type { RealtimeFrameHandle } from "../../realtime/types";
3
- import type { StreamXYFrameProps, Style } from "../../stream/types";
4
- import type { LayoutContext, LayoutResult } from "../../stream/customLayout";
3
+ import type { StreamXYFrameProps } from "../../stream/types";
5
4
  import type { BaseChartProps, AxisConfig, ChartAccessor } from "../shared/types";
6
5
  import type { Datum } from "../shared/datumTypes";
7
6
  import type { TooltipProp } from "../../Tooltip/Tooltip";
8
- import { type StyleRule } from "../shared/styleRules";
7
+ import type { StyleRule } from "../shared/styleRules";
9
8
  import type { LegendValue } from "../../types/legendTypes";
10
9
  import type { LegendInteractionMode, LegendPosition } from "../shared/useChartLegend";
11
- export interface RankedBumpDatum<TDatum extends Datum = Datum> extends Datum {
12
- x: number;
13
- y: number;
14
- __bumpRaw: TDatum;
15
- __bumpSeries: string;
16
- __bumpColorGroup: string;
17
- __bumpValue: number;
18
- __bumpRank: number;
19
- __bumpXValue: unknown;
20
- __bumpHighlighted: boolean;
21
- }
22
- export interface RankedBumpData<TDatum extends Datum = Datum> {
23
- data: RankedBumpDatum<TDatum>[];
24
- xValues: unknown[];
25
- seriesOrder: string[];
26
- overallOrder: string[];
27
- valueExtent: [number, number];
28
- }
29
- export interface RankBumpDataOptions<TDatum extends Datum = Datum> {
30
- xAccessor?: ChartAccessor<TDatum, number | Date | string>;
31
- yAccessor?: ChartAccessor<TDatum, number>;
32
- lineBy?: ChartAccessor<TDatum, string>;
33
- rankDirection?: "descending" | "ascending";
34
- highlightTop?: number;
35
- }
36
- export declare function mapBumpAnnotations(annotations: Datum[] | undefined, xValues: unknown[]): Datum[] | undefined;
37
- export declare function resolveBumpColorScheme(options: {
38
- seriesOrder: string[];
39
- overallOrder: string[];
40
- highlightTop?: number;
41
- color?: string;
42
- colorScheme?: string | string[] | Record<string, string>;
43
- neutralColor?: string;
44
- themeCategorical?: string[];
45
- themeNeutral?: string;
46
- }): string | string[] | Record<string, string> | undefined;
47
- /**
48
- * Rank every x-column and return the flattened, frame-ready rows used by
49
- * BumpChart. Ranking is ordinal and deterministic: equal values retain series
50
- * first-appearance order.
51
- */
52
- export declare function rankBumpData<TDatum extends Datum = Datum>(input: TDatum[], options?: RankBumpDataOptions<TDatum>): RankedBumpData<TDatum>;
53
- export interface BumpLayoutConfig {
54
- ribbon: boolean;
55
- curve: "smooth" | "linear";
56
- samplesPerSegment: number;
57
- ribbonSizeRange: [number, number];
58
- valueExtent: [number, number];
59
- seriesOrder: string[];
60
- lineWidth: number;
61
- ribbonOpacity: number;
62
- lineOpacity: number;
63
- neutralColor?: string;
64
- color?: string;
65
- stroke?: string;
66
- strokeWidth?: number;
67
- opacity?: number;
68
- styleRules?: ReadonlyArray<StyleRule>;
69
- areaStyle?: (datum: Datum) => Style;
70
- pointStyle?: (datum: Datum) => Style & {
71
- r?: number;
72
- };
73
- labelStyle?: React.CSSProperties | ((datum: Datum) => React.CSSProperties);
74
- showPoints: boolean;
75
- pointRadius: number;
76
- showLabels: boolean | "start" | "end" | "both";
77
- }
78
- export declare function bumpLayout(ctx: LayoutContext<BumpLayoutConfig>): LayoutResult;
10
+ export { mapBumpAnnotations, rankBumpData, resolveBumpColorScheme } from "./bumpData";
11
+ export type { RankBumpDataOptions, RankedBumpData, RankedBumpDatum } from "./bumpData";
12
+ export { bumpLayout, selectBumpLabelCandidates, } from "./bumpLayout";
13
+ export type { BumpLayoutConfig, BumpLabelSelectionCandidate, } from "./bumpLayout";
79
14
  export interface BumpChartProps<TDatum extends Datum = Datum> extends BaseChartProps, AxisConfig {
80
15
  /** Flat observations. Each x-column is ranked from `yAccessor`. */
81
16
  data: TDatum[];
@@ -110,8 +45,12 @@ export interface BumpChartProps<TDatum extends Datum = Datum> extends BaseChartP
110
45
  lineOpacity?: number;
111
46
  showPoints?: boolean;
112
47
  pointRadius?: number;
113
- /** Endpoint labels. `true` is equivalent to `"end"`. Default `true`. */
114
- showLabels?: boolean | "start" | "end" | "both";
48
+ /** Endpoint labels. `true` is equivalent to `"end"`; `"auto"` sheds labels by plot density. Default `true`. */
49
+ showLabels?: boolean | "start" | "end" | "both" | "auto";
50
+ /** Numeric field or accessor used to keep higher-priority labels when labels collide. */
51
+ labelPriorityAccessor?: ChartAccessor<TDatum, number>;
52
+ /** Optional hard cap on visible labels when `showLabels="auto"`. */
53
+ maxLabels?: number;
115
54
  showAxes?: boolean;
116
55
  showGrid?: boolean;
117
56
  showLegend?: boolean;
@@ -122,6 +61,7 @@ export interface BumpChartProps<TDatum extends Datum = Datum> extends BaseChartP
122
61
  enableHover?: boolean;
123
62
  /** Dim every trajectory except the hovered series. Default `true`. */
124
63
  hoverHighlight?: boolean | "series";
64
+ /** Tooltip configuration. Pass `"multi"` to compare every trajectory at the hovered x position. */
125
65
  tooltip?: TooltipProp;
126
66
  /** Annotation objects. X coordinates may use the original x values. */
127
67
  annotations?: Datum[];
@@ -0,0 +1,5 @@
1
+ import type { SemanticViabilityDiagnostic, SemanticViabilityRule } from "../../ai/chartCapabilityTypes";
2
+ import type { Datum } from "../shared/datumTypes";
3
+ export declare const BUMP_CHART_SEMANTIC_VIABILITY: SemanticViabilityRule;
4
+ /** Capability-owned rank-competition check shared by AI and static rendering. */
5
+ export declare function evaluateRankCompetition(props: Readonly<Datum>): ReadonlyArray<SemanticViabilityDiagnostic>;
@@ -8,9 +8,9 @@ import { type TooltipProp } from "../../Tooltip/Tooltip";
8
8
  export interface CandlestickChartProps<TDatum extends Datum = Datum> extends BaseChartProps, AxisConfig {
9
9
  data?: TDatum[];
10
10
  xAccessor?: ChartAccessor<TDatum, number>;
11
- /** Required — upper bound (candlestick high, or range top) */
11
+ /** Upper bound (candlestick high, or range top). @default "high" */
12
12
  highAccessor?: ChartAccessor<TDatum, number>;
13
- /** Required — lower bound (candlestick low, or range bottom) */
13
+ /** Lower bound (candlestick low, or range bottom). @default "low" */
14
14
  lowAccessor?: ChartAccessor<TDatum, number>;
15
15
  /** Optional — when paired with closeAccessor, renders OHLC candlesticks. Omit both to render a range chart. */
16
16
  openAccessor?: ChartAccessor<TDatum, number>;
@@ -47,7 +47,7 @@ export interface LineChartProps<TDatum extends Datum = Datum> extends BaseChartP
47
47
  * Scale type for the y-axis
48
48
  * @default "linear"
49
49
  */
50
- yScaleType?: "linear" | "log";
50
+ yScaleType?: "linear" | "log" | "symlog";
51
51
  /**
52
52
  * Field name or function to group data into multiple lines
53
53
  * @example
@@ -292,7 +292,7 @@ export interface LineChartProps<TDatum extends Datum = Datum> extends BaseChartP
292
292
  * data={data}
293
293
  * frameProps={{
294
294
  * lineType: { type: "line", interpolator: d3.curveCardinal },
295
- * customLineMark: ({ d }) => <path stroke="red" />
295
+ * lineStyle: () => ({ stroke: "red", strokeWidth: 2 })
296
296
  * }}
297
297
  * />
298
298
  * ```
@@ -22,7 +22,7 @@ export interface ScatterplotProps<TDatum extends Datum = Datum> extends BaseChar
22
22
  /** X scale type @default "linear" */
23
23
  xScaleType?: "linear" | "log" | "time";
24
24
  /** Y scale type @default "linear" */
25
- yScaleType?: "linear" | "log";
25
+ yScaleType?: "linear" | "log" | "symlog";
26
26
  /** Field name or function to determine point color */
27
27
  colorBy?: ChartAccessor<TDatum, string>;
28
28
  /** Color scheme for categorical data or custom colors array @default "category10" */
@@ -0,0 +1,44 @@
1
+ import type { ChartAccessor } from "../shared/types";
2
+ import type { Datum } from "../shared/datumTypes";
3
+ export interface RankedBumpDatum<TDatum extends Datum = Datum> extends Datum {
4
+ x: number;
5
+ y: number;
6
+ __bumpRaw: TDatum;
7
+ __bumpSeries: string;
8
+ __bumpColorGroup: string;
9
+ __bumpValue: number;
10
+ __bumpRank: number;
11
+ __bumpXValue: unknown;
12
+ __bumpHighlighted: boolean;
13
+ }
14
+ export interface RankedBumpData<TDatum extends Datum = Datum> {
15
+ data: RankedBumpDatum<TDatum>[];
16
+ xValues: unknown[];
17
+ seriesOrder: string[];
18
+ overallOrder: string[];
19
+ valueExtent: [number, number];
20
+ }
21
+ export interface RankBumpDataOptions<TDatum extends Datum = Datum> {
22
+ xAccessor?: ChartAccessor<TDatum, number | Date | string>;
23
+ yAccessor?: ChartAccessor<TDatum, number>;
24
+ lineBy?: ChartAccessor<TDatum, string>;
25
+ rankDirection?: "descending" | "ascending";
26
+ highlightTop?: number;
27
+ }
28
+ export declare function mapBumpAnnotations(annotations: Datum[] | undefined, xValues: unknown[]): Datum[] | undefined;
29
+ export declare function resolveBumpColorScheme(options: {
30
+ seriesOrder: string[];
31
+ overallOrder: string[];
32
+ highlightTop?: number;
33
+ color?: string;
34
+ colorScheme?: string | string[] | Record<string, string>;
35
+ neutralColor?: string;
36
+ themeCategorical?: string[];
37
+ themeNeutral?: string;
38
+ }): string | string[] | Record<string, string> | undefined;
39
+ /**
40
+ * Rank every x-column and return the flattened, frame-ready rows used by
41
+ * BumpChart. Ranking is ordinal and deterministic: equal values retain series
42
+ * first-appearance order.
43
+ */
44
+ export declare function rankBumpData<TDatum extends Datum = Datum>(input: TDatum[], options?: RankBumpDataOptions<TDatum>): RankedBumpData<TDatum>;
@@ -0,0 +1,2 @@
1
+ /** Stable type-aware identity for a BumpChart ranking column. */
2
+ export declare function bumpXIdentity(value: unknown): string;
@@ -0,0 +1,45 @@
1
+ import * as React from "react";
2
+ import type { Style } from "../../stream/types";
3
+ import type { LayoutContext, LayoutResult } from "../../stream/customLayout";
4
+ import type { Datum } from "../shared/datumTypes";
5
+ import { type StyleRule } from "../shared/styleRules";
6
+ export interface BumpLayoutConfig {
7
+ ribbon: boolean;
8
+ curve: "smooth" | "linear";
9
+ samplesPerSegment: number;
10
+ ribbonSizeRange: [number, number];
11
+ valueExtent: [number, number];
12
+ seriesOrder: string[];
13
+ lineWidth: number;
14
+ ribbonOpacity: number;
15
+ lineOpacity: number;
16
+ neutralColor?: string;
17
+ color?: string;
18
+ colorMap?: Record<string, string>;
19
+ stroke?: string;
20
+ strokeWidth?: number;
21
+ opacity?: number;
22
+ styleRules?: ReadonlyArray<StyleRule>;
23
+ areaStyle?: (datum: Datum) => Style;
24
+ pointStyle?: (datum: Datum) => Style & {
25
+ r?: number;
26
+ };
27
+ labelStyle?: React.CSSProperties | ((datum: Datum) => React.CSSProperties);
28
+ showPoints: boolean;
29
+ pointRadius: number;
30
+ showLabels: boolean | "start" | "end" | "both" | "auto";
31
+ labelPriorityAccessor?: string | ((datum: Datum) => number);
32
+ maxLabels?: number;
33
+ }
34
+ export interface BumpLabelSelectionCandidate {
35
+ id: string;
36
+ side: "start" | "end";
37
+ y: number;
38
+ rank: number;
39
+ highlighted: boolean;
40
+ priority?: number;
41
+ }
42
+ /** Keep endpoint labels readable in deterministic CSR and SSR layouts. */
43
+ export declare function selectBumpLabelCandidates(candidates: readonly BumpLabelSelectionCandidate[], plotHeight: number, mode: boolean | "auto", maxLabels?: number): Set<string>;
44
+ /** Shared Bump scene layout for the React HOC and server renderer. */
45
+ export declare function bumpLayout(ctx: LayoutContext<BumpLayoutConfig>): LayoutResult;
@@ -0,0 +1,20 @@
1
+ import * as React from "react";
2
+ import { type TooltipProp } from "../../Tooltip/Tooltip";
3
+ import type { Datum } from "../shared/datumTypes";
4
+ import type { AxisConfig } from "../shared/types";
5
+ interface BumpTooltipOptions {
6
+ tooltip?: TooltipProp;
7
+ xValues: unknown[];
8
+ xFormat?: AxisConfig["xFormat"];
9
+ yFormat?: AxisConfig["yFormat"];
10
+ }
11
+ /**
12
+ * Keep BumpChart's internal rank/value projection out of its public tooltip
13
+ * contract. Single callbacks receive the authored row; multi callbacks receive
14
+ * authored rows plus source values/ranks for every trajectory at the cursor.
15
+ */
16
+ export declare function useBumpTooltip<TDatum extends Datum>({ tooltip, xValues, xFormat, yFormat, }: BumpTooltipOptions): {
17
+ tooltip: TooltipProp;
18
+ formatX: (value: number | Date | string, index?: number) => React.ReactNode;
19
+ };
20
+ export {};
@@ -5,6 +5,33 @@ export declare const DEFAULT_LEGEND_ITEM_GAP = 10;
5
5
  export declare const DEFAULT_LEGEND_ROW_HEIGHT = 22;
6
6
  export declare const DEFAULT_SIDE_LEGEND_WIDTH = 100;
7
7
  export declare const DEFAULT_LEGEND_DISTANCE = 10;
8
+ export declare const DEFAULT_LEGEND_EDGE_GUTTER = 3;
9
+ /** Keep a chart's data area meaningful when chart-owned chrome (currently a
10
+ * legend) is measured in a compact frame. This intentionally does not shrink
11
+ * caller/default margins: it caps only the reservation that was added for the
12
+ * requested legend side. */
13
+ export declare function clampLegendReservation(margin: {
14
+ top: number;
15
+ right: number;
16
+ bottom: number;
17
+ left: number;
18
+ }, baseline: {
19
+ top: number;
20
+ right: number;
21
+ bottom: number;
22
+ left: number;
23
+ }, size: [number, number], position: "right" | "left" | "top" | "bottom", minPlotSize?: number): void;
24
+ /**
25
+ * Labeled gradient legends use one shared, non-negative vertical layout in
26
+ * both the browser and static SVG renderers. Legend placement treats its
27
+ * transform as the top of the content box, so drawing the label at a negative
28
+ * y (the old geometry) could clip side/top legends at the SVG edge and let a
29
+ * bottom label intrude into the plot gap.
30
+ */
31
+ export declare const GRADIENT_LEGEND_LABEL_BASELINE = 12;
32
+ export declare const GRADIENT_LEGEND_LABELED_BAR_Y = 18;
33
+ export declare const GRADIENT_LEGEND_HORIZONTAL_HEIGHT = 46;
34
+ export declare const GRADIENT_LEGEND_HORIZONTAL_HEIGHT_UNLABELED = 26;
8
35
  /**
9
36
  * SVG text has no useful intrinsic width until after it is mounted. Keep the
10
37
  * estimate shared by margin calculation and rendering so side legends never
@@ -16,7 +43,9 @@ export declare function resolveSideLegendWidth(legend: LegendValue | null | unde
16
43
  /** Resolve the requested gap between the legend edge and plot edge. */
17
44
  export declare function resolveLegendDistance(legend: LegendValue | null | undefined): number;
18
45
  /** Resolve plot-adjacent chrome reserved before a left/right legend. */
19
- export declare function resolveLegendSideGutter(layout?: LegendLayout): number;
46
+ export declare function resolveLegendSideGutter(layout?: LegendLayout, axisChrome?: Omit<AxisChromeInput, "topAxis" | "leftAxis" | "rightAxis">): number;
47
+ /** Resolve the outer edge clearance for a left/right legend. */
48
+ export declare function resolveLegendEdgeGutter(layout?: LegendLayout): number;
20
49
  /**
21
50
  * Height of the chrome a horizontal axis draws *outside* the plot rect, which
22
51
  * a top/bottom legend has to clear.
@@ -30,6 +59,10 @@ export declare function resolveLegendSideGutter(layout?: LegendLayout): number;
30
59
  export declare const AXIS_TICK_CHROME = 22;
31
60
  export declare const AXIS_TITLE_CHROME = 46;
32
61
  export declare const ROTATED_AXIS_TITLE_CHROME = 64;
62
+ /** Width needed between a side legend and a vertical axis's tick labels. */
63
+ export declare const SIDE_AXIS_TICK_CHROME = 34;
64
+ /** Width needed between a side legend and a vertical axis title/ticks. */
65
+ export declare const SIDE_AXIS_TITLE_CHROME = 70;
33
66
  export interface AxisChromeInput {
34
67
  /** A horizontal axis renders on this side of the plot. */
35
68
  hasAxis?: boolean;
@@ -37,6 +70,16 @@ export interface AxisChromeInput {
37
70
  hasAxisLabel?: boolean;
38
71
  /** Tick labels are rotated, which pushes the axis title further out. */
39
72
  rotatedTicks?: boolean;
73
+ /**
74
+ * Chrome drawn above the plot. `axisChrome` itself describes the bottom
75
+ * side for backwards compatibility; a top legend uses this companion when
76
+ * a caller has explicitly configured a top x axis.
77
+ */
78
+ topAxis?: Omit<AxisChromeInput, "topAxis">;
79
+ /** Chrome drawn to the left of the plot, used by a left legend. */
80
+ leftAxis?: Omit<AxisChromeInput, "topAxis" | "leftAxis" | "rightAxis">;
81
+ /** Chrome drawn to the right of the plot, used by a right legend. */
82
+ rightAxis?: Omit<AxisChromeInput, "topAxis" | "leftAxis" | "rightAxis">;
40
83
  }
41
84
  /**
42
85
  * Space to reserve between the plot edge and a top/bottom legend.
@@ -59,13 +102,51 @@ export declare function resolveAxisChromeGutter(input?: AxisChromeInput, layout?
59
102
  export declare function resolveXYAxisChrome(input: {
60
103
  showAxes?: boolean;
61
104
  xLabel?: unknown;
105
+ yLabel?: unknown;
106
+ yLabelRight?: unknown;
107
+ axes?: ReadonlyArray<{
108
+ orient?: string;
109
+ label?: unknown;
110
+ autoRotate?: boolean;
111
+ }>;
112
+ rotatedTicks?: boolean;
113
+ }): AxisChromeInput;
114
+ /**
115
+ * Merge a high-level chart's defaults with optional `frameProps` before
116
+ * measuring legend-adjacent axis chrome. The rendered frame receives the
117
+ * same precedence, so centralizing it prevents every XY wrapper from
118
+ * accidentally reserving a bottom-only/default axis for a supplied top or
119
+ * side-axis configuration.
120
+ */
121
+ export declare function resolveXYFramePropsAxisChrome(frameProps: {
122
+ showAxes?: boolean;
123
+ xLabel?: unknown;
124
+ yLabel?: unknown;
125
+ yLabelRight?: unknown;
126
+ axes?: ReadonlyArray<{
127
+ orient?: string;
128
+ label?: unknown;
129
+ autoRotate?: boolean;
130
+ }>;
131
+ }, defaults: {
132
+ showAxes?: boolean;
133
+ xLabel?: unknown;
134
+ yLabel?: unknown;
135
+ yLabelRight?: unknown;
136
+ axes?: ReadonlyArray<{
137
+ orient?: string;
138
+ label?: unknown;
139
+ autoRotate?: boolean;
140
+ }>;
62
141
  }): AxisChromeInput;
63
142
  /**
64
143
  * Resolve `axisChrome` for an ordinal chart HOC's `useChartLegendAndMargin`
65
144
  * call. Mirrors `server/staticOrdinal.tsx`'s `renderOrdinalFrame`: the
66
145
  * bottom axis is the value axis for `"horizontal"` projection, the category
67
- * axis otherwise, and radial projections draw no axis at all. See
68
- * `resolveXYAxisChrome` for why this must track the server computation.
146
+ * axis otherwise. Its companion left axis is the remaining category/value
147
+ * axis, which matters when a left legend must clear a vertical axis title.
148
+ * Radial projections draw neither. See `resolveXYAxisChrome` for why this
149
+ * must track the server computation.
69
150
  */
70
151
  export declare function resolveOrdinalAxisChrome(input: {
71
152
  showAxes?: boolean;
@@ -76,7 +157,53 @@ export declare function resolveOrdinalAxisChrome(input: {
76
157
  /** Estimate the layout-box height used to place a top/bottom legend. */
77
158
  export declare function resolveHorizontalLegendHeight(legend: LegendValue | null | undefined, availableWidth: number, layout?: LegendLayout): number;
78
159
  /** Margin required to fit a side legend and its plot-edge gap. */
79
- export declare function resolveSideLegendMargin(legend: LegendValue | null | undefined, layout?: LegendLayout): number;
160
+ export declare function resolveSideLegendMargin(legend: LegendValue | null | undefined, layout?: LegendLayout, axisChrome?: Omit<AxisChromeInput, "topAxis" | "leftAxis" | "rightAxis">): number;
161
+ /**
162
+ * Apply the shared legend reservation used by HOC layout, direct stream
163
+ * frames, and static rendering. Keeping this here prevents direct SSR from
164
+ * reserving a different fallback box for raw React legends than its live
165
+ * hydration target.
166
+ */
167
+ export declare function reserveLegendMargin(margin: {
168
+ top: number;
169
+ right: number;
170
+ bottom: number;
171
+ left: number;
172
+ }, options: {
173
+ legend: LegendValue | null | undefined;
174
+ position?: "right" | "left" | "top" | "bottom";
175
+ size: [number, number];
176
+ hasTitle?: boolean;
177
+ legendLayout?: LegendLayout;
178
+ minimumMargin?: number;
179
+ axisChrome?: AxisChromeInput;
180
+ }): void;
181
+ export interface LegendPlacementInput {
182
+ totalWidth: number;
183
+ totalHeight: number;
184
+ margin: {
185
+ top: number;
186
+ right: number;
187
+ bottom: number;
188
+ left: number;
189
+ };
190
+ position?: "right" | "left" | "top" | "bottom";
191
+ legendLayout?: LegendLayout;
192
+ axisChrome?: AxisChromeInput;
193
+ /** Static renderers may reserve a measured side box wider than the default. */
194
+ reservedWidth?: number;
195
+ }
196
+ /**
197
+ * Resolve the origin and box used by both live and static legend renderers.
198
+ * This includes the predictable fallback box for raw React nodes, whose
199
+ * intrinsic SVG dimensions cannot be measured before rendering.
200
+ */
201
+ export declare function resolveLegendPlacement(legend: LegendValue | null | undefined, input: LegendPlacementInput): {
202
+ x: number;
203
+ y: number;
204
+ width: number;
205
+ height: number;
206
+ };
80
207
  export interface LegendMetrics {
81
208
  swatchSize: number;
82
209
  labelGap: number;
@@ -30,6 +30,7 @@ export declare class ReorderBuffer<T> {
30
30
  private readonly latePolicy;
31
31
  private held;
32
32
  private _watermark;
33
+ private _releasedThrough;
33
34
  private _lateCount;
34
35
  constructor(config: ReorderBufferConfig<T>);
35
36
  /**
@@ -44,6 +45,7 @@ export declare class ReorderBuffer<T> {
44
45
  * stream ends and the remaining grace-window events should be shown.
45
46
  */
46
47
  flush(): T[];
48
+ private markReleased;
47
49
  clear(): void;
48
50
  /** Largest event-time seen, or `-Infinity` if empty. */
49
51
  get watermark(): number;
@@ -1,7 +1,12 @@
1
- import type { ReactNode } from "react";
1
+ import type { CSSProperties, ReactNode } from "react";
2
2
  import type { ScaleBand, ScaleLinear } from "d3-scale";
3
3
  import type { Datum } from "../charts/shared/datumTypes";
4
4
  import type { AutoPlaceAnnotations } from "../recipes/annotationLayout";
5
+ /**
6
+ * Direction of the streaming time axis. `left` and `right` are the supported
7
+ * XY layouts. `up` and `down` remain accepted for 3.x source compatibility
8
+ * and safely use the default rightward layout.
9
+ */
5
10
  export type ArrowOfTime = "up" | "down" | "left" | "right";
6
11
  export type WindowMode = "sliding" | "growing";
7
12
  export type ThresholdType = "greater" | "lesser";
@@ -10,6 +15,7 @@ export interface LineStyle {
10
15
  strokeWidth?: number;
11
16
  strokeDasharray?: string;
12
17
  opacity?: number;
18
+ cursor?: CSSProperties["cursor"];
13
19
  }
14
20
  /**
15
21
  * How an annotation's anchor is resolved across renders. Shared between
@@ -129,6 +135,7 @@ export interface BarStyle {
129
135
  strokeWidth?: number;
130
136
  opacity?: number;
131
137
  gap?: number;
138
+ cursor?: CSSProperties["cursor"];
132
139
  }
133
140
  export interface WaterfallStyle {
134
141
  positiveColor?: string;
@@ -139,6 +146,7 @@ export interface WaterfallStyle {
139
146
  stroke?: string;
140
147
  strokeWidth?: number;
141
148
  opacity?: number;
149
+ cursor?: CSSProperties["cursor"];
142
150
  }
143
151
  export interface SwarmStyle {
144
152
  radius?: number;
@@ -146,6 +154,7 @@ export interface SwarmStyle {
146
154
  opacity?: number;
147
155
  stroke?: string;
148
156
  strokeWidth?: number;
157
+ cursor?: CSSProperties["cursor"];
149
158
  }
150
159
  export interface RealtimeFrameProps {
151
160
  chartType?: "line" | "swarm" | "candlestick" | "waterfall" | "bar";
@@ -0,0 +1,42 @@
1
+ /**
2
+ * Convert two allocation snapshots into deterministic conserved flows.
3
+ *
4
+ * Values retained by the same identity are emitted first as `stay` flows.
5
+ * Residual values from shrinking identities are then assigned to growing
6
+ * identities in input order. The helper makes no claim that this is the only
7
+ * possible migration: it is a stable, transparent balancing policy for
8
+ * before/after Sankeys and allocation-transition explanations.
9
+ */
10
+ export interface BalancedSnapshotFlow {
11
+ sourceId: string;
12
+ targetId: string;
13
+ value: number;
14
+ kind: "stay" | "move";
15
+ }
16
+ export interface SnapshotResidual {
17
+ id: string;
18
+ value: number;
19
+ }
20
+ export interface BalancedSnapshotsResult {
21
+ flows: BalancedSnapshotFlow[];
22
+ beforeTotal: number;
23
+ afterTotal: number;
24
+ balanced: boolean;
25
+ unmatchedBefore: SnapshotResidual[];
26
+ unmatchedAfter: SnapshotResidual[];
27
+ }
28
+ export interface BalanceSnapshotsToFlowsOptions<TBefore, TAfter = TBefore> {
29
+ beforeId: (datum: TBefore, index: number) => string | number;
30
+ afterId?: (datum: TAfter, index: number) => string | number;
31
+ beforeValue: (datum: TBefore, index: number) => number;
32
+ afterValue?: (datum: TAfter, index: number) => number;
33
+ /** Floating-point comparison tolerance. Defaults to 1e-9. */
34
+ epsilon?: number;
35
+ /**
36
+ * Return unmatched residuals instead of throwing when totals differ.
37
+ * Conserved inputs are strict by default so a Sankey cannot silently lose
38
+ * or create volume.
39
+ */
40
+ allowImbalance?: boolean;
41
+ }
42
+ export declare function balanceSnapshotsToFlows<TBefore, TAfter = TBefore>(before: readonly TBefore[], after: readonly TAfter[], options: BalanceSnapshotsToFlowsOptions<TBefore, TAfter>): BalancedSnapshotsResult;
@@ -0,0 +1,14 @@
1
+ interface IdentifiedNode {
2
+ id: string;
3
+ }
4
+ interface DirectedEdge {
5
+ source: string;
6
+ target: string;
7
+ }
8
+ /** Build a successor map that follows source → target only. */
9
+ export declare function buildDirectedAdjacency(nodes: ReadonlyArray<IdentifiedNode>, edges: ReadonlyArray<DirectedEdge>): Map<string, Set<string>>;
10
+ /** Return nodes reachable from start by breadth-first traversal. */
11
+ export declare function reachableFrom(adjacency: Map<string, Set<string>>, start: string, options?: {
12
+ includeStart?: boolean;
13
+ }): Set<string>;
14
+ export {};
@@ -1,12 +1,12 @@
1
- import type { DisplayList } from "gofish-ir";
2
- type DisplayListDocument = DisplayList.DisplayListDocument;
1
+ import type { GofishDisplayListDocument } from "./gofishIR";
2
+ type DisplayListDocument = GofishDisplayListDocument;
3
3
  /**
4
- * Flower meadow — GoFish's real flower chart, verbatim: a meadow where each lake is a green stem (a bar whose height is the lake's total catch) topped by a polar fan of petals, one per species, sized by count. It is layer([stems, flowers]) — the flowers selectAll the stems and stack a polar petal fan on each. The composition's root is a combinator (no ChartBuilder.toDisplayList), so it is baked through GoFish's mark-resolution contract; see gofish-displaylist-findings.md.
4
+ * Flower meadow — GoFish's real flower chart, verbatim: a meadow where each lake is a green stem (a bar whose height is the lake's total catch) topped by a polar fan of petals, one per species, sized by count. It is layer([stems, flowers]) — the flowers selectAll the stems and stack a polar petal fan on each. The composition's root is a combinator (no ChartBuilder.toDisplayList), so it is baked through GoFish's mark-resolution contract.
5
5
  * Source: https://gofish.graphics/js/examples/flower-chart.html
6
6
  */
7
7
  export declare const flowerDisplayList: DisplayListDocument;
8
8
  /**
9
- * Polar ribbon chart — GoFish's polar ribbon chart, verbatim: the catch stacked radially per lake under a clock() projection, then a smooth area ribbon drawn across the lakes for each species (selectAll the bars, group by species). The wrap, the open gap, and the bumped ribbons are all baked into absolute-pixel paths; the radial bars keep their datum (hit targets), the ribbons are area chrome. Root is a layer({ coord: clock() }) combinator, baked through GoFish's mark-resolution contract — see gofish-displaylist-findings.md.
9
+ * Polar ribbon chart — GoFish's polar ribbon chart, verbatim: the catch stacked radially per lake under a clock() projection, then a smooth area ribbon drawn across the lakes for each species (selectAll the bars, group by species). The wrap, the open gap, and the bumped ribbons are all baked into absolute-pixel paths; the radial bars keep their datum (hit targets), the ribbons are area chrome. Root is a layer({ coord: clock() }) combinator, baked through GoFish's mark-resolution contract.
10
10
  * Source: https://gofish.graphics/js/examples/polar-ribbon-chart.html
11
11
  */
12
12
  export declare const polarribbonDisplayList: DisplayListDocument;
@@ -21,12 +21,12 @@ export declare const treemapDisplayList: DisplayListDocument;
21
21
  */
22
22
  export declare const bottleDisplayList: DisplayListDocument;
23
23
  /**
24
- * Python memory diagram — A Python Tutor runtime memory diagram: a Global Frame of variables (c, d → pointers; x = 5) whose arrows fan into a heap of tuples, with tuple cells pointing on to further tuples. NOTE: GoFish's own example is not a portable spec — it relies on ~250 lines of unpublished story helpers (globalFrame/heap/tuple/Arrow). This is a best-effort reconstruction from GoFish primitives only (rect/text/Arrow/ref + .name()). It is also vertically flipped vs the live example: a free-space Layer baked through toDisplayList orients y-down differently than .render() (GoFish issue #143/#16). See gofish-displaylist-findings.md §6.
24
+ * Python memory diagram — A Python Tutor runtime memory diagram: a Global Frame of variables (c, d → pointers; x = 5) whose arrows fan into a heap of tuples, with tuple cells pointing on to further tuples. NOTE: GoFish's own example is not a portable spec — it relies on ~250 lines of unpublished story helpers (globalFrame/heap/tuple/Arrow). This is a best-effort reconstruction from GoFish primitives only (rect/text/Arrow/ref + .name()). It is also vertically flipped vs the live example: a free-space Layer baked through toDisplayList orients y-down differently than .render() (GoFish issue #143/#16).
25
25
  * Source: https://gofish.graphics/js/examples/python-tutor-memory-diagram.html
26
26
  */
27
27
  export declare const pythonDisplayList: DisplayListDocument;
28
28
  export interface GofishDisplayListExample {
29
- key: "bars" | "flower" | "polarribbon" | "treemap" | "bottle" | "python";
29
+ key: "flower" | "polarribbon" | "treemap" | "bottle" | "python";
30
30
  label: string;
31
31
  source: string;
32
32
  blurb: string;
@@ -19,7 +19,7 @@ export type GridFuelKey = (typeof GRID_FUEL_KEYS)[number];
19
19
  export declare const GRID_FUEL_LABELS: Record<GridFuelKey, string>;
20
20
  /**
21
21
  * One hour (or finest grain) in one balancing authority.
22
- * Compatible with the strategy schema in docs/strategy/examples-thegrid.md.
22
+ * Fields are source-agnostic so callers can provide any compatible dataset.
23
23
  */
24
24
  export type GridHour = {
25
25
  t: number;