semiotic 3.8.8 → 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 (501) hide show
  1. package/README.md +82 -66
  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} +46 -24
  9. package/ai/schema.json +10704 -825
  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 +83 -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 +6 -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 +26 -13
  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 +17 -12
  144. package/dist/components/charts/realtime/RealtimeHistogram.d.ts +12 -7
  145. package/dist/components/charts/realtime/RealtimeLineChart.d.ts +37 -14
  146. package/dist/components/charts/realtime/RealtimeSwarmChart.d.ts +23 -14
  147. package/dist/components/charts/realtime/RealtimeWaterfallChart.d.ts +22 -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/formatUtils.d.ts +40 -9
  164. package/dist/components/charts/shared/frameTextAnnotation.d.ts +63 -0
  165. package/dist/components/charts/shared/gradient.d.ts +16 -0
  166. package/dist/components/charts/shared/hatchFill.d.ts +15 -0
  167. package/dist/components/charts/shared/hooks.d.ts +4 -4
  168. package/dist/components/charts/shared/legendUtils.d.ts +1 -0
  169. package/dist/components/charts/shared/streamPropsHelpers.d.ts +3 -1
  170. package/dist/components/charts/shared/styleRules.d.ts +9 -2
  171. package/dist/components/charts/shared/styleRulesWireSchema.d.ts +353 -0
  172. package/dist/components/charts/shared/types.d.ts +26 -10
  173. package/dist/components/charts/shared/useChartLegend.d.ts +43 -9
  174. package/dist/components/charts/shared/useChartSetup.d.ts +3 -1
  175. package/dist/components/charts/shared/useCustomChartSetup.d.ts +5 -2
  176. package/dist/components/charts/shared/useNetworkChartSetup.d.ts +5 -1
  177. package/dist/components/charts/shared/useOrdinalBrush.d.ts +3 -3
  178. package/dist/components/charts/shared/useStreamingLegend.d.ts +6 -1
  179. package/dist/components/charts/value/types.d.ts +1 -1
  180. package/dist/components/charts/xy/BubbleChart.d.ts +1 -1
  181. package/dist/components/charts/xy/BumpChart.capability.d.ts +14 -1
  182. package/dist/components/charts/xy/BumpChart.d.ts +13 -73
  183. package/dist/components/charts/xy/BumpChart.semanticViability.d.ts +5 -0
  184. package/dist/components/charts/xy/CandlestickChart.d.ts +2 -2
  185. package/dist/components/charts/xy/LineChart.d.ts +2 -2
  186. package/dist/components/charts/xy/Scatterplot.d.ts +1 -1
  187. package/dist/components/charts/xy/bumpData.d.ts +44 -0
  188. package/dist/components/charts/xy/bumpIdentity.d.ts +2 -0
  189. package/dist/components/charts/xy/bumpLayout.d.ts +45 -0
  190. package/dist/components/charts/xy/bumpTooltip.d.ts +20 -0
  191. package/dist/components/legendLayout.d.ts +131 -4
  192. package/dist/components/realtime/ReorderBuffer.d.ts +2 -0
  193. package/dist/components/realtime/types.d.ts +10 -1
  194. package/dist/components/recipes/balanceSnapshotsToFlows.d.ts +42 -0
  195. package/dist/components/recipes/directedReachability.d.ts +14 -0
  196. package/dist/components/recipes/gofishDisplayListFixtures.generated.d.ts +6 -6
  197. package/dist/components/recipes/gridObservatory.d.ts +1 -1
  198. package/dist/components/recipes/networkAnalysis.d.ts +1 -18
  199. package/dist/components/recipes/physics.d.ts +7 -4
  200. package/dist/components/recipes/processPhysics.d.ts +0 -1
  201. package/dist/components/recipes/waffle.d.ts +7 -4
  202. package/dist/components/semiotic-ai-core.d.ts +13 -4
  203. package/dist/components/semiotic-ai-observations.d.ts +3 -0
  204. package/dist/components/semiotic-ai.d.ts +16 -9
  205. package/dist/components/semiotic-client-shared.d.ts +10 -0
  206. package/dist/components/semiotic-experimental.d.ts +1 -1
  207. package/dist/components/semiotic-geo.d.ts +4 -1
  208. package/dist/components/semiotic-network.d.ts +7 -4
  209. package/dist/components/semiotic-ordinal.d.ts +4 -1
  210. package/dist/components/semiotic-physics.d.ts +11 -4
  211. package/dist/components/semiotic-realtime-core.d.ts +11 -4
  212. package/dist/components/semiotic-realtime-react.d.ts +4 -3
  213. package/dist/components/semiotic-realtime.d.ts +3 -1
  214. package/dist/components/semiotic-recipes-core.d.ts +7 -5
  215. package/dist/components/semiotic-server-edge.d.ts +3 -2
  216. package/dist/components/semiotic-server.d.ts +3 -2
  217. package/dist/components/semiotic-themes-core.d.ts +5 -48
  218. package/dist/components/semiotic-utils-core.d.ts +11 -5
  219. package/dist/components/semiotic-utils-react.d.ts +2 -0
  220. package/dist/components/semiotic-xy.d.ts +4 -1
  221. package/dist/components/semiotic.d.ts +68 -25
  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 +3 -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 +24 -4
  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 +12 -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 +15 -0
  290. package/dist/components/stream/networkPipelineConfig.d.ts +1 -1
  291. package/dist/components/stream/networkTypes.d.ts +32 -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 +12 -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 +25 -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 +8 -17
  313. package/dist/components/stream/pipelineDomainResolution.d.ts +2 -2
  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 +33 -13
  322. package/dist/components/stream/useCanvasFrameHost.d.ts +12 -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 +20 -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 +11 -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.min.js +2 -1
  414. package/dist/semiotic-utils.module.min.js +2 -1
  415. package/dist/semiotic-value.min.js +1 -1
  416. package/dist/semiotic-value.module.min.js +1 -1
  417. package/dist/semiotic-xy.d.ts +4 -1
  418. package/dist/semiotic.d.ts +68 -25
  419. package/dist/semiotic.min.js +1 -1
  420. package/dist/semiotic.module.min.js +1 -1
  421. package/dist/server.min.js +1 -1
  422. package/dist/server.module.min.js +1 -1
  423. package/dist/xy.min.js +1 -1
  424. package/dist/xy.module.min.js +1 -1
  425. package/package.json +53 -19
  426. package/dist/__tests__/scenarios/mcpProtocolTypes.d.ts +0 -20
  427. package/dist/chunk-OrdinalBrushOverlay-PXHQYDB2.module.min.js +0 -2
  428. package/dist/chunk-XYBrushOverlay-ECZJJLAJ.module.min.js +0 -1
  429. package/dist/chunk-XYBrushOverlay-EP2SV3UI.module.min.js +0 -2
  430. package/dist/chunk-chartContainerDataAudit-IQ3NBN3Q.module.min.js +0 -2
  431. package/dist/chunk-chunk-2B3AIKUZ.module.min.js +0 -2
  432. package/dist/chunk-chunk-2CXCXRB4.module.min.js +0 -1
  433. package/dist/chunk-chunk-3GCILWPB.module.min.js +0 -2
  434. package/dist/chunk-chunk-46KRGJQP.module.min.js +0 -1
  435. package/dist/chunk-chunk-4ITOQRXM.module.min.js +0 -2
  436. package/dist/chunk-chunk-4MLLQUGW.module.min.js +0 -2
  437. package/dist/chunk-chunk-57RBPDBQ.module.min.js +0 -2
  438. package/dist/chunk-chunk-5UKL5W76.module.min.js +0 -2
  439. package/dist/chunk-chunk-5VVNW5AZ.module.min.js +0 -1
  440. package/dist/chunk-chunk-66PCWJUG.module.min.js +0 -1
  441. package/dist/chunk-chunk-6V5VQVCT.module.min.js +0 -2
  442. package/dist/chunk-chunk-7LE56WAE.module.min.js +0 -2
  443. package/dist/chunk-chunk-7T25U75Z.module.min.js +0 -2
  444. package/dist/chunk-chunk-ACLDBMRH.module.min.js +0 -2
  445. package/dist/chunk-chunk-AF53TBSN.module.min.js +0 -2
  446. package/dist/chunk-chunk-BTZYH2IE.module.min.js +0 -1
  447. package/dist/chunk-chunk-BWV55BZK.module.min.js +0 -2
  448. package/dist/chunk-chunk-BZNOAHJV.module.min.js +0 -2
  449. package/dist/chunk-chunk-CD6PVVS3.module.min.js +0 -2
  450. package/dist/chunk-chunk-DTSNLGRK.module.min.js +0 -2
  451. package/dist/chunk-chunk-FC3NZWYR.module.min.js +0 -2
  452. package/dist/chunk-chunk-FEPXDKJP.module.min.js +0 -1
  453. package/dist/chunk-chunk-FJ76HWQZ.module.min.js +0 -1
  454. package/dist/chunk-chunk-FRGBMTZR.module.min.js +0 -1
  455. package/dist/chunk-chunk-G75OPF5N.module.min.js +0 -2
  456. package/dist/chunk-chunk-H5IFO6CU.module.min.js +0 -2
  457. package/dist/chunk-chunk-HADHLMY5.module.min.js +0 -1
  458. package/dist/chunk-chunk-HBFA4NN6.module.min.js +0 -1
  459. package/dist/chunk-chunk-HCNDE26Q.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-JJ4BSUYL.module.min.js +0 -2
  464. package/dist/chunk-chunk-JRHXQGEV.module.min.js +0 -2
  465. package/dist/chunk-chunk-KTWEBFMX.module.min.js +0 -2
  466. package/dist/chunk-chunk-L6FFYGYS.module.min.js +0 -1
  467. package/dist/chunk-chunk-LJDH3WV3.module.min.js +0 -2
  468. package/dist/chunk-chunk-LSJUXBMF.module.min.js +0 -1
  469. package/dist/chunk-chunk-N3Q33XCB.module.min.js +0 -2
  470. package/dist/chunk-chunk-NWIGA3UK.module.min.js +0 -1
  471. package/dist/chunk-chunk-OG3TTJGJ.module.min.js +0 -2
  472. package/dist/chunk-chunk-OZK46A5U.module.min.js +0 -1
  473. package/dist/chunk-chunk-PMR47KRY.module.min.js +0 -2
  474. package/dist/chunk-chunk-Q2YADC2V.module.min.js +0 -2
  475. package/dist/chunk-chunk-QQJNG23C.module.min.js +0 -2
  476. package/dist/chunk-chunk-RGJ6TKAH.module.min.js +0 -2
  477. package/dist/chunk-chunk-ROP4HI7H.module.min.js +0 -2
  478. package/dist/chunk-chunk-SFLUSZ73.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-U66USBWU.module.min.js +0 -1
  482. package/dist/chunk-chunk-UEZ6SHW5.module.min.js +0 -2
  483. package/dist/chunk-chunk-UOQRPGPK.module.min.js +0 -2
  484. package/dist/chunk-chunk-VUWYT7DY.module.min.js +0 -2
  485. package/dist/chunk-chunk-W5HWGQMD.module.min.js +0 -2
  486. package/dist/chunk-chunk-WFHZHWT7.module.min.js +0 -1
  487. package/dist/chunk-chunk-WGROBM3I.module.min.js +0 -2
  488. package/dist/chunk-chunk-WSDJFBKX.module.min.js +0 -2
  489. package/dist/chunk-chunk-YHNZCPOZ.module.min.js +0 -2
  490. package/dist/chunk-chunk-YWZB3KPI.module.min.js +0 -2
  491. package/dist/chunk-statisticalOverlays-HMYYSGPE.module.min.js +0 -2
  492. package/dist/components/stream/test-utils/frameScheduler.d.ts +0 -12
  493. package/dist/components/stream/test-utils/revisionConsumption.d.ts +0 -13
  494. package/dist/test-utils/canvasMock.d.ts +0 -86
  495. package/dist/test-utils/capturedFrameProps.d.ts +0 -67
  496. package/dist/test-utils/frameMock.d.ts +0 -81
  497. package/dist/test-utils/ordinalFixtures.d.ts +0 -48
  498. /package/dist/{chunk-chunk-JJ2OOIET.module.min.js → c-GGISSW5E.min.js} +0 -0
  499. /package/dist/{chunk-chunk-SIRIJ3DY.module.min.js → c-N4G2L7ID.min.js} +0 -0
  500. /package/dist/{chunk-chunk-CA3YDW6F.module.min.js → c-S6U5CGT5.min.js} +0 -0
  501. /package/dist/components/recipes/{mobileAnnotationStrategy.d.ts → mobileAnnotationBehavior.d.ts} +0 -0
@@ -1,8 +1,7 @@
1
1
  /** Transactional, pure reducers and summaries for a bounded Crucible tape. */
2
2
  import type { Datum } from "../shared/datumTypes";
3
3
  import type { CrucibleApplyContext, CrucibleApplyResult, CrucibleConservationResult, CrucibleConservationSpec, CrucibleDiagnostic, CrucibleEvent, CrucibleHistoryItem, CrucibleProjectionRow, CrucibleProjectionSpec, CrucibleRunState, CrucibleSelector } from "./crucibleTypes";
4
- /** Clone mutable run structures while intentionally retaining source datum references. */
5
- export declare function cloneCrucibleState<TDatum extends Datum>(state: CrucibleRunState<TDatum>): CrucibleRunState<TDatum>;
4
+ export { cloneCrucibleState } from "./crucibleClone";
6
5
  export interface CrucibleSelectorResult {
7
6
  ids: string[];
8
7
  diagnostics: CrucibleDiagnostic[];
@@ -0,0 +1,7 @@
1
+ /**
2
+ * Create a string-keyed Crucible dictionary without inherited keys.
3
+ * Authored component, product, relation, and metric identifiers may legally
4
+ * match names such as `constructor` or `__proto__`.
5
+ */
6
+ export declare function createCrucibleRecord<T>(entries?: Iterable<readonly [string, T]>): Record<string, T>;
7
+ export declare function mergeCrucibleRecords<T>(...sources: Array<Readonly<Record<string, T>> | undefined>): Record<string, T>;
@@ -6,12 +6,12 @@ import type { Datum } from "../shared/datumTypes";
6
6
  import type { Style } from "../../stream/types";
7
7
  import type { PhysicsBodyState } from "../../stream/physics/PhysicsKernel";
8
8
  import type { PhysicsHoverData } from "../../stream/physics/StreamPhysicsFrame";
9
- import type { PhysicsSemanticItem } from "../../stream/physics/StreamPhysicsTypes";
9
+ import type { PhysicsCanvasPaintContext, PhysicsSemanticItem } from "../../stream/physics/StreamPhysicsTypes";
10
10
  import { type GauntletLayout, type GauntletProjectState } from "./gauntletPhysics";
11
+ export declare const GAUNTLET_SURFACE_PAINT = "var(--semiotic-surface, var(--semiotic-bg, #fff))";
11
12
  export declare function defaultGauntletTooltipContent(hover: PhysicsHoverData): React.ReactNode;
12
- export declare function drawGauntletBody(ctx: CanvasRenderingContext2D, body: PhysicsBodyState, style: Style): void;
13
- export declare function resolveCanvasColor(ctx: CanvasRenderingContext2D, value: Style[keyof Style] | undefined, fallback: string): string;
14
- export declare function drawTethers(ctx: CanvasRenderingContext2D, bodies: PhysicsBodyState[]): void;
13
+ export declare function drawGauntletBody(ctx: CanvasRenderingContext2D, body: PhysicsBodyState, style: Style, paintContext?: PhysicsCanvasPaintContext): void;
14
+ export declare function drawTethers(ctx: CanvasRenderingContext2D, bodies: PhysicsBodyState[], paintContext?: PhysicsCanvasPaintContext): void;
15
15
  export declare function GauntletChrome({ layout, states, compact }: {
16
16
  layout: GauntletLayout;
17
17
  states: readonly GauntletProjectState[];
@@ -82,5 +82,6 @@ export declare function buildGauntletPhysics<TDatum extends Datum = Datum>(optio
82
82
  config: NonNullable<import("../../stream/physics/PhysicsPipelineStore").PhysicsPipelineConfig>;
83
83
  initialSpawns: PhysicsQueuedSpawn[];
84
84
  layout: GauntletLayout;
85
+ states: GauntletProjectState<TDatum>[];
85
86
  };
86
87
  export declare function buildNegativeSpawn<TDatum extends Datum>(project: GauntletProjectState<TDatum>, property: GauntletPropertyDefinition, index: number, x: number, y: number, layout: GauntletWallLayout, spawnAt?: number): PhysicsQueuedSpawn;
@@ -0,0 +1,4 @@
1
+ export { GAUNTLET_WALL, clampGauntletPoint, buildGauntletPhysics } from "./gauntletPhysics";
2
+ export { applyGauntletEffect, planGauntletPropertyWork, replaceGauntletNegative } from "./gauntletEffects";
3
+ export type { GauntletAccessors, GauntletCoreBodyFn, GauntletEffect, GauntletEvent, GauntletEventContext, GauntletEventLogItem, GauntletGate, GauntletLayout, GauntletPopSpec, GauntletProjectPlacement, GauntletProjectPlacementFn, GauntletProjectState, GauntletPropertyDefinition, GauntletPropertyForceContext, GauntletPropertyWorkPlan, GauntletPropertyWorkPlanOptions, GauntletNegativeReplacementOptions, GauntletViabilityFn } from "./gauntletPhysics";
4
+ export type { GauntletChartProps } from "./gauntletChartProps";
@@ -0,0 +1,7 @@
1
+ import type { StreamPhysicsFrameProps } from "../../stream/physics/StreamPhysicsTypes";
2
+ import type { PhysicalFlowProjectionMetadata } from "./physicsChartUtils";
3
+ export declare function physicalFlowOverlay(metadata: PhysicalFlowProjectionMetadata | undefined, options: {
4
+ showNodeLabels: boolean;
5
+ showSensors: boolean;
6
+ showStaticFlow: boolean;
7
+ }): StreamPhysicsFrameProps["foregroundGraphics"] | undefined;
@@ -0,0 +1,8 @@
1
+ import type { ChartMode } from "../shared/types";
2
+ /** Physics fills its box; only compact ChartModes get non-zero chrome padding. */
3
+ export declare function physicsMarginForMode(compactMode: boolean, mode?: ChartMode): {
4
+ top: number;
5
+ right: number;
6
+ bottom: number;
7
+ left: number;
8
+ };
@@ -4,7 +4,7 @@ import type { Style } from "../../stream/types";
4
4
  import { type StyleRule } from "../shared/styleRules";
5
5
  import type { PhysicsColliderSpec } from "../../stream/physics/PhysicsKernel";
6
6
  import type { PhysicsPipelineConfig, PhysicsQueuedSpawn, PhysicsSpawnPacingOptions } from "../../stream/physics/PhysicsPipelineStore";
7
- import type { PhysicsSemanticItem } from "../../stream/physics/StreamPhysicsTypes";
7
+ import type { PhysicsSemanticItem, StreamPhysicsFrameProps } from "../../stream/physics/StreamPhysicsTypes";
8
8
  export interface PhysicsChartLayout {
9
9
  config: PhysicsPipelineConfig;
10
10
  initialSpawns: PhysicsQueuedSpawn[];
@@ -34,6 +34,8 @@ export interface PhysicsStyleRuleOptions {
34
34
  /** Numeric field/accessor a threshold rule compares against (defaults to `value`). */
35
35
  valueAccessor?: string | ((d: Datum) => unknown);
36
36
  }
37
+ /** Merge generated HOC defaults with the public frame escape hatch. */
38
+ export declare function composePhysicsBodyStyle(generatedStyle: NonNullable<StreamPhysicsFrameProps["bodyStyle"]>, frameStyle: StreamPhysicsFrameProps["bodyStyle"]): NonNullable<StreamPhysicsFrameProps["bodyStyle"]>;
37
39
  /**
38
40
  * Build a per-body `bodyStyle` from a `colorBy` accessor. When `styleRules`
39
41
  * are supplied, the merged rule style layers on top of the colorBy-derived
@@ -3,7 +3,7 @@
3
3
  * Implementations live in per-chart modules next to this file.
4
4
  */
5
5
  export type { PhysicsChartLayout, PhysicsChartArea } from "./physicsChartShared";
6
- export { projectionRowsToSemanticItems, physicsChartArea, hashStringColor, styleFromColorAccessor } from "./physicsChartShared";
6
+ export { projectionRowsToSemanticItems, physicsChartArea, hashStringColor, composePhysicsBodyStyle, styleFromColorAccessor } from "./physicsChartShared";
7
7
  export type { GaltonBoardPhysicsOptions, GaltonBoardProjectionMetadata, GaltonMechanicalSampleOptions } from "./galtonBoardPhysics";
8
8
  export { generateGaltonMechanicalSamples, buildGaltonBoardPhysics } from "./galtonBoardPhysics";
9
9
  export type { EventDropWindowOptions, EventDropPlotRegion, EventDropLidSegment, EventDropProjectionMetadata, EventDropPhysicsOptions } from "./eventDropPhysics";
@@ -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,15 +163,17 @@ 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.
161
174
  * Prefer HOC props; frameProps fill gaps.
162
175
  */
163
- export declare function resolvePhysicsFrameSharedProps(props: Pick<BaseChartProps, "accessibleTable" | "chartId" | "className" | "color" | "description" | "emphasis" | "hoverRadius" | "onClick" | "onObservation" | "opacity" | "stroke" | "strokeWidth" | "summary" | "title"> & {
176
+ export declare function resolvePhysicsFrameSharedProps(props: Pick<BaseChartProps, "accessibleTable" | "chartId" | "className" | "color" | "description" | "emphasis" | "hoverRadius" | "maxDevicePixelRatio" | "onClick" | "onObservation" | "opacity" | "stroke" | "strokeWidth" | "summary" | "title"> & {
164
177
  annotations?: StreamPhysicsFrameProps["annotations"];
165
178
  autoPlaceAnnotations?: StreamPhysicsFrameProps["autoPlaceAnnotations"];
166
179
  background?: StreamPhysicsFrameProps["background"];
@@ -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. */
@@ -24,13 +26,10 @@ export interface RealtimeHeatmapProps<TDatum extends Datum = Datum> {
24
26
  width?: number;
25
27
  /** Chart height (alternative to size) */
26
28
  height?: number;
29
+ /** Maximum canvas backing-store DPR; defaults to the environment cap. */
30
+ maxDevicePixelRatio?: number;
27
31
  /** Chart margins */
28
- margin?: {
29
- top?: number;
30
- right?: number;
31
- bottom?: number;
32
- left?: number;
33
- };
32
+ margin?: PartialMargin;
34
33
  /** CSS class name */
35
34
  className?: string;
36
35
  onObservation?: OnObservationCallback;
@@ -42,7 +41,7 @@ export interface RealtimeHeatmapProps<TDatum extends Datum = Datum> {
42
41
  /** Ring buffer capacity */
43
42
  windowSize?: number;
44
43
  /** Controlled data array */
45
- data?: Datum[];
44
+ data?: RealtimeData<TDatum>;
46
45
  /** Time/x value accessor */
47
46
  timeAccessor?: ChartAccessor<TDatum, number>;
48
47
  /** Value/y accessor */
@@ -61,6 +60,12 @@ export interface RealtimeHeatmapProps<TDatum extends Datum = Datum> {
61
60
  heatmapYBins?: number;
62
61
  /** Aggregation mode: "count", "sum", or "mean" (default: "count") */
63
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"];
64
69
  /** Show canvas-drawn axes */
65
70
  showAxes?: boolean;
66
71
  /** Background fill color */
@@ -87,8 +92,8 @@ export interface RealtimeHeatmapProps<TDatum extends Datum = Datum> {
87
92
  pulse?: PulseConfig;
88
93
  /** Frame-level data liveness indicator */
89
94
  staleness?: StalenessConfig;
90
- /** Custom tooltip renderer (alias for tooltipContent) */
91
- tooltip?: (d: HoverData) => ReactNode;
95
+ /** Declarative tooltip config or the legacy full-HoverData callback. */
96
+ tooltip?: RealtimeTooltipProp;
92
97
  /** Enable linked hover selection events for cross-chart highlighting */
93
98
  linkedHover?: boolean | string | {
94
99
  name?: string;
@@ -111,7 +116,7 @@ export interface RealtimeHeatmapProps<TDatum extends Datum = Datum> {
111
116
  /** Legend interaction mode */
112
117
  legendInteraction?: LegendInteractionMode;
113
118
  /** ID accessor for remove()/update() on the push API */
114
- pointIdAccessor?: string | ((d: Datum) => string);
119
+ pointIdAccessor?: RealtimePointIdAccessor<TDatum>;
115
120
  }
116
121
  /**
117
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. */
@@ -29,6 +30,8 @@ export interface RealtimeHistogramProps<TDatum extends Datum = Datum> {
29
30
  width?: number;
30
31
  /** Chart height (alternative to size) */
31
32
  height?: number;
33
+ /** Maximum canvas backing-store DPR; defaults to the environment cap. */
34
+ maxDevicePixelRatio?: number;
32
35
  /** Chart margins */
33
36
  margin?: PartialMargin;
34
37
  /** CSS class name */
@@ -42,7 +45,7 @@ export interface RealtimeHistogramProps<TDatum extends Datum = Datum> {
42
45
  /** Ring buffer capacity */
43
46
  windowSize?: number;
44
47
  /** Controlled data array */
45
- data?: Datum[];
48
+ data?: RealtimeData<TDatum>;
46
49
  /** Time value accessor */
47
50
  timeAccessor?: ChartAccessor<TDatum, number>;
48
51
  /** Value accessor */
@@ -71,7 +74,7 @@ export interface RealtimeHistogramProps<TDatum extends Datum = Datum> {
71
74
  * Keys also determine stack order (listed keys first, then alphabetical).
72
75
  */
73
76
  colors?: Record<string, string>;
74
- /** Bar fill color (non-stacked mode) */
77
+ /** Bar fill color, or fallback for categories missing from `colors`. */
75
78
  fill?: string;
76
79
  /** Bar stroke color */
77
80
  stroke?: string;
@@ -79,6 +82,8 @@ export interface RealtimeHistogramProps<TDatum extends Datum = Datum> {
79
82
  strokeWidth?: number;
80
83
  /** Uniform bar opacity (0–1). Pairs with `color` / `stroke` / `strokeWidth` for the designer-facing primitive vocabulary. */
81
84
  opacity?: number;
85
+ /** Presentation-only CSS cursor for retained marks; does not add click, keyboard, or observation behavior. */
86
+ cursor?: CSSProperties["cursor"];
82
87
  /** Gap between bars in pixels */
83
88
  gap?: number;
84
89
  /** Show canvas-drawn axes */
@@ -101,8 +106,8 @@ export interface RealtimeHistogramProps<TDatum extends Datum = Datum> {
101
106
  tickFormatTime?: (value: number) => string;
102
107
  /** Custom formatter for value axis ticks */
103
108
  tickFormatValue?: (value: number) => string;
104
- /** Custom tooltip renderer (alias for tooltipContent) */
105
- tooltip?: (d: HoverData) => ReactNode;
109
+ /** Declarative tooltip config or the legacy full-HoverData callback. */
110
+ tooltip?: RealtimeTooltipProp;
106
111
  /** Enable linked hover selection events for cross-chart highlighting */
107
112
  linkedHover?: boolean | string | {
108
113
  name?: string;
@@ -155,7 +160,7 @@ export interface RealtimeHistogramProps<TDatum extends Datum = Datum> {
155
160
  /** Legend interaction mode */
156
161
  legendInteraction?: LegendInteractionMode;
157
162
  /** ID accessor for remove()/update() on the push API */
158
- pointIdAccessor?: string | ((d: Datum) => string);
163
+ pointIdAccessor?: RealtimePointIdAccessor<TDatum>;
159
164
  }
160
165
  /**
161
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. */
@@ -26,13 +42,10 @@ export interface RealtimeLineChartProps<TDatum extends Datum = Datum> {
26
42
  width?: number;
27
43
  /** Chart height (alternative to size) */
28
44
  height?: number;
45
+ /** Maximum canvas backing-store DPR; defaults to the environment cap. */
46
+ maxDevicePixelRatio?: number;
29
47
  /** Chart margins */
30
- margin?: {
31
- top?: number;
32
- right?: number;
33
- bottom?: number;
34
- left?: number;
35
- };
48
+ margin?: PartialMargin;
36
49
  /** CSS class name */
37
50
  className?: string;
38
51
  onObservation?: OnObservationCallback;
@@ -44,7 +57,7 @@ export interface RealtimeLineChartProps<TDatum extends Datum = Datum> {
44
57
  /** Ring buffer capacity */
45
58
  windowSize?: number;
46
59
  /** Controlled data array */
47
- data?: Datum[];
60
+ data?: RealtimeData<TDatum>;
48
61
  /** Time value accessor */
49
62
  timeAccessor?: ChartAccessor<TDatum, number>;
50
63
  /** Value accessor */
@@ -63,6 +76,8 @@ export interface RealtimeLineChartProps<TDatum extends Datum = Datum> {
63
76
  strokeDasharray?: string;
64
77
  /** Uniform line opacity (0–1). Pairs with `stroke` / `strokeWidth` for the designer-facing primitive vocabulary. */
65
78
  opacity?: number;
79
+ /** Presentation-only CSS cursor for retained marks; does not add click, keyboard, or observation behavior. */
80
+ cursor?: CSSProperties["cursor"];
66
81
  /** Show canvas-drawn axes */
67
82
  showAxes?: boolean;
68
83
  /** Background fill color */
@@ -83,8 +98,8 @@ export interface RealtimeLineChartProps<TDatum extends Datum = Datum> {
83
98
  tickFormatTime?: (value: number) => string;
84
99
  /** Custom formatter for value axis ticks */
85
100
  tickFormatValue?: (value: number) => string;
86
- /** Custom tooltip renderer (alias for tooltipContent) */
87
- tooltip?: (d: HoverData) => ReactNode;
101
+ /** Declarative tooltip config or the legacy full-HoverData callback. Pass `"multi"` for hover-anywhere line values. */
102
+ tooltip?: RealtimeTooltipProp;
88
103
  /** Configurable opacity decay for older data */
89
104
  decay?: DecayConfig;
90
105
  /** Flash effect on newly inserted data */
@@ -115,14 +130,17 @@ export interface RealtimeLineChartProps<TDatum extends Datum = Datum> {
115
130
  /** Legend interaction mode */
116
131
  legendInteraction?: LegendInteractionMode;
117
132
  /** ID accessor for remove()/update() on the push API */
118
- pointIdAccessor?: string | ((d: Datum) => string);
133
+ pointIdAccessor?: RealtimePointIdAccessor<TDatum>;
119
134
  /**
120
135
  * Opt-in windowed aggregation over event-time. When set, pushed
121
136
  * events are reduced into tumbling/hopping/session windows and the
122
137
  * chart draws one mark per window (mean/sum/min/max/count) plus an
123
138
  * optional ±σ or min–max band — render cost scales with the number of
124
139
  * visible windows, not the arrival rate. This is the **aggregation
125
- * 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.
126
144
  */
127
145
  aggregate?: AggregateConfig;
128
146
  /**
@@ -132,7 +150,9 @@ export interface RealtimeLineChartProps<TDatum extends Datum = Datum> {
132
150
  * monotonically instead of zigzagging. Late events (older than
133
151
  * `watermark − lateness`) are dropped or kept per policy and surfaced
134
152
  * via `onObservation` as `"late-data"`. Default-off; when unset the
135
- * 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.
136
156
  */
137
157
  eventTime?: EventTimeConfig;
138
158
  }
@@ -177,6 +197,9 @@ export interface RealtimeLineChartProps<TDatum extends Datum = Datum> {
177
197
  * ```
178
198
  */
179
199
  export declare const RealtimeLineChart: {
200
+ /** Compatibility overload for refs authored against the shared 3.x handle. */
180
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;
181
204
  displayName?: string;
182
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. */
@@ -24,13 +26,10 @@ export interface RealtimeSwarmChartProps<TDatum extends Datum = Datum> {
24
26
  width?: number;
25
27
  /** Chart height (alternative to size) */
26
28
  height?: number;
29
+ /** Maximum canvas backing-store DPR; defaults to the environment cap. */
30
+ maxDevicePixelRatio?: number;
27
31
  /** Chart margins */
28
- margin?: {
29
- top?: number;
30
- right?: number;
31
- bottom?: number;
32
- left?: number;
33
- };
32
+ margin?: PartialMargin;
34
33
  /** CSS class name */
35
34
  className?: string;
36
35
  onObservation?: OnObservationCallback;
@@ -42,7 +41,7 @@ export interface RealtimeSwarmChartProps<TDatum extends Datum = Datum> {
42
41
  /** Ring buffer capacity */
43
42
  windowSize?: number;
44
43
  /** Controlled data array */
45
- data?: Datum[];
44
+ data?: RealtimeData<TDatum>;
46
45
  /** Time value accessor */
47
46
  timeAccessor?: ChartAccessor<TDatum, number>;
48
47
  /** Value accessor */
@@ -55,13 +54,21 @@ export interface RealtimeSwarmChartProps<TDatum extends Datum = Datum> {
55
54
  yScaleType?: "linear" | "log" | "symlog";
56
55
  /** Extent padding factor */
57
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;
58
65
  /** Category accessor for color-coding dots */
59
66
  categoryAccessor?: ChartAccessor<TDatum, string>;
60
67
  /** Category-to-color map */
61
68
  colors?: Record<string, string>;
62
69
  /** Dot radius */
63
70
  radius?: number;
64
- /** Dot fill color (when no categoryAccessor) */
71
+ /** Dot fill color, or fallback for categories missing from `colors`. */
65
72
  fill?: string;
66
73
  /** Dot opacity */
67
74
  opacity?: number;
@@ -69,6 +76,8 @@ export interface RealtimeSwarmChartProps<TDatum extends Datum = Datum> {
69
76
  stroke?: string;
70
77
  /** Dot stroke width */
71
78
  strokeWidth?: number;
79
+ /** Presentation-only CSS cursor for retained marks; does not add click, keyboard, or observation behavior. */
80
+ cursor?: CSSProperties["cursor"];
72
81
  /** Per-datum dot style. Returned values override the top-level dot primitives and category color. */
73
82
  pointStyle?: (datum: TDatum) => Style & {
74
83
  r?: number;
@@ -93,8 +102,8 @@ export interface RealtimeSwarmChartProps<TDatum extends Datum = Datum> {
93
102
  tickFormatTime?: (value: number) => string;
94
103
  /** Custom formatter for value axis ticks */
95
104
  tickFormatValue?: (value: number) => string;
96
- /** Custom tooltip renderer (alias for tooltipContent) */
97
- tooltip?: (d: HoverData) => ReactNode;
105
+ /** Declarative tooltip config or the legacy full-HoverData callback. */
106
+ tooltip?: RealtimeTooltipProp;
98
107
  /** Enable linked hover selection events for cross-chart highlighting */
99
108
  linkedHover?: boolean | string | {
100
109
  name?: string;
@@ -117,7 +126,7 @@ export interface RealtimeSwarmChartProps<TDatum extends Datum = Datum> {
117
126
  /** Legend interaction mode */
118
127
  legendInteraction?: LegendInteractionMode;
119
128
  /** ID accessor for remove()/update() on the push API */
120
- pointIdAccessor?: string | ((d: Datum) => string);
129
+ pointIdAccessor?: RealtimePointIdAccessor<TDatum>;
121
130
  }
122
131
  /**
123
132
  * RealtimeSwarmChart - Simplified wrapper for streaming dot/swarm charts.