semiotic 3.8.9 → 3.9.1

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 (502) hide show
  1. package/README.md +55 -81
  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-utils.d.ts +1 -1
  220. package/dist/components/semiotic-xy.d.ts +4 -1
  221. package/dist/components/semiotic.d.ts +68 -26
  222. package/dist/components/server/animatedGif.d.ts +1 -1
  223. package/dist/components/server/renderEvidence.d.ts +25 -2
  224. package/dist/components/server/renderToStaticSVG.d.ts +15 -7
  225. package/dist/components/server/serverChartConfigShared.d.ts +8 -1
  226. package/dist/components/server/serverChartConfigs.d.ts +1 -0
  227. package/dist/components/server/serverChartConfigsNetwork.d.ts +3 -3
  228. package/dist/components/server/serverChartConfigsNetworkChord.d.ts +2 -0
  229. package/dist/components/server/serverChartConfigsNetworkForce.d.ts +2 -0
  230. package/dist/components/server/serverChartConfigsNetworkHierarchy.d.ts +3 -0
  231. package/dist/components/server/serverChartConfigsXY.d.ts +3 -3
  232. package/dist/components/server/serverChartConfigsXYBubble.d.ts +5 -0
  233. package/dist/components/server/serverChartConfigsXYBump.d.ts +7 -0
  234. package/dist/components/server/serverChartConfigsXYScatter.d.ts +5 -0
  235. package/dist/components/server/staticAnnotationFallbacks.d.ts +10 -0
  236. package/dist/components/server/staticAnnotations.d.ts +28 -1
  237. package/dist/components/server/staticAxisTickLabel.d.ts +13 -0
  238. package/dist/components/server/staticLegend.d.ts +1 -1
  239. package/dist/components/server/staticLegendMargin.d.ts +41 -0
  240. package/dist/components/server/staticOrdinal.d.ts +8 -2
  241. package/dist/components/server/staticPhysics.d.ts +13 -1
  242. package/dist/components/server/staticPhysicsChrome.d.ts +20 -0
  243. package/dist/components/server/staticRawLegend.d.ts +15 -0
  244. package/dist/components/server/staticSVGChrome.d.ts +16 -55
  245. package/dist/components/server/staticXYAxes.d.ts +27 -0
  246. package/dist/components/server/staticXYAxisTicks.d.ts +39 -0
  247. package/dist/components/server/staticXYGrid.d.ts +11 -0
  248. package/dist/components/server/themeResolver.d.ts +5 -1
  249. package/dist/components/store/ThemeStore.d.ts +2 -98
  250. package/dist/components/store/designTokens.d.ts +1 -1
  251. package/dist/components/store/themeCSSVariables.d.ts +10 -0
  252. package/dist/components/store/themeCore.d.ts +91 -0
  253. package/dist/components/store/themePresets.d.ts +81 -0
  254. package/dist/components/store/themeSerialization.d.ts +2 -1
  255. package/dist/components/stream/AccessibleDataTable.d.ts +12 -14
  256. package/dist/components/stream/AccessibleTablePortalImpl.d.ts +6 -0
  257. package/dist/components/stream/GeoTileRenderer.d.ts +2 -0
  258. package/dist/components/stream/NetworkCanvasHitTester.d.ts +3 -1
  259. package/dist/components/stream/NetworkSSRFrame.d.ts +2 -1
  260. package/dist/components/stream/NetworkSVGOverlay.d.ts +3 -31
  261. package/dist/components/stream/OrdinalCanvasHitTester.d.ts +2 -0
  262. package/dist/components/stream/SVGChartTitle.d.ts +9 -0
  263. package/dist/components/stream/SVGOverlay.d.ts +1 -21
  264. package/dist/components/stream/SVGUnderlay.d.ts +24 -0
  265. package/dist/components/stream/SceneToSVG.d.ts +1 -1
  266. package/dist/components/stream/StreamGeoFrame.d.ts +1 -1
  267. package/dist/components/stream/StreamOrdinalFrame.d.ts +1 -1
  268. package/dist/components/stream/StreamXYFrame.d.ts +1 -1
  269. package/dist/components/stream/accessibleDataRows.d.ts +11 -0
  270. package/dist/components/stream/accessibleDataTableModel.d.ts +40 -0
  271. package/dist/components/stream/accessibleTableTypes.d.ts +11 -0
  272. package/dist/components/stream/axisTickUtils.d.ts +19 -0
  273. package/dist/components/stream/canvasBackground.d.ts +10 -0
  274. package/dist/components/stream/canvasSetup.d.ts +9 -0
  275. package/dist/components/stream/frameCursorInteraction.d.ts +25 -0
  276. package/dist/components/stream/frameDefaultMargins.d.ts +37 -0
  277. package/dist/components/stream/frameGraphics.d.ts +18 -0
  278. package/dist/components/stream/frameGraphicsSubscription.d.ts +26 -0
  279. package/dist/components/stream/frameLegendOptions.d.ts +18 -0
  280. package/dist/components/stream/geoFrameCursorInteraction.d.ts +9 -0
  281. package/dist/components/stream/geoFrameHelpers.d.ts +29 -1
  282. package/dist/components/stream/geoTypes.d.ts +10 -11
  283. package/dist/components/stream/hitTarget.d.ts +61 -2
  284. package/dist/components/stream/moduleWorkerSession.d.ts +6 -0
  285. package/dist/components/stream/networkAnnotationAnchors.d.ts +37 -0
  286. package/dist/components/stream/networkCustomLayout.d.ts +2 -2
  287. package/dist/components/stream/networkFrameCursorInteraction.d.ts +12 -0
  288. package/dist/components/stream/networkFrameInteraction.d.ts +2 -0
  289. package/dist/components/stream/networkFramePaint.d.ts +7 -0
  290. package/dist/components/stream/networkPipelineConfig.d.ts +1 -1
  291. package/dist/components/stream/networkTypes.d.ts +30 -32
  292. package/dist/components/stream/normalizeXYData.d.ts +7 -0
  293. package/dist/components/stream/ordinalFrameCursorInteraction.d.ts +7 -0
  294. package/dist/components/stream/ordinalFrameInteraction.d.ts +29 -0
  295. package/dist/components/stream/ordinalSceneSVG.d.ts +10 -0
  296. package/dist/components/stream/ordinalTypes.d.ts +10 -4
  297. package/dist/components/stream/physics/PhysicsBodySpatialIndex.d.ts +9 -1
  298. package/dist/components/stream/physics/PhysicsCanvasTheme.d.ts +25 -0
  299. package/dist/components/stream/physics/PhysicsControllers.d.ts +0 -3
  300. package/dist/components/stream/physics/PhysicsPipelineStore.d.ts +4 -1
  301. package/dist/components/stream/physics/PhysicsSVGOverlay.d.ts +3 -24
  302. package/dist/components/stream/physics/PhysicsSettledSVG.d.ts +9 -21
  303. package/dist/components/stream/physics/PhysicsSettledSVGElement.d.ts +37 -0
  304. package/dist/components/stream/physics/PhysicsSettledScene.d.ts +7 -3
  305. package/dist/components/stream/physics/StreamPhysicsFrame.d.ts +1 -1
  306. package/dist/components/stream/physics/StreamPhysicsTypes.d.ts +23 -4
  307. package/dist/components/stream/physics/physicsAnnotationContext.d.ts +19 -0
  308. package/dist/components/stream/physics/physicsBodyCanvas.d.ts +4 -0
  309. package/dist/components/stream/physics/physicsSettledChrome.d.ts +7 -0
  310. package/dist/components/stream/physics/usePhysicsCanvasPointer.d.ts +32 -0
  311. package/dist/components/stream/physics/usePhysicsSemanticNavigation.d.ts +36 -0
  312. package/dist/components/stream/pipelineConfig.d.ts +6 -17
  313. package/dist/components/stream/pipelineDomainResolution.d.ts +1 -1
  314. package/dist/components/stream/renderBackend.d.ts +2 -0
  315. package/dist/components/stream/renderers/canvasRenderHelpers.d.ts +13 -2
  316. package/dist/components/stream/renderers/resolveCSSColor.d.ts +7 -0
  317. package/dist/components/stream/responsiveSize.d.ts +17 -0
  318. package/dist/components/stream/sceneCursor.d.ts +41 -0
  319. package/dist/components/stream/sceneRevisionDiagnostics.d.ts +1 -1
  320. package/dist/components/stream/svgOverlayUtils.d.ts +22 -1
  321. package/dist/components/stream/types.d.ts +25 -12
  322. package/dist/components/stream/useCanvasFrameHost.d.ts +3 -1
  323. package/dist/components/stream/useFrame.d.ts +24 -1
  324. package/dist/components/stream/useResponsiveSize.d.ts +6 -1
  325. package/dist/components/stream/useStalenessCheck.d.ts +1 -1
  326. package/dist/components/stream/xyFrameAxisTypes.d.ts +15 -4
  327. package/dist/components/stream/xyFrameCursorInteraction.d.ts +6 -0
  328. package/dist/components/stream/xySceneBuilders/swarmScene.d.ts +1 -1
  329. package/dist/components/stream/xySceneBuilders/types.d.ts +6 -26
  330. package/dist/components/types/legendTypes.d.ts +6 -0
  331. package/dist/components/types/marginType.d.ts +7 -8
  332. package/dist/controls.min.js +1 -1
  333. package/dist/controls.module.min.js +1 -1
  334. package/dist/forceLayoutWorker.js +1 -1
  335. package/dist/geo.min.js +1 -1
  336. package/dist/geo.module.min.js +1 -1
  337. package/dist/network.min.js +1 -1
  338. package/dist/network.module.min.js +1 -1
  339. package/dist/ordinal.min.js +1 -1
  340. package/dist/ordinal.module.min.js +1 -1
  341. package/dist/physics-matter.module.min.js +1 -1
  342. package/dist/physics-rapier.module.min.js +1 -1
  343. package/dist/physics.min.js +1 -1
  344. package/dist/physics.module.min.js +1 -1
  345. package/dist/physicsWorker.js +1 -1
  346. package/dist/processSankeyLayoutWorker.js +1 -1
  347. package/dist/realtime.min.js +1 -1
  348. package/dist/realtime.module.min.js +1 -1
  349. package/dist/rough.min.js +1 -1
  350. package/dist/rough.module.min.js +1 -1
  351. package/dist/semiotic-ai-core.d.ts +13 -4
  352. package/dist/semiotic-ai-core.min.js +1 -1
  353. package/dist/semiotic-ai-core.module.min.js +1 -1
  354. package/dist/semiotic-ai.d.ts +16 -9
  355. package/dist/semiotic-ai.min.js +1 -1
  356. package/dist/semiotic-ai.module.min.js +1 -1
  357. package/dist/semiotic-client-cjs-shared.min.js +1 -0
  358. package/dist/semiotic-client-glyph.module.min.js +2 -0
  359. package/dist/semiotic-client-responsive.module.min.js +2 -0
  360. package/dist/semiotic-client-shared.module.min.js +2 -0
  361. package/dist/semiotic-custom-layout-selection-cjs-shared.min.js +2 -0
  362. package/dist/semiotic-data.min.js +1 -1
  363. package/dist/semiotic-data.module.min.js +1 -1
  364. package/dist/semiotic-experimental-auxiliary.module.min.js +2 -0
  365. package/dist/semiotic-experimental-node-auxiliary.module.min.js +2 -0
  366. package/dist/semiotic-experimental-node.module.min.js +2 -0
  367. package/dist/semiotic-experimental-react-shared.module.min.js +2 -0
  368. package/dist/semiotic-experimental-vacp.min.js +1 -1
  369. package/dist/semiotic-experimental-vacp.module.min.js +1 -1
  370. package/dist/semiotic-experimental.d.ts +1 -1
  371. package/dist/semiotic-experimental.min.js +1 -1
  372. package/dist/semiotic-experimental.module.min.js +1 -1
  373. package/dist/semiotic-geo.d.ts +4 -1
  374. package/dist/semiotic-network.d.ts +7 -4
  375. package/dist/semiotic-ordinal.d.ts +4 -1
  376. package/dist/semiotic-physics.d.ts +11 -4
  377. package/dist/semiotic-realtime-core.d.ts +11 -4
  378. package/dist/semiotic-realtime-core.min.js +2 -1
  379. package/dist/semiotic-realtime-core.module.min.js +2 -1
  380. package/dist/semiotic-realtime-react.d.ts +4 -3
  381. package/dist/semiotic-realtime-react.min.js +1 -1
  382. package/dist/semiotic-realtime-react.module.min.js +1 -1
  383. package/dist/semiotic-realtime.d.ts +3 -1
  384. package/dist/semiotic-recipes-core-cjs-base.min.js +1 -0
  385. package/dist/semiotic-recipes-core.d.ts +7 -5
  386. package/dist/semiotic-recipes-core.min.js +9 -1
  387. package/dist/semiotic-recipes-core.module.min.js +1 -1
  388. package/dist/semiotic-recipes-geo-cjs.min.js +1 -0
  389. package/dist/semiotic-recipes-react.min.js +1 -1
  390. package/dist/semiotic-recipes-react.module.min.js +1 -1
  391. package/dist/semiotic-recipes.min.js +7 -1
  392. package/dist/semiotic-recipes.module.min.js +2 -1
  393. package/dist/semiotic-server-edge-node.module.min.js +1 -0
  394. package/dist/semiotic-server-edge.d.ts +3 -2
  395. package/dist/semiotic-server-edge.min.js +1 -1
  396. package/dist/semiotic-server-edge.module.min.js +1 -1
  397. package/dist/semiotic-server-node.min.js +1 -1
  398. package/dist/semiotic-server-node.module.min.js +1 -1
  399. package/dist/semiotic-server.d.ts +3 -2
  400. package/dist/semiotic-themes-core.d.ts +5 -48
  401. package/dist/semiotic-themes-core.min.js +1 -1
  402. package/dist/semiotic-themes-core.module.min.js +1 -1
  403. package/dist/semiotic-themes-react.min.js +1 -1
  404. package/dist/semiotic-themes-react.module.min.js +1 -1
  405. package/dist/semiotic-themes.min.js +1 -1
  406. package/dist/semiotic-themes.module.min.js +1 -1
  407. package/dist/semiotic-utils-core.d.ts +10 -5
  408. package/dist/semiotic-utils-core.min.js +1 -1
  409. package/dist/semiotic-utils-core.module.min.js +1 -1
  410. package/dist/semiotic-utils-react.d.ts +2 -0
  411. package/dist/semiotic-utils-react.min.js +1 -1
  412. package/dist/semiotic-utils-react.module.min.js +1 -1
  413. package/dist/semiotic-utils.d.ts +1 -1
  414. package/dist/semiotic-utils.min.js +2 -1
  415. package/dist/semiotic-utils.module.min.js +2 -1
  416. package/dist/semiotic-value.min.js +1 -1
  417. package/dist/semiotic-value.module.min.js +1 -1
  418. package/dist/semiotic-xy.d.ts +4 -1
  419. package/dist/semiotic.d.ts +68 -26
  420. package/dist/semiotic.min.js +1 -1
  421. package/dist/semiotic.module.min.js +1 -1
  422. package/dist/server.min.js +1 -1
  423. package/dist/server.module.min.js +1 -1
  424. package/dist/xy.min.js +1 -1
  425. package/dist/xy.module.min.js +1 -1
  426. package/package.json +53 -19
  427. package/dist/__tests__/scenarios/mcpProtocolTypes.d.ts +0 -20
  428. package/dist/chunk-OrdinalBrushOverlay-PXHQYDB2.module.min.js +0 -2
  429. package/dist/chunk-XYBrushOverlay-ECZJJLAJ.module.min.js +0 -1
  430. package/dist/chunk-XYBrushOverlay-EP2SV3UI.module.min.js +0 -2
  431. package/dist/chunk-chartContainerDataAudit-IQ3NBN3Q.module.min.js +0 -2
  432. package/dist/chunk-chunk-2B3AIKUZ.module.min.js +0 -2
  433. package/dist/chunk-chunk-2CXCXRB4.module.min.js +0 -1
  434. package/dist/chunk-chunk-2X3FJCME.module.min.js +0 -1
  435. package/dist/chunk-chunk-2ZHHWZQM.module.min.js +0 -2
  436. package/dist/chunk-chunk-4ITOQRXM.module.min.js +0 -2
  437. package/dist/chunk-chunk-5UKL5W76.module.min.js +0 -2
  438. package/dist/chunk-chunk-5VVNW5AZ.module.min.js +0 -1
  439. package/dist/chunk-chunk-5ZON5NMV.module.min.js +0 -2
  440. package/dist/chunk-chunk-66PCWJUG.module.min.js +0 -1
  441. package/dist/chunk-chunk-6S3YGYW7.module.min.js +0 -1
  442. package/dist/chunk-chunk-6V5VQVCT.module.min.js +0 -2
  443. package/dist/chunk-chunk-7C5EDZ3Z.module.min.js +0 -2
  444. package/dist/chunk-chunk-A3I4HBD5.module.min.js +0 -1
  445. package/dist/chunk-chunk-ACLDBMRH.module.min.js +0 -2
  446. package/dist/chunk-chunk-AFQHURLO.module.min.js +0 -2
  447. package/dist/chunk-chunk-DDB4TLQG.module.min.js +0 -2
  448. package/dist/chunk-chunk-DTH3SUOU.module.min.js +0 -2
  449. package/dist/chunk-chunk-DTSNLGRK.module.min.js +0 -2
  450. package/dist/chunk-chunk-DVCWU7MT.module.min.js +0 -2
  451. package/dist/chunk-chunk-FEPXDKJP.module.min.js +0 -1
  452. package/dist/chunk-chunk-FJ76HWQZ.module.min.js +0 -1
  453. package/dist/chunk-chunk-FSIHAW6L.module.min.js +0 -2
  454. package/dist/chunk-chunk-G2RGVEYY.module.min.js +0 -2
  455. package/dist/chunk-chunk-G75OPF5N.module.min.js +0 -2
  456. package/dist/chunk-chunk-HADHLMY5.module.min.js +0 -1
  457. package/dist/chunk-chunk-HAJVODLO.module.min.js +0 -2
  458. package/dist/chunk-chunk-HBFA4NN6.module.min.js +0 -1
  459. package/dist/chunk-chunk-HIV7AW2V.module.min.js +0 -2
  460. package/dist/chunk-chunk-IY7RYD4S.module.min.js +0 -1
  461. package/dist/chunk-chunk-J3QOW4OE.module.min.js +0 -0
  462. package/dist/chunk-chunk-J3XWETBJ.module.min.js +0 -2
  463. package/dist/chunk-chunk-JZAMMSQQ.module.min.js +0 -2
  464. package/dist/chunk-chunk-KTWEBFMX.module.min.js +0 -2
  465. package/dist/chunk-chunk-LSJUXBMF.module.min.js +0 -1
  466. package/dist/chunk-chunk-MXMRXSCI.module.min.js +0 -2
  467. package/dist/chunk-chunk-MXVBXFKW.module.min.js +0 -2
  468. package/dist/chunk-chunk-NWIGA3UK.module.min.js +0 -1
  469. package/dist/chunk-chunk-OFAP623Y.module.min.js +0 -2
  470. package/dist/chunk-chunk-OHLRAEQZ.module.min.js +0 -2
  471. package/dist/chunk-chunk-OZK46A5U.module.min.js +0 -1
  472. package/dist/chunk-chunk-PMR47KRY.module.min.js +0 -2
  473. package/dist/chunk-chunk-PRNXOCYZ.module.min.js +0 -2
  474. package/dist/chunk-chunk-Q2YADC2V.module.min.js +0 -2
  475. package/dist/chunk-chunk-RLKZVJMQ.module.min.js +0 -2
  476. package/dist/chunk-chunk-ROP4HI7H.module.min.js +0 -2
  477. package/dist/chunk-chunk-SK2TQMG4.module.min.js +0 -2
  478. package/dist/chunk-chunk-SKLYXNYW.module.min.js +0 -2
  479. package/dist/chunk-chunk-TCMHJWFJ.module.min.js +0 -1
  480. package/dist/chunk-chunk-TSCFL235.module.min.js +0 -1
  481. package/dist/chunk-chunk-U4NZCU5T.module.min.js +0 -2
  482. package/dist/chunk-chunk-U66USBWU.module.min.js +0 -1
  483. package/dist/chunk-chunk-UOQRPGPK.module.min.js +0 -2
  484. package/dist/chunk-chunk-VKL6DI43.module.min.js +0 -2
  485. package/dist/chunk-chunk-W62673ZE.module.min.js +0 -1
  486. package/dist/chunk-chunk-WFHZHWT7.module.min.js +0 -1
  487. package/dist/chunk-chunk-XCC25CZZ.module.min.js +0 -2
  488. package/dist/chunk-chunk-XECNOUZY.module.min.js +0 -2
  489. package/dist/chunk-chunk-XYZDTYAF.module.min.js +0 -2
  490. package/dist/chunk-chunk-YHNZCPOZ.module.min.js +0 -2
  491. package/dist/chunk-chunk-YWZB3KPI.module.min.js +0 -2
  492. package/dist/chunk-statisticalOverlays-HMYYSGPE.module.min.js +0 -2
  493. package/dist/components/stream/test-utils/frameScheduler.d.ts +0 -12
  494. package/dist/components/stream/test-utils/revisionConsumption.d.ts +0 -13
  495. package/dist/test-utils/canvasMock.d.ts +0 -86
  496. package/dist/test-utils/capturedFrameProps.d.ts +0 -67
  497. package/dist/test-utils/frameMock.d.ts +0 -81
  498. package/dist/test-utils/ordinalFixtures.d.ts +0 -48
  499. /package/dist/{chunk-chunk-JJ2OOIET.module.min.js → c-GGISSW5E.min.js} +0 -0
  500. /package/dist/{chunk-chunk-SIRIJ3DY.module.min.js → c-N4G2L7ID.min.js} +0 -0
  501. /package/dist/{chunk-chunk-CA3YDW6F.module.min.js → c-S6U5CGT5.min.js} +0 -0
  502. /package/dist/components/recipes/{mobileAnnotationStrategy.d.ts → mobileAnnotationBehavior.d.ts} +0 -0
@@ -5,6 +5,7 @@ import { type TooltipProp } from "../../Tooltip/Tooltip";
5
5
  import type { Datum } from "../shared/datumTypes";
6
6
  import type { BaseChartProps, ChartMode, LinkedHoverProp, SelectionConfig } from "../shared/types";
7
7
  import { type ChartModeResult } from "../shared/hooks";
8
+ export { physicsMarginForMode } from "./physicsChartLayout";
8
9
  export type PhysicsHocFrameProps<TOmitted extends keyof StreamPhysicsFrameProps = never> = Partial<Omit<StreamPhysicsFrameProps, "initialSpawns" | "initialSpawnPacing" | "size" | TOmitted>>;
9
10
  /**
10
11
  * Chrome / AI / annotation contracts HOCs forward to StreamPhysicsFrame.
@@ -86,13 +87,6 @@ export declare function resolvePhysicsModes(options: {
86
87
  chartMode: ChartMode | undefined;
87
88
  simulationMode: PhysicsSimulationMode;
88
89
  };
89
- /** Physics fills its box; only compact ChartModes get non-zero chrome padding. */
90
- export declare function physicsMarginForMode(compactMode: boolean, mode?: ChartMode): {
91
- top: number;
92
- right: number;
93
- bottom: number;
94
- left: number;
95
- };
96
90
  export declare function resolvePhysicsChartSize(size: [number, number] | undefined, width: number | undefined, height: number | undefined, fallback: [number, number]): [number, number];
97
91
  export type PhysicsChartModeProps = {
98
92
  width?: number;
@@ -100,7 +94,7 @@ export type PhysicsChartModeProps = {
100
94
  title?: string;
101
95
  description?: string;
102
96
  summary?: string;
103
- accessibleTable?: boolean;
97
+ accessibleTable?: BaseChartProps["accessibleTable"];
104
98
  /** Frame-level hover; HOCs may pass via tooltip or frameProps. */
105
99
  enableHover?: boolean;
106
100
  mobileInteraction?: BaseChartProps["mobileInteraction"];
@@ -109,6 +103,8 @@ export type PhysicsChartModeProps = {
109
103
  mode?: ChartMode | PhysicsSimulationMode;
110
104
  simulationMode?: PhysicsSimulationMode;
111
105
  size?: [number, number];
106
+ responsiveWidth?: boolean;
107
+ responsiveHeight?: boolean;
112
108
  showProjection?: boolean;
113
109
  showChrome?: boolean;
114
110
  tooltip?: TooltipProp;
@@ -119,6 +115,9 @@ export interface PhysicsChartModeResult {
119
115
  simulationMode: PhysicsSimulationMode;
120
116
  resolved: ChartModeResult;
121
117
  chartSize: [number, number];
118
+ responsiveContainerRef: React.RefObject<HTMLDivElement | null>;
119
+ responsiveWidth: boolean;
120
+ responsiveHeight: boolean;
122
121
  margin: {
123
122
  top: number;
124
123
  right: number;
@@ -131,7 +130,7 @@ export interface PhysicsChartModeResult {
131
130
  title: string | undefined;
132
131
  description: string | undefined;
133
132
  summary: string | undefined;
134
- accessibleTable: boolean | undefined;
133
+ accessibleTable: BaseChartProps["accessibleTable"];
135
134
  className: string | undefined;
136
135
  compactMode: boolean;
137
136
  mobileInteraction: ChartModeResult["mobileInteraction"];
@@ -145,6 +144,18 @@ export interface PhysicsChartModeResult {
145
144
  export declare function usePhysicsChartMode(props: PhysicsChartModeProps, primaryFallback: [number, number], options?: {
146
145
  hasSimulationMode?: boolean;
147
146
  }): PhysicsChartModeResult;
147
+ export interface PhysicsResponsiveSizeResult {
148
+ containerRef: React.RefObject<HTMLDivElement | null>;
149
+ size: [number, number];
150
+ responsiveWidth: boolean;
151
+ responsiveHeight: boolean;
152
+ }
153
+ /**
154
+ * Measure the host that owns a physics layout. Stock Physics HOCs use the
155
+ * resolved dimensions to rebuild bodies, colliders, projections, and chrome
156
+ * together instead of resizing only the child canvas.
157
+ */
158
+ export declare function usePhysicsResponsiveSize(baseSize: [number, number], responsiveWidth?: boolean, responsiveHeight?: boolean): PhysicsResponsiveSizeResult;
148
159
  export declare function renderPhysicsChartState<TDatum extends Datum>(options: {
149
160
  data?: TDatum[] | null;
150
161
  emptyContent?: BaseChartProps["emptyContent"];
@@ -152,9 +163,11 @@ export declare function renderPhysicsChartState<TDatum extends Datum>(options: {
152
163
  loadingContent?: BaseChartProps["loadingContent"];
153
164
  size: [number, number];
154
165
  }): React.ReactElement | null;
155
- export declare function renderPhysicsFrame(componentName: string, size: [number, number], children: React.ReactNode): React.ReactElement;
166
+ export declare function renderPhysicsFrame(componentName: string, size: [number, number], children: React.ReactNode, responsiveLayout?: Pick<PhysicsChartModeResult, "responsiveContainerRef" | "responsiveHeight" | "responsiveWidth">): React.ReactElement;
156
167
  export declare function composePhysicsFrameGraphics(first: FrameGraphicsProp | undefined, second: FrameGraphicsProp | undefined): FrameGraphicsProp | undefined;
157
- export declare function resolvePhysicsTooltipProps(tooltip: TooltipProp | undefined, frameProps?: Partial<StreamPhysicsFrameProps>): Pick<StreamPhysicsFrameProps, "enableHover" | "tooltipContent">;
168
+ export declare function resolvePhysicsTooltipProps(tooltip: TooltipProp | undefined, frameProps?: Partial<StreamPhysicsFrameProps>, options?: {
169
+ unwrapSourceDatum?: boolean;
170
+ }): Pick<StreamPhysicsFrameProps, "enableHover" | "tooltipContent">;
158
171
  /**
159
172
  * HOC → StreamPhysicsFrame shared Semiotic contracts: a11y, observation,
160
173
  * click, chrome (title/legend/annotations), primitive styling, emphasis.
@@ -176,7 +189,7 @@ export declare function resolvePhysicsFrameSharedProps(props: Pick<BaseChartProp
176
189
  title?: string;
177
190
  description?: string;
178
191
  summary?: string;
179
- accessibleTable?: boolean;
192
+ accessibleTable?: BaseChartProps["accessibleTable"];
180
193
  enableHover?: boolean;
181
194
  margin?: StreamPhysicsFrameProps["margin"];
182
195
  }): Partial<StreamPhysicsFrameProps>;
@@ -0,0 +1,24 @@
1
+ import * as React from "react";
2
+ import type { StreamPhysicsFrameProps } from "../../stream/physics/StreamPhysicsTypes";
3
+ import { type CollisionSwarmProjectionMetadata, type EventDropProjectionMetadata, type GaltonBoardProjectionMetadata } from "./physicsChartUtils";
4
+ type ValueProjectionRow = {
5
+ label: string;
6
+ value: number;
7
+ };
8
+ type EventProjectionRow = ValueProjectionRow & {
9
+ secondary?: number;
10
+ };
11
+ export interface GaltonBoardReferenceLine {
12
+ value: number;
13
+ label?: React.ReactNode;
14
+ color?: string;
15
+ className?: string;
16
+ strokeDasharray?: string;
17
+ strokeWidth?: number;
18
+ labelPosition?: "top" | "bottom";
19
+ }
20
+ export declare function galtonBoardOverlay(rows: ValueProjectionRow[], bins: number, enabled: boolean | undefined, metadata: GaltonBoardProjectionMetadata | undefined, referenceLines: GaltonBoardReferenceLine | GaltonBoardReferenceLine[] | undefined): StreamPhysicsFrameProps["foregroundGraphics"] | undefined;
21
+ export declare function eventDropOverlay(rows: EventProjectionRow[], metadata: EventDropProjectionMetadata | undefined, enabled: boolean | undefined): StreamPhysicsFrameProps["foregroundGraphics"] | undefined;
22
+ export declare function pileProjectionOverlay(rows: ValueProjectionRow[], ballRadius: number, enabled: boolean | undefined): StreamPhysicsFrameProps["foregroundGraphics"] | undefined;
23
+ export declare function collisionSwarmProjectionOverlay(metadata: CollisionSwarmProjectionMetadata | undefined, enabled: boolean | undefined): StreamPhysicsFrameProps["foregroundGraphics"] | undefined;
24
+ export {};
@@ -0,0 +1,9 @@
1
+ import type { CapacityQueueSnapshot } from "../../stream/physics/PhysicsControllers";
2
+ import type { StreamPhysicsFrameProps } from "../../stream/physics/StreamPhysicsTypes";
3
+ import { type ProcessChromeOptions } from "../../recipes/processChrome";
4
+ import { type ProcessFlowProjectionMetadata } from "./physicsChartUtils";
5
+ export declare function processFlowChrome(metadata: ProcessFlowProjectionMetadata | undefined, enabled: boolean | undefined, capacityByRegion?: Record<string, CapacityQueueSnapshot>, chromeOptions?: ProcessChromeOptions): StreamPhysicsFrameProps["backgroundGraphics"] | undefined;
6
+ export declare function processFlowProjectionOverlay(rows: Array<{
7
+ label: string;
8
+ value: number;
9
+ }>, metadata: ProcessFlowProjectionMetadata | undefined, enabled: boolean | undefined): StreamPhysicsFrameProps["foregroundGraphics"] | undefined;
@@ -1,7 +1,7 @@
1
1
  import * as React from "react";
2
2
  import type { ArrowOfTime, WindowMode, HoverAnnotationConfig, HoverData, AnnotationContext, DecayConfig, PulseConfig, StalenessConfig } from "../../stream/types";
3
3
  import type { RealtimeFrameHandle } from "../../realtime/types";
4
- import type { ReactNode } from "react";
4
+ import type { CSSProperties, ReactNode } from "react";
5
5
  import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
6
6
  import type { ChartMode, ChartAccessor, SelectionConfig, MobileInteractionProp } from "../shared/types";
7
7
  import type { OnObservationCallback } from "../../store/ObservationStore";
@@ -9,7 +9,9 @@ import type { Datum } from "../shared/datumTypes";
9
9
  import type { AutoPlaceAnnotations } from "../../recipes/annotationLayout";
10
10
  import type { MobileVisualizationContract } from "../shared/auditMobileVisualization";
11
11
  import type { ResponsiveRule } from "../shared/responsiveRules";
12
- export interface RealtimeHeatmapProps<TDatum extends Datum = Datum> {
12
+ import type { RealtimeAccessibilityProps, RealtimeData, RealtimePointIdAccessor, RealtimeTooltipProp } from "./realtimeChartTypes";
13
+ import type { PartialMargin } from "../../types/marginType";
14
+ export interface RealtimeHeatmapProps<TDatum extends Datum = Datum> extends RealtimeAccessibilityProps {
13
15
  /** Display mode: "primary" (full chrome), "context" (compact), "sparkline" (inline) */
14
16
  mode?: ChartMode;
15
17
  /** Semantic responsive transformations applied before chart-mode defaults. */
@@ -27,12 +29,7 @@ export interface RealtimeHeatmapProps<TDatum extends Datum = Datum> {
27
29
  /** Maximum canvas backing-store DPR; defaults to the environment cap. */
28
30
  maxDevicePixelRatio?: number;
29
31
  /** Chart margins */
30
- margin?: {
31
- top?: number;
32
- right?: number;
33
- bottom?: number;
34
- left?: number;
35
- };
32
+ margin?: PartialMargin;
36
33
  /** CSS class name */
37
34
  className?: string;
38
35
  onObservation?: OnObservationCallback;
@@ -44,7 +41,7 @@ export interface RealtimeHeatmapProps<TDatum extends Datum = Datum> {
44
41
  /** Ring buffer capacity */
45
42
  windowSize?: number;
46
43
  /** Controlled data array */
47
- data?: Datum[];
44
+ data?: RealtimeData<TDatum>;
48
45
  /** Time/x value accessor */
49
46
  timeAccessor?: ChartAccessor<TDatum, number>;
50
47
  /** Value/y accessor */
@@ -63,6 +60,12 @@ export interface RealtimeHeatmapProps<TDatum extends Datum = Datum> {
63
60
  heatmapYBins?: number;
64
61
  /** Aggregation mode: "count", "sum", or "mean" (default: "count") */
65
62
  aggregation?: "count" | "sum" | "mean";
63
+ /** Sequential color scheme for aggregated cell values. */
64
+ colorScheme?: "blues" | "reds" | "greens" | "viridis" | "oranges" | "purples" | "greys" | "plasma" | "inferno" | "magma" | "cividis" | "turbo" | "custom" | (string & {});
65
+ /** Custom value-to-color function used when colorScheme is "custom". */
66
+ customColorScale?: (value: number) => string;
67
+ /** Presentation-only CSS cursor for retained marks; does not add click, keyboard, or observation behavior. */
68
+ cursor?: CSSProperties["cursor"];
66
69
  /** Show canvas-drawn axes */
67
70
  showAxes?: boolean;
68
71
  /** Background fill color */
@@ -89,8 +92,8 @@ export interface RealtimeHeatmapProps<TDatum extends Datum = Datum> {
89
92
  pulse?: PulseConfig;
90
93
  /** Frame-level data liveness indicator */
91
94
  staleness?: StalenessConfig;
92
- /** Custom tooltip renderer (alias for tooltipContent) */
93
- tooltip?: (d: HoverData) => ReactNode;
95
+ /** Declarative tooltip config or the legacy full-HoverData callback. */
96
+ tooltip?: RealtimeTooltipProp;
94
97
  /** Enable linked hover selection events for cross-chart highlighting */
95
98
  linkedHover?: boolean | string | {
96
99
  name?: string;
@@ -113,7 +116,7 @@ export interface RealtimeHeatmapProps<TDatum extends Datum = Datum> {
113
116
  /** Legend interaction mode */
114
117
  legendInteraction?: LegendInteractionMode;
115
118
  /** ID accessor for remove()/update() on the push API */
116
- pointIdAccessor?: string | ((d: Datum) => string);
119
+ pointIdAccessor?: RealtimePointIdAccessor<TDatum>;
117
120
  }
118
121
  /**
119
122
  * RealtimeHeatmap - Streaming heatmap with 2D grid binning.
@@ -1,7 +1,7 @@
1
1
  import * as React from "react";
2
2
  import type { ArrowOfTime, WindowMode, HoverAnnotationConfig, HoverData, AnnotationContext, DecayConfig, PulseConfig, StalenessConfig, TransitionConfig } from "../../stream/types";
3
3
  import type { RealtimeFrameHandle } from "../../realtime/types";
4
- import type { ReactNode } from "react";
4
+ import type { CSSProperties, ReactNode } from "react";
5
5
  import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
6
6
  import type { ChartMode, ChartAccessor, SelectionConfig, MobileInteractionProp } from "../shared/types";
7
7
  import type { OnObservationCallback } from "../../store/ObservationStore";
@@ -11,8 +11,9 @@ import type { MobileVisualizationContract } from "../shared/auditMobileVisualiza
11
11
  import type { ResponsiveRule } from "../shared/responsiveRules";
12
12
  import type { LegendValue } from "../../types/legendTypes";
13
13
  import type { PartialMargin } from "../../types/marginType";
14
+ import type { RealtimeAccessibilityProps, RealtimeData, RealtimePointIdAccessor, RealtimeTooltipProp } from "./realtimeChartTypes";
14
15
  export type RealtimeHistogramDirection = "up" | "down";
15
- export interface RealtimeHistogramProps<TDatum extends Datum = Datum> {
16
+ export interface RealtimeHistogramProps<TDatum extends Datum = Datum> extends RealtimeAccessibilityProps {
16
17
  /** Display mode: "primary" (full chrome), "context" (compact), "sparkline" (inline) */
17
18
  mode?: ChartMode;
18
19
  /** Semantic responsive transformations applied before chart-mode defaults. */
@@ -44,7 +45,7 @@ export interface RealtimeHistogramProps<TDatum extends Datum = Datum> {
44
45
  /** Ring buffer capacity */
45
46
  windowSize?: number;
46
47
  /** Controlled data array */
47
- data?: Datum[];
48
+ data?: RealtimeData<TDatum>;
48
49
  /** Time value accessor */
49
50
  timeAccessor?: ChartAccessor<TDatum, number>;
50
51
  /** Value accessor */
@@ -73,7 +74,7 @@ export interface RealtimeHistogramProps<TDatum extends Datum = Datum> {
73
74
  * Keys also determine stack order (listed keys first, then alphabetical).
74
75
  */
75
76
  colors?: Record<string, string>;
76
- /** Bar fill color (non-stacked mode) */
77
+ /** Bar fill color, or fallback for categories missing from `colors`. */
77
78
  fill?: string;
78
79
  /** Bar stroke color */
79
80
  stroke?: string;
@@ -81,6 +82,8 @@ export interface RealtimeHistogramProps<TDatum extends Datum = Datum> {
81
82
  strokeWidth?: number;
82
83
  /** Uniform bar opacity (0–1). Pairs with `color` / `stroke` / `strokeWidth` for the designer-facing primitive vocabulary. */
83
84
  opacity?: number;
85
+ /** Presentation-only CSS cursor for retained marks; does not add click, keyboard, or observation behavior. */
86
+ cursor?: CSSProperties["cursor"];
84
87
  /** Gap between bars in pixels */
85
88
  gap?: number;
86
89
  /** Show canvas-drawn axes */
@@ -103,8 +106,8 @@ export interface RealtimeHistogramProps<TDatum extends Datum = Datum> {
103
106
  tickFormatTime?: (value: number) => string;
104
107
  /** Custom formatter for value axis ticks */
105
108
  tickFormatValue?: (value: number) => string;
106
- /** Custom tooltip renderer (alias for tooltipContent) */
107
- tooltip?: (d: HoverData) => ReactNode;
109
+ /** Declarative tooltip config or the legacy full-HoverData callback. */
110
+ tooltip?: RealtimeTooltipProp;
108
111
  /** Enable linked hover selection events for cross-chart highlighting */
109
112
  linkedHover?: boolean | string | {
110
113
  name?: string;
@@ -157,7 +160,7 @@ export interface RealtimeHistogramProps<TDatum extends Datum = Datum> {
157
160
  /** Legend interaction mode */
158
161
  legendInteraction?: LegendInteractionMode;
159
162
  /** ID accessor for remove()/update() on the push API */
160
- pointIdAccessor?: string | ((d: Datum) => string);
163
+ pointIdAccessor?: RealtimePointIdAccessor<TDatum>;
161
164
  }
162
165
  /**
163
166
  * RealtimeHistogram - Streaming temporal histogram.
@@ -1,7 +1,7 @@
1
1
  import * as React from "react";
2
2
  import type { ArrowOfTime, WindowMode, HoverAnnotationConfig, HoverData, AnnotationContext, DecayConfig, PulseConfig, StalenessConfig, TransitionConfig } from "../../stream/types";
3
3
  import type { RealtimeFrameHandle } from "../../realtime/types";
4
- import type { ReactNode } from "react";
4
+ import type { CSSProperties, ReactNode } from "react";
5
5
  import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
6
6
  import type { ChartMode, ChartAccessor, SelectionConfig, MobileInteractionProp } from "../shared/types";
7
7
  import type { OnObservationCallback } from "../../store/ObservationStore";
@@ -11,7 +11,23 @@ import type { MobileVisualizationContract } from "../shared/auditMobileVisualiza
11
11
  import type { ResponsiveRule } from "../shared/responsiveRules";
12
12
  import { type AggregateConfig } from "./aggregate";
13
13
  import { type EventTimeConfig } from "./eventTime";
14
- export interface RealtimeLineChartProps<TDatum extends Datum = Datum> {
14
+ import type { RealtimeAccessibilityProps, RealtimeData, RealtimePointIdAccessor, RealtimeTooltipProp } from "./realtimeChartTypes";
15
+ import type { PartialMargin } from "../../types/marginType";
16
+ /**
17
+ * Imperative handle for RealtimeLineChart. It extends the shared realtime
18
+ * handle without changing that cross-chart contract: only this chart exposes
19
+ * event-time tail flushing.
20
+ */
21
+ export interface RealtimeLineChartHandle extends RealtimeFrameHandle {
22
+ /**
23
+ * Release every event still held by `eventTime`, in event-time order.
24
+ * Call this when an input source reaches an asserted end-of-stream or batch
25
+ * boundary. Later newer events remain supported; events older than the
26
+ * flushed frontier follow `latePolicy`.
27
+ */
28
+ flush(): void;
29
+ }
30
+ export interface RealtimeLineChartProps<TDatum extends Datum = Datum> extends RealtimeAccessibilityProps {
15
31
  /** Display mode: "primary" (full chrome), "context" (compact), "sparkline" (inline) */
16
32
  mode?: ChartMode;
17
33
  /** Semantic responsive transformations applied before chart-mode defaults. */
@@ -29,12 +45,7 @@ export interface RealtimeLineChartProps<TDatum extends Datum = Datum> {
29
45
  /** Maximum canvas backing-store DPR; defaults to the environment cap. */
30
46
  maxDevicePixelRatio?: number;
31
47
  /** Chart margins */
32
- margin?: {
33
- top?: number;
34
- right?: number;
35
- bottom?: number;
36
- left?: number;
37
- };
48
+ margin?: PartialMargin;
38
49
  /** CSS class name */
39
50
  className?: string;
40
51
  onObservation?: OnObservationCallback;
@@ -46,7 +57,7 @@ export interface RealtimeLineChartProps<TDatum extends Datum = Datum> {
46
57
  /** Ring buffer capacity */
47
58
  windowSize?: number;
48
59
  /** Controlled data array */
49
- data?: Datum[];
60
+ data?: RealtimeData<TDatum>;
50
61
  /** Time value accessor */
51
62
  timeAccessor?: ChartAccessor<TDatum, number>;
52
63
  /** Value accessor */
@@ -65,6 +76,8 @@ export interface RealtimeLineChartProps<TDatum extends Datum = Datum> {
65
76
  strokeDasharray?: string;
66
77
  /** Uniform line opacity (0–1). Pairs with `stroke` / `strokeWidth` for the designer-facing primitive vocabulary. */
67
78
  opacity?: number;
79
+ /** Presentation-only CSS cursor for retained marks; does not add click, keyboard, or observation behavior. */
80
+ cursor?: CSSProperties["cursor"];
68
81
  /** Show canvas-drawn axes */
69
82
  showAxes?: boolean;
70
83
  /** Background fill color */
@@ -85,8 +98,8 @@ export interface RealtimeLineChartProps<TDatum extends Datum = Datum> {
85
98
  tickFormatTime?: (value: number) => string;
86
99
  /** Custom formatter for value axis ticks */
87
100
  tickFormatValue?: (value: number) => string;
88
- /** Custom tooltip renderer (alias for tooltipContent) */
89
- tooltip?: (d: HoverData) => ReactNode;
101
+ /** Declarative tooltip config or the legacy full-HoverData callback. Pass `"multi"` for hover-anywhere line values. */
102
+ tooltip?: RealtimeTooltipProp;
90
103
  /** Configurable opacity decay for older data */
91
104
  decay?: DecayConfig;
92
105
  /** Flash effect on newly inserted data */
@@ -117,14 +130,17 @@ export interface RealtimeLineChartProps<TDatum extends Datum = Datum> {
117
130
  /** Legend interaction mode */
118
131
  legendInteraction?: LegendInteractionMode;
119
132
  /** ID accessor for remove()/update() on the push API */
120
- pointIdAccessor?: string | ((d: Datum) => string);
133
+ pointIdAccessor?: RealtimePointIdAccessor<TDatum>;
121
134
  /**
122
135
  * Opt-in windowed aggregation over event-time. When set, pushed
123
136
  * events are reduced into tumbling/hopping/session windows and the
124
137
  * chart draws one mark per window (mean/sum/min/max/count) plus an
125
138
  * optional ±σ or min–max band — render cost scales with the number of
126
139
  * visible windows, not the arrival rate. This is the **aggregation
127
- * window**, distinct from `windowMode`'s RingBuffer eviction.
140
+ * window**, distinct from `windowMode`'s RingBuffer eviction. Changing a
141
+ * structural window field or either accessor rebuilds the accumulator:
142
+ * controlled `data` is reseeded, while push-only input begins a new epoch
143
+ * because raw events are deliberately not retained.
128
144
  */
129
145
  aggregate?: AggregateConfig;
130
146
  /**
@@ -134,7 +150,9 @@ export interface RealtimeLineChartProps<TDatum extends Datum = Datum> {
134
150
  * monotonically instead of zigzagging. Late events (older than
135
151
  * `watermark − lateness`) are dropped or kept per policy and surfaced
136
152
  * via `onObservation` as `"late-data"`. Default-off; when unset the
137
- * push path is byte-for-byte unchanged.
153
+ * push path is byte-for-byte unchanged. Call `ref.current.flush()` at an
154
+ * asserted end-of-stream boundary so the final grace-window events are
155
+ * released in order.
138
156
  */
139
157
  eventTime?: EventTimeConfig;
140
158
  }
@@ -179,6 +197,9 @@ export interface RealtimeLineChartProps<TDatum extends Datum = Datum> {
179
197
  * ```
180
198
  */
181
199
  export declare const RealtimeLineChart: {
200
+ /** Compatibility overload for refs authored against the shared 3.x handle. */
182
201
  <TDatum extends Datum = Datum>(props: RealtimeLineChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
202
+ /** Specific overload keeps ElementRef/ComponentRef aware of flush(). */
203
+ <TDatum extends Datum = Datum>(props: RealtimeLineChartProps<TDatum> & React.RefAttributes<RealtimeLineChartHandle>): React.ReactElement | null;
183
204
  displayName?: string;
184
205
  };
@@ -1,7 +1,7 @@
1
1
  import * as React from "react";
2
- import type { ArrowOfTime, WindowMode, Style, HoverAnnotationConfig, HoverData, AnnotationContext } from "../../stream/types";
2
+ import type { ArrowOfTime, WindowMode, Style, HoverAnnotationConfig, HoverData, AnnotationContext, DecayConfig, PulseConfig, StalenessConfig, TransitionConfig } from "../../stream/types";
3
3
  import type { RealtimeFrameHandle } from "../../realtime/types";
4
- import type { ReactNode } from "react";
4
+ import type { CSSProperties, ReactNode } from "react";
5
5
  import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
6
6
  import type { ChartMode, ChartAccessor, SelectionConfig, MobileInteractionProp } from "../shared/types";
7
7
  import type { OnObservationCallback } from "../../store/ObservationStore";
@@ -9,7 +9,9 @@ import type { Datum } from "../shared/datumTypes";
9
9
  import type { AutoPlaceAnnotations } from "../../recipes/annotationLayout";
10
10
  import type { MobileVisualizationContract } from "../shared/auditMobileVisualization";
11
11
  import type { ResponsiveRule } from "../shared/responsiveRules";
12
- export interface RealtimeSwarmChartProps<TDatum extends Datum = Datum> {
12
+ import type { RealtimeAccessibilityProps, RealtimeData, RealtimePointIdAccessor, RealtimeTooltipProp } from "./realtimeChartTypes";
13
+ import type { PartialMargin } from "../../types/marginType";
14
+ export interface RealtimeSwarmChartProps<TDatum extends Datum = Datum> extends RealtimeAccessibilityProps {
13
15
  /** Display mode: "primary" (full chrome), "context" (compact), "sparkline" (inline) */
14
16
  mode?: ChartMode;
15
17
  /** Semantic responsive transformations applied before chart-mode defaults. */
@@ -27,12 +29,7 @@ export interface RealtimeSwarmChartProps<TDatum extends Datum = Datum> {
27
29
  /** Maximum canvas backing-store DPR; defaults to the environment cap. */
28
30
  maxDevicePixelRatio?: number;
29
31
  /** Chart margins */
30
- margin?: {
31
- top?: number;
32
- right?: number;
33
- bottom?: number;
34
- left?: number;
35
- };
32
+ margin?: PartialMargin;
36
33
  /** CSS class name */
37
34
  className?: string;
38
35
  onObservation?: OnObservationCallback;
@@ -44,7 +41,7 @@ export interface RealtimeSwarmChartProps<TDatum extends Datum = Datum> {
44
41
  /** Ring buffer capacity */
45
42
  windowSize?: number;
46
43
  /** Controlled data array */
47
- data?: Datum[];
44
+ data?: RealtimeData<TDatum>;
48
45
  /** Time value accessor */
49
46
  timeAccessor?: ChartAccessor<TDatum, number>;
50
47
  /** Value accessor */
@@ -57,13 +54,21 @@ export interface RealtimeSwarmChartProps<TDatum extends Datum = Datum> {
57
54
  yScaleType?: "linear" | "log" | "symlog";
58
55
  /** Extent padding factor */
59
56
  extentPadding?: number;
57
+ /** Age-based opacity decay for streaming marks. */
58
+ decay?: DecayConfig;
59
+ /** Arrival pulse for newly pushed marks. */
60
+ pulse?: PulseConfig;
61
+ /** Dim or badge stale streaming values. */
62
+ staleness?: StalenessConfig;
63
+ /** Mark transition configuration. */
64
+ transition?: TransitionConfig;
60
65
  /** Category accessor for color-coding dots */
61
66
  categoryAccessor?: ChartAccessor<TDatum, string>;
62
67
  /** Category-to-color map */
63
68
  colors?: Record<string, string>;
64
69
  /** Dot radius */
65
70
  radius?: number;
66
- /** Dot fill color (when no categoryAccessor) */
71
+ /** Dot fill color, or fallback for categories missing from `colors`. */
67
72
  fill?: string;
68
73
  /** Dot opacity */
69
74
  opacity?: number;
@@ -71,6 +76,8 @@ export interface RealtimeSwarmChartProps<TDatum extends Datum = Datum> {
71
76
  stroke?: string;
72
77
  /** Dot stroke width */
73
78
  strokeWidth?: number;
79
+ /** Presentation-only CSS cursor for retained marks; does not add click, keyboard, or observation behavior. */
80
+ cursor?: CSSProperties["cursor"];
74
81
  /** Per-datum dot style. Returned values override the top-level dot primitives and category color. */
75
82
  pointStyle?: (datum: TDatum) => Style & {
76
83
  r?: number;
@@ -95,8 +102,8 @@ export interface RealtimeSwarmChartProps<TDatum extends Datum = Datum> {
95
102
  tickFormatTime?: (value: number) => string;
96
103
  /** Custom formatter for value axis ticks */
97
104
  tickFormatValue?: (value: number) => string;
98
- /** Custom tooltip renderer (alias for tooltipContent) */
99
- tooltip?: (d: HoverData) => ReactNode;
105
+ /** Declarative tooltip config or the legacy full-HoverData callback. */
106
+ tooltip?: RealtimeTooltipProp;
100
107
  /** Enable linked hover selection events for cross-chart highlighting */
101
108
  linkedHover?: boolean | string | {
102
109
  name?: string;
@@ -119,7 +126,7 @@ export interface RealtimeSwarmChartProps<TDatum extends Datum = Datum> {
119
126
  /** Legend interaction mode */
120
127
  legendInteraction?: LegendInteractionMode;
121
128
  /** ID accessor for remove()/update() on the push API */
122
- pointIdAccessor?: string | ((d: Datum) => string);
129
+ pointIdAccessor?: RealtimePointIdAccessor<TDatum>;
123
130
  }
124
131
  /**
125
132
  * RealtimeSwarmChart - Simplified wrapper for streaming dot/swarm charts.
@@ -1,7 +1,7 @@
1
1
  import * as React from "react";
2
- import type { ArrowOfTime, WindowMode, HoverAnnotationConfig, HoverData, AnnotationContext } from "../../stream/types";
2
+ import type { ArrowOfTime, WindowMode, HoverAnnotationConfig, HoverData, AnnotationContext, DecayConfig, PulseConfig, StalenessConfig, TransitionConfig } from "../../stream/types";
3
3
  import type { RealtimeFrameHandle } from "../../realtime/types";
4
- import type { ReactNode } from "react";
4
+ import type { CSSProperties, ReactNode } from "react";
5
5
  import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
6
6
  import type { ChartMode, ChartAccessor, SelectionConfig, MobileInteractionProp } from "../shared/types";
7
7
  import type { OnObservationCallback } from "../../store/ObservationStore";
@@ -9,7 +9,9 @@ import type { Datum } from "../shared/datumTypes";
9
9
  import type { AutoPlaceAnnotations } from "../../recipes/annotationLayout";
10
10
  import type { MobileVisualizationContract } from "../shared/auditMobileVisualization";
11
11
  import type { ResponsiveRule } from "../shared/responsiveRules";
12
- export interface RealtimeWaterfallChartProps<TDatum extends Datum = Datum> {
12
+ import type { RealtimeAccessibilityProps, RealtimeData, RealtimePointIdAccessor, RealtimeTooltipProp } from "./realtimeChartTypes";
13
+ import type { PartialMargin } from "../../types/marginType";
14
+ export interface RealtimeWaterfallChartProps<TDatum extends Datum = Datum> extends RealtimeAccessibilityProps {
13
15
  /** Display mode: "primary" (full chrome), "context" (compact), "sparkline" (inline) */
14
16
  mode?: ChartMode;
15
17
  /** Semantic responsive transformations applied before chart-mode defaults. */
@@ -27,12 +29,7 @@ export interface RealtimeWaterfallChartProps<TDatum extends Datum = Datum> {
27
29
  /** Maximum canvas backing-store DPR; defaults to the environment cap. */
28
30
  maxDevicePixelRatio?: number;
29
31
  /** Chart margins */
30
- margin?: {
31
- top?: number;
32
- right?: number;
33
- bottom?: number;
34
- left?: number;
35
- };
32
+ margin?: PartialMargin;
36
33
  /** CSS class name */
37
34
  className?: string;
38
35
  onObservation?: OnObservationCallback;
@@ -44,7 +41,7 @@ export interface RealtimeWaterfallChartProps<TDatum extends Datum = Datum> {
44
41
  /** Ring buffer capacity */
45
42
  windowSize?: number;
46
43
  /** Controlled data array */
47
- data?: Datum[];
44
+ data?: RealtimeData<TDatum>;
48
45
  /** Time value accessor */
49
46
  timeAccessor?: ChartAccessor<TDatum, number>;
50
47
  /** Value accessor (positive = gain, negative = loss) */
@@ -55,6 +52,14 @@ export interface RealtimeWaterfallChartProps<TDatum extends Datum = Datum> {
55
52
  valueExtent?: [number, number];
56
53
  /** Extent padding factor */
57
54
  extentPadding?: number;
55
+ /** Age-based opacity decay for streaming bars. */
56
+ decay?: DecayConfig;
57
+ /** Arrival pulse for newly pushed bars. */
58
+ pulse?: PulseConfig;
59
+ /** Dim or badge stale streaming values. */
60
+ staleness?: StalenessConfig;
61
+ /** Mark transition configuration. */
62
+ transition?: TransitionConfig;
58
63
  /** Color for positive (gain) bars */
59
64
  positiveColor?: string;
60
65
  /** Color for negative (loss) bars */
@@ -71,6 +76,8 @@ export interface RealtimeWaterfallChartProps<TDatum extends Datum = Datum> {
71
76
  strokeWidth?: number;
72
77
  /** Uniform bar opacity (0–1). */
73
78
  opacity?: number;
79
+ /** Presentation-only CSS cursor for retained marks; does not add click, keyboard, or observation behavior. */
80
+ cursor?: CSSProperties["cursor"];
74
81
  /** Show canvas-drawn axes */
75
82
  showAxes?: boolean;
76
83
  /** Background fill color */
@@ -91,8 +98,8 @@ export interface RealtimeWaterfallChartProps<TDatum extends Datum = Datum> {
91
98
  tickFormatTime?: (value: number) => string;
92
99
  /** Custom formatter for value axis ticks */
93
100
  tickFormatValue?: (value: number) => string;
94
- /** Custom tooltip renderer (alias for tooltipContent) */
95
- tooltip?: (d: HoverData) => ReactNode;
101
+ /** Declarative tooltip config or the legacy full-HoverData callback. */
102
+ tooltip?: RealtimeTooltipProp;
96
103
  /** Enable linked hover selection events for cross-chart highlighting */
97
104
  linkedHover?: boolean | string | {
98
105
  name?: string;
@@ -115,7 +122,7 @@ export interface RealtimeWaterfallChartProps<TDatum extends Datum = Datum> {
115
122
  /** Legend interaction mode */
116
123
  legendInteraction?: LegendInteractionMode;
117
124
  /** ID accessor for remove()/update() on the push API */
118
- pointIdAccessor?: string | ((d: Datum) => string);
125
+ pointIdAccessor?: RealtimePointIdAccessor<TDatum>;
119
126
  }
120
127
  /**
121
128
  * RealtimeWaterfallChart - Simplified wrapper for streaming waterfall charts.
@@ -5,7 +5,10 @@ import type { Datum } from "../shared/datumTypes";
5
5
  * set, pushed events are reduced into event-time windows and the chart
6
6
  * draws one mark per window (mean / sum / min / max / count) plus an
7
7
  * optional ±σ or min–max envelope — bounded render cost regardless of
8
- * arrival rate.
8
+ * arrival rate. Structural window changes start a new accumulator epoch:
9
+ * controlled `data` is replayed, while push-only history resets because the
10
+ * transform intentionally does not retain every raw event. `stat`, `band`,
11
+ * and `sigma` are readout-only and update existing windows in place.
9
12
  */
10
13
  export interface AggregateConfig {
11
14
  /** Window kind. @default "tumbling" */
@@ -4,6 +4,10 @@ import type { Datum } from "../shared/datumTypes";
4
4
  * Opt-in event-time ingestion for realtime XY charts. Reorders pushed
5
5
  * events within a bounded grace window so out-of-order arrivals render
6
6
  * in event-time order, at the cost of delaying display by `lateness`.
7
+ * RealtimeLineChart's chart-specific handle exposes `flush()` to release
8
+ * the final grace-window tail at an asserted end-of-stream boundary. A live
9
+ * config or time-accessor change drains the prior tail before the new policy
10
+ * begins, rather than abandoning buffered events.
7
11
  */
8
12
  export interface EventTimeConfig {
9
13
  /**
@@ -0,0 +1,27 @@
1
+ import * as React from "react";
2
+ import type { RealtimeFrameHandle } from "../../realtime/types";
3
+ import type { StreamXYFrameHandle } from "../../stream/types";
4
+ import type { Datum } from "../shared/datumTypes";
5
+ import type { ChartModeInput, ChartModeResult } from "../shared/chartMode";
6
+ import type { LegendInteractionMode, LegendInteractionState } from "../shared/hooks";
7
+ import { type SelectionHookResult } from "../shared/selectionUtils";
8
+ import type { ChartMode, SelectionConfig } from "../shared/types";
9
+ interface RealtimeModeProps extends Omit<ChartModeInput, "enableHover"> {
10
+ mode?: ChartMode;
11
+ size?: [number, number];
12
+ enableHover?: unknown;
13
+ }
14
+ export declare function useRealtimeChartMode(props: RealtimeModeProps): ChartModeResult;
15
+ export declare function useRealtimeFrameHandle(ref: React.Ref<RealtimeFrameHandle>, frameRef: React.RefObject<StreamXYFrameHandle | null>): void;
16
+ export declare function useRealtimeSelectionStyle<TStyle extends Datum>(baseStyle: ((datum: Datum) => TStyle) | undefined, hooks: readonly (SelectionHookResult | null)[], selection: SelectionConfig | undefined): ((datum: Datum) => TStyle) | undefined;
17
+ export declare function buildRealtimeFrameChromeProps(resolved: ChartModeResult, legend: LegendInteractionState, mode: LegendInteractionMode | undefined): {
18
+ title: string | undefined;
19
+ description: string | undefined;
20
+ summary: string | undefined;
21
+ accessibleTable: import("../../stream/accessibleTableTypes").AccessibleTableProp | undefined;
22
+ legendHoverBehavior: (item: import("../../semiotic-geo").LegendItem | null) => void;
23
+ legendClickBehavior: (item: import("../../semiotic-geo").LegendItem) => void;
24
+ legendHighlightedCategory: string | null;
25
+ legendIsolatedCategories: Set<string> | undefined;
26
+ };
27
+ export {};