semiotic 2.0.3 → 3.0.0-beta.2

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 (508) hide show
  1. package/CLAUDE.md +828 -0
  2. package/README.md +215 -37
  3. package/ai/cli.js +48 -0
  4. package/ai/dist/ai/componentRegistry.js +45 -0
  5. package/ai/dist/ai/mcp-server.js +99 -0
  6. package/ai/dist/ai/renderHOCToSVG.js +77 -0
  7. package/ai/dist/src/components/Annotation.js +358 -0
  8. package/ai/dist/src/components/AnnotationLayer/AnnotationLayer.js +369 -0
  9. package/ai/dist/src/components/Axis/Axis.js +374 -0
  10. package/ai/dist/src/components/Axis/axisTitle.js +14 -0
  11. package/ai/dist/src/components/Axis/index.js +7 -0
  12. package/ai/dist/src/components/Axis/summaryGraphic.js +37 -0
  13. package/ai/dist/src/components/Brush.js +84 -0
  14. package/ai/dist/src/components/ChartErrorBoundary.js +91 -0
  15. package/ai/dist/src/components/DividedLine.js +65 -0
  16. package/ai/dist/src/components/Legend.js +140 -0
  17. package/ai/dist/src/components/LinkedCharts.js +95 -0
  18. package/ai/dist/src/components/ThemeProvider.js +79 -0
  19. package/ai/dist/src/components/Tooltip/Tooltip.js +309 -0
  20. package/ai/dist/src/components/TooltipPositioner/index.js +132 -0
  21. package/ai/dist/src/components/annotationLayerBehavior/annotationHandling.js +73 -0
  22. package/ai/dist/src/components/annotationLayerBehavior/d3labeler.js +254 -0
  23. package/ai/dist/src/components/annotationRules/baseRules.js +150 -0
  24. package/ai/dist/src/components/annotationRules/networkframeRules.js +196 -0
  25. package/ai/dist/src/components/annotationRules/xyframeRules.js +297 -0
  26. package/ai/dist/src/components/batchWork.js +35 -0
  27. package/ai/dist/src/components/charts/index.js +109 -0
  28. package/ai/dist/src/components/charts/network/ChordDiagram.js +142 -0
  29. package/ai/dist/src/components/charts/network/CirclePack.js +108 -0
  30. package/ai/dist/src/components/charts/network/ForceDirectedGraph.js +121 -0
  31. package/ai/dist/src/components/charts/network/SankeyDiagram.js +155 -0
  32. package/ai/dist/src/components/charts/network/TreeDiagram.js +110 -0
  33. package/ai/dist/src/components/charts/network/Treemap.js +106 -0
  34. package/ai/dist/src/components/charts/ordinal/BarChart.js +156 -0
  35. package/ai/dist/src/components/charts/ordinal/BoxPlot.js +139 -0
  36. package/ai/dist/src/components/charts/ordinal/DonutChart.js +130 -0
  37. package/ai/dist/src/components/charts/ordinal/DotPlot.js +126 -0
  38. package/ai/dist/src/components/charts/ordinal/GroupedBarChart.js +129 -0
  39. package/ai/dist/src/components/charts/ordinal/Histogram.js +132 -0
  40. package/ai/dist/src/components/charts/ordinal/PieChart.js +128 -0
  41. package/ai/dist/src/components/charts/ordinal/RidgelinePlot.js +130 -0
  42. package/ai/dist/src/components/charts/ordinal/StackedBarChart.js +130 -0
  43. package/ai/dist/src/components/charts/ordinal/SwarmPlot.js +147 -0
  44. package/ai/dist/src/components/charts/ordinal/ViolinPlot.js +138 -0
  45. package/ai/dist/src/components/charts/realtime/RealtimeHeatmap.js +79 -0
  46. package/ai/dist/src/components/charts/realtime/RealtimeHistogram.js +114 -0
  47. package/ai/dist/src/components/charts/realtime/RealtimeLineChart.js +93 -0
  48. package/ai/dist/src/components/charts/realtime/RealtimeSwarmChart.js +105 -0
  49. package/ai/dist/src/components/charts/realtime/RealtimeWaterfallChart.js +106 -0
  50. package/ai/dist/src/components/charts/shared/ChartError.js +72 -0
  51. package/ai/dist/src/components/charts/shared/colorUtils.js +138 -0
  52. package/ai/dist/src/components/charts/shared/formatUtils.js +213 -0
  53. package/ai/dist/src/components/charts/shared/hooks.js +49 -0
  54. package/ai/dist/src/components/charts/shared/legendUtils.js +57 -0
  55. package/ai/dist/src/components/charts/shared/selectionUtils.js +67 -0
  56. package/ai/dist/src/components/charts/shared/tooltipUtils.js +79 -0
  57. package/ai/dist/src/components/charts/shared/types.js +2 -0
  58. package/ai/dist/src/components/charts/shared/validateChartData.js +82 -0
  59. package/ai/dist/src/components/charts/shared/validateProps.js +736 -0
  60. package/ai/dist/src/components/charts/xy/AreaChart.js +230 -0
  61. package/ai/dist/src/components/charts/xy/BubbleChart.js +251 -0
  62. package/ai/dist/src/components/charts/xy/Heatmap.js +235 -0
  63. package/ai/dist/src/components/charts/xy/LineChart.js +307 -0
  64. package/ai/dist/src/components/charts/xy/MinimapChart.js +298 -0
  65. package/ai/dist/src/components/charts/xy/Scatterplot.js +172 -0
  66. package/ai/dist/src/components/charts/xy/ScatterplotMatrix.js +426 -0
  67. package/ai/dist/src/components/charts/xy/StackedAreaChart.js +231 -0
  68. package/ai/dist/src/components/constants/coordinateNames.js +11 -0
  69. package/ai/dist/src/components/constants/frame_props.js +251 -0
  70. package/ai/dist/src/components/data/dataFunctions.js +487 -0
  71. package/ai/dist/src/components/data/multiAccessorUtils.js +14 -0
  72. package/ai/dist/src/components/data/transforms.js +143 -0
  73. package/ai/dist/src/components/data/unflowedFunctions.js +5 -0
  74. package/ai/dist/src/components/export/exportChart.js +121 -0
  75. package/ai/dist/src/components/generic_utilities/functions.js +5 -0
  76. package/ai/dist/src/components/geometry/areaDrawing.js +312 -0
  77. package/ai/dist/src/components/geometry/contourLayout.js +73 -0
  78. package/ai/dist/src/components/geometry/hexbinLayout.js +163 -0
  79. package/ai/dist/src/components/geometry/lineDrawing.js +356 -0
  80. package/ai/dist/src/components/geometry/sankeyLinks.js +331 -0
  81. package/ai/dist/src/components/geometry/summaryLayouts.js +136 -0
  82. package/ai/dist/src/components/index.js +18 -0
  83. package/ai/dist/src/components/processing/InteractionItems.js +223 -0
  84. package/ai/dist/src/components/processing/hierarchyUtils.js +104 -0
  85. package/ai/dist/src/components/processing/layouts/chordLayout.js +58 -0
  86. package/ai/dist/src/components/processing/layouts/forceLayout.js +142 -0
  87. package/ai/dist/src/components/processing/layouts/hierarchyLayout.js +31 -0
  88. package/ai/dist/src/components/processing/layouts/index.js +32 -0
  89. package/ai/dist/src/components/processing/layouts/sankeyLayout.js +96 -0
  90. package/ai/dist/src/components/processing/layouts/simpleLayouts.js +34 -0
  91. package/ai/dist/src/components/processing/layouts/types.js +2 -0
  92. package/ai/dist/src/components/processing/networkDefaults.js +39 -0
  93. package/ai/dist/src/components/realtime/BinAccumulator.js +36 -0
  94. package/ai/dist/src/components/realtime/IncrementalExtent.js +55 -0
  95. package/ai/dist/src/components/realtime/RingBuffer.js +104 -0
  96. package/ai/dist/src/components/realtime/renderers/barRenderer.js +133 -0
  97. package/ai/dist/src/components/realtime/renderers/candlestickRenderer.js +7 -0
  98. package/ai/dist/src/components/realtime/renderers/lineRenderer.js +164 -0
  99. package/ai/dist/src/components/realtime/renderers/swarmRenderer.js +91 -0
  100. package/ai/dist/src/components/realtime/renderers/types.js +2 -0
  101. package/ai/dist/src/components/realtime/renderers/waterfallRenderer.js +163 -0
  102. package/ai/dist/src/components/realtime/types.js +2 -0
  103. package/ai/dist/src/components/semiotic-ai.js +89 -0
  104. package/ai/dist/src/components/semiotic-data.js +12 -0
  105. package/ai/dist/src/components/semiotic-network.js +38 -0
  106. package/ai/dist/src/components/semiotic-ordinal.js +28 -0
  107. package/ai/dist/src/components/semiotic-realtime.js +30 -0
  108. package/ai/dist/src/components/semiotic-server.js +8 -0
  109. package/ai/dist/src/components/semiotic-xy.js +35 -0
  110. package/ai/dist/src/components/semiotic.js +109 -0
  111. package/ai/dist/src/components/server/renderToStaticSVG.js +594 -0
  112. package/ai/dist/src/components/store/SelectionStore.js +91 -0
  113. package/ai/dist/src/components/store/ThemeStore.js +78 -0
  114. package/ai/dist/src/components/store/TooltipStore.js +13 -0
  115. package/ai/dist/src/components/store/createStore.js +81 -0
  116. package/ai/dist/src/components/store/useSelection.js +133 -0
  117. package/ai/dist/src/components/stream/CanvasHitTester.js +164 -0
  118. package/ai/dist/src/components/stream/DataSourceAdapter.js +99 -0
  119. package/ai/dist/src/components/stream/MarginalGraphics.js +266 -0
  120. package/ai/dist/src/components/stream/NetworkCanvasHitTester.js +228 -0
  121. package/ai/dist/src/components/stream/NetworkPipelineStore.js +498 -0
  122. package/ai/dist/src/components/stream/NetworkSVGOverlay.js +70 -0
  123. package/ai/dist/src/components/stream/NetworkSceneGraph.js +38 -0
  124. package/ai/dist/src/components/stream/OrdinalCanvasHitTester.js +146 -0
  125. package/ai/dist/src/components/stream/OrdinalPipelineStore.js +786 -0
  126. package/ai/dist/src/components/stream/OrdinalSVGOverlay.js +130 -0
  127. package/ai/dist/src/components/stream/ParticlePool.js +174 -0
  128. package/ai/dist/src/components/stream/PipelineStore.js +1243 -0
  129. package/ai/dist/src/components/stream/SVGOverlay.js +129 -0
  130. package/ai/dist/src/components/stream/SceneGraph.js +132 -0
  131. package/ai/dist/src/components/stream/StreamNetworkFrame.js +561 -0
  132. package/ai/dist/src/components/stream/StreamOrdinalFrame.js +492 -0
  133. package/ai/dist/src/components/stream/StreamXYFrame.js +590 -0
  134. package/ai/dist/src/components/stream/accessorUtils.js +20 -0
  135. package/ai/dist/src/components/stream/index.js +32 -0
  136. package/ai/dist/src/components/stream/layouts/chordLayoutPlugin.js +352 -0
  137. package/ai/dist/src/components/stream/layouts/forceLayoutPlugin.js +230 -0
  138. package/ai/dist/src/components/stream/layouts/hierarchyLayoutPlugin.js +568 -0
  139. package/ai/dist/src/components/stream/layouts/index.js +28 -0
  140. package/ai/dist/src/components/stream/layouts/sankeyLayoutPlugin.js +245 -0
  141. package/ai/dist/src/components/stream/networkTypes.js +17 -0
  142. package/ai/dist/src/components/stream/ordinalSceneBuilders/barScene.js +126 -0
  143. package/ai/dist/src/components/stream/ordinalSceneBuilders/connectorScene.js +62 -0
  144. package/ai/dist/src/components/stream/ordinalSceneBuilders/pieScene.js +33 -0
  145. package/ai/dist/src/components/stream/ordinalSceneBuilders/pointScene.js +63 -0
  146. package/ai/dist/src/components/stream/ordinalSceneBuilders/statisticalScene.js +278 -0
  147. package/ai/dist/src/components/stream/ordinalSceneBuilders/timelineScene.js +30 -0
  148. package/ai/dist/src/components/stream/ordinalSceneBuilders/types.js +2 -0
  149. package/ai/dist/src/components/stream/ordinalTypes.js +2 -0
  150. package/ai/dist/src/components/stream/renderers/areaCanvasRenderer.js +48 -0
  151. package/ai/dist/src/components/stream/renderers/barCanvasRenderer.js +70 -0
  152. package/ai/dist/src/components/stream/renderers/boxplotCanvasRenderer.js +75 -0
  153. package/ai/dist/src/components/stream/renderers/candlestickCanvasRenderer.js +28 -0
  154. package/ai/dist/src/components/stream/renderers/connectorCanvasRenderer.js +47 -0
  155. package/ai/dist/src/components/stream/renderers/heatmapCanvasRenderer.js +31 -0
  156. package/ai/dist/src/components/stream/renderers/lineCanvasRenderer.js +140 -0
  157. package/ai/dist/src/components/stream/renderers/networkArcRenderer.js +38 -0
  158. package/ai/dist/src/components/stream/renderers/networkCircleRenderer.js +37 -0
  159. package/ai/dist/src/components/stream/renderers/networkEdgeRenderer.js +102 -0
  160. package/ai/dist/src/components/stream/renderers/networkParticleRenderer.js +63 -0
  161. package/ai/dist/src/components/stream/renderers/networkRectRenderer.js +35 -0
  162. package/ai/dist/src/components/stream/renderers/pointCanvasRenderer.js +38 -0
  163. package/ai/dist/src/components/stream/renderers/swarmCanvasRenderer.js +10 -0
  164. package/ai/dist/src/components/stream/renderers/types.js +2 -0
  165. package/ai/dist/src/components/stream/renderers/violinCanvasRenderer.js +47 -0
  166. package/ai/dist/src/components/stream/renderers/waterfallCanvasRenderer.js +38 -0
  167. package/ai/dist/src/components/stream/renderers/wedgeCanvasRenderer.js +33 -0
  168. package/ai/dist/src/components/stream/types.js +2 -0
  169. package/ai/dist/src/components/types/annotationTypes.js +2 -0
  170. package/ai/dist/src/components/types/canvasTypes.js +2 -0
  171. package/ai/dist/src/components/types/generalTypes.js +2 -0
  172. package/ai/dist/src/components/types/interactionTypes.js +2 -0
  173. package/ai/dist/src/components/types/legendTypes.js +2 -0
  174. package/ai/dist/src/components/types/networkTypes.js +2 -0
  175. package/ai/dist/src/components/types/ordinalTypes.js +2 -0
  176. package/ai/dist/src/components/types/xyTypes.js +2 -0
  177. package/ai/dist/src/components/useBoundingRect.js +24 -0
  178. package/ai/dist/src/components/visualizationLayerBehavior/axis.js +301 -0
  179. package/ai/dist/src/components/visualizationLayerBehavior/general.js +435 -0
  180. package/ai/dist/src/setupTests.js +4 -0
  181. package/ai/examples.md +489 -0
  182. package/ai/schema.json +1338 -0
  183. package/ai/system-prompt.md +41 -0
  184. package/dist/AnnotationLayer/AnnotationLayer.d.ts +0 -1
  185. package/dist/Axis/axisTitle.d.ts +3 -3
  186. package/dist/Axis/summaryGraphic.d.ts +1 -1
  187. package/dist/ChartErrorBoundary.d.ts +39 -0
  188. package/dist/LinkedCharts.d.ts +42 -0
  189. package/dist/ThemeProvider.d.ts +12 -0
  190. package/dist/Tooltip/Tooltip.d.ts +141 -0
  191. package/dist/TooltipPositioner/index.d.ts +1 -1
  192. package/dist/annotationLayerBehavior/annotationHandling.d.ts +2 -2
  193. package/dist/annotationRules/networkframeRules.d.ts +2 -2
  194. package/dist/annotationRules/xyframeRules.d.ts +2 -2
  195. package/dist/batchWork.d.ts +1 -1
  196. package/dist/charts/index.d.ts +74 -0
  197. package/dist/charts/network/ChordDiagram.d.ts +36 -0
  198. package/dist/charts/network/CirclePack.d.ts +32 -0
  199. package/dist/charts/network/ForceDirectedGraph.d.ts +38 -0
  200. package/dist/charts/network/SankeyDiagram.d.ts +38 -0
  201. package/dist/charts/network/TreeDiagram.d.ts +34 -0
  202. package/dist/charts/network/Treemap.d.ts +33 -0
  203. package/dist/charts/ordinal/BarChart.d.ts +32 -0
  204. package/dist/charts/ordinal/BoxPlot.d.ts +27 -0
  205. package/dist/charts/ordinal/DonutChart.d.ts +23 -0
  206. package/dist/charts/ordinal/DotPlot.d.ts +27 -0
  207. package/dist/charts/ordinal/GroupedBarChart.d.ts +26 -0
  208. package/dist/charts/ordinal/Histogram.d.ts +26 -0
  209. package/dist/charts/ordinal/PieChart.d.ts +21 -0
  210. package/dist/charts/ordinal/RidgelinePlot.d.ts +34 -0
  211. package/dist/charts/ordinal/StackedBarChart.d.ts +27 -0
  212. package/dist/charts/ordinal/SwarmPlot.d.ts +29 -0
  213. package/dist/charts/ordinal/ViolinPlot.d.ts +28 -0
  214. package/dist/charts/realtime/RealtimeHeatmap.d.ts +95 -0
  215. package/dist/charts/realtime/RealtimeHistogram.d.ts +119 -0
  216. package/dist/charts/realtime/RealtimeLineChart.d.ts +98 -0
  217. package/dist/charts/realtime/RealtimeSwarmChart.d.ts +100 -0
  218. package/dist/charts/realtime/RealtimeWaterfallChart.d.ts +97 -0
  219. package/dist/charts/shared/ChartError.d.ts +19 -0
  220. package/dist/charts/shared/colorUtils.d.ts +62 -0
  221. package/dist/charts/shared/formatUtils.d.ts +94 -0
  222. package/dist/charts/shared/hooks.d.ts +20 -0
  223. package/dist/charts/shared/legendUtils.d.ts +32 -0
  224. package/dist/charts/shared/selectionUtils.d.ts +51 -0
  225. package/dist/charts/shared/tooltipUtils.d.ts +18 -0
  226. package/dist/charts/shared/types.d.ts +97 -0
  227. package/dist/charts/shared/validateChartData.d.ts +41 -0
  228. package/dist/charts/shared/validateProps.d.ts +18 -0
  229. package/dist/charts/xy/AreaChart.d.ts +130 -0
  230. package/dist/charts/xy/BubbleChart.d.ts +164 -0
  231. package/dist/charts/xy/Heatmap.d.ts +156 -0
  232. package/dist/charts/xy/LineChart.d.ts +196 -0
  233. package/dist/charts/xy/MinimapChart.d.ts +73 -0
  234. package/dist/charts/xy/Scatterplot.d.ts +55 -0
  235. package/dist/charts/xy/ScatterplotMatrix.d.ts +71 -0
  236. package/dist/charts/xy/StackedAreaChart.d.ts +134 -0
  237. package/dist/constants/frame_props.d.ts +9 -0
  238. package/dist/data/dataFunctions.d.ts +10 -11
  239. package/dist/data/transforms.d.ts +45 -0
  240. package/dist/export/exportChart.d.ts +16 -0
  241. package/dist/{svg → geometry}/areaDrawing.d.ts +3 -13
  242. package/dist/geometry/contourLayout.d.ts +6 -0
  243. package/dist/geometry/hexbinLayout.d.ts +7 -0
  244. package/dist/{svg → geometry}/lineDrawing.d.ts +7 -35
  245. package/dist/geometry/sankeyLinks.d.ts +2 -0
  246. package/dist/geometry/summaryLayouts.d.ts +45 -0
  247. package/dist/index.d.ts +1 -125
  248. package/dist/network.js +7495 -0
  249. package/dist/network.js.map +1 -0
  250. package/dist/network.min.js +1 -0
  251. package/dist/network.module.js +7458 -0
  252. package/dist/network.module.js.map +1 -0
  253. package/dist/network.module.min.js +1 -0
  254. package/dist/ordinal.js +6497 -0
  255. package/dist/ordinal.js.map +1 -0
  256. package/dist/ordinal.min.js +1 -0
  257. package/dist/ordinal.module.js +6465 -0
  258. package/dist/ordinal.module.js.map +1 -0
  259. package/dist/ordinal.module.min.js +1 -0
  260. package/dist/processing/InteractionItems.d.ts +5 -4
  261. package/dist/processing/hierarchyUtils.d.ts +16 -0
  262. package/dist/processing/layouts/chordLayout.d.ts +2 -0
  263. package/dist/processing/layouts/forceLayout.d.ts +3 -0
  264. package/dist/processing/layouts/hierarchyLayout.d.ts +10 -0
  265. package/dist/processing/layouts/index.d.ts +8 -0
  266. package/dist/processing/layouts/sankeyLayout.d.ts +8 -0
  267. package/dist/processing/layouts/simpleLayouts.d.ts +7 -0
  268. package/dist/processing/layouts/types.d.ts +17 -0
  269. package/dist/processing/networkDefaults.d.ts +36 -0
  270. package/dist/realtime/BinAccumulator.d.ts +8 -0
  271. package/dist/realtime/IncrementalExtent.d.ts +13 -0
  272. package/dist/realtime/RingBuffer.d.ts +19 -0
  273. package/dist/realtime/renderers/barRenderer.d.ts +2 -0
  274. package/dist/realtime/renderers/candlestickRenderer.d.ts +2 -0
  275. package/dist/realtime/renderers/lineRenderer.d.ts +2 -0
  276. package/dist/realtime/renderers/swarmRenderer.d.ts +2 -0
  277. package/dist/realtime/renderers/types.d.ts +9 -0
  278. package/dist/realtime/renderers/waterfallRenderer.d.ts +3 -0
  279. package/dist/realtime/types.d.ts +113 -0
  280. package/dist/realtime.js +7072 -0
  281. package/dist/realtime.js.map +1 -0
  282. package/dist/realtime.min.js +1 -0
  283. package/dist/realtime.module.js +7043 -0
  284. package/dist/realtime.module.js.map +1 -0
  285. package/dist/realtime.module.min.js +1 -0
  286. package/dist/semiotic-ai.d.ts +36 -0
  287. package/dist/semiotic-ai.js +13323 -0
  288. package/dist/semiotic-ai.js.map +1 -0
  289. package/dist/semiotic-ai.min.js +1 -0
  290. package/dist/semiotic-ai.module.js +13264 -0
  291. package/dist/semiotic-ai.module.js.map +1 -0
  292. package/dist/semiotic-ai.module.min.js +1 -0
  293. package/dist/semiotic-data.d.ts +5 -0
  294. package/dist/semiotic-data.js +141 -0
  295. package/dist/semiotic-data.js.map +1 -0
  296. package/dist/semiotic-data.min.js +1 -0
  297. package/dist/semiotic-data.module.js +136 -0
  298. package/dist/semiotic-data.module.js.map +1 -0
  299. package/dist/semiotic-data.module.min.js +1 -0
  300. package/dist/semiotic-network.d.ts +23 -0
  301. package/dist/semiotic-ordinal.d.ts +19 -0
  302. package/dist/semiotic-realtime.d.ts +22 -0
  303. package/dist/semiotic-server.d.ts +1 -0
  304. package/dist/semiotic-xy.d.ts +21 -0
  305. package/dist/semiotic.d.ts +41 -28
  306. package/dist/semiotic.js +16257 -13130
  307. package/dist/semiotic.js.map +1 -0
  308. package/dist/semiotic.min.js +1 -0
  309. package/dist/semiotic.module.js +16198 -13100
  310. package/dist/semiotic.module.js.map +1 -0
  311. package/dist/semiotic.module.min.js +1 -0
  312. package/dist/server/renderToStaticSVG.d.ts +9 -0
  313. package/dist/server.js +5191 -0
  314. package/dist/server.js.map +1 -0
  315. package/dist/server.min.js +1 -0
  316. package/dist/server.module.js +5166 -0
  317. package/dist/server.module.js.map +1 -0
  318. package/dist/server.module.min.js +1 -0
  319. package/dist/store/SelectionStore.d.ts +29 -0
  320. package/dist/store/ThemeStore.d.ts +26 -0
  321. package/dist/store/useSelection.d.ts +66 -0
  322. package/dist/stream/CanvasHitTester.d.ts +18 -0
  323. package/dist/stream/DataSourceAdapter.d.ts +32 -0
  324. package/dist/stream/MarginalGraphics.d.ts +19 -0
  325. package/dist/stream/NetworkCanvasHitTester.d.ts +14 -0
  326. package/dist/stream/NetworkPipelineStore.d.ts +74 -0
  327. package/dist/stream/NetworkSVGOverlay.d.ts +40 -0
  328. package/dist/stream/NetworkSceneGraph.d.ts +14 -0
  329. package/dist/stream/OrdinalCanvasHitTester.d.ts +9 -0
  330. package/dist/stream/OrdinalPipelineStore.d.ts +65 -0
  331. package/dist/stream/OrdinalSVGOverlay.d.ts +34 -0
  332. package/dist/stream/ParticlePool.d.ts +28 -0
  333. package/dist/stream/PipelineStore.d.ts +161 -0
  334. package/dist/stream/SVGOverlay.d.ts +37 -0
  335. package/dist/stream/SceneGraph.d.ts +16 -0
  336. package/dist/stream/StreamNetworkFrame.d.ts +4 -0
  337. package/dist/stream/StreamOrdinalFrame.d.ts +4 -0
  338. package/dist/stream/StreamXYFrame.d.ts +4 -0
  339. package/dist/stream/accessorUtils.d.ts +2 -0
  340. package/dist/stream/index.d.ts +16 -0
  341. package/dist/stream/layouts/chordLayoutPlugin.d.ts +8 -0
  342. package/dist/stream/layouts/forceLayoutPlugin.d.ts +9 -0
  343. package/dist/stream/layouts/hierarchyLayoutPlugin.d.ts +17 -0
  344. package/dist/stream/layouts/index.d.ts +11 -0
  345. package/dist/stream/layouts/sankeyLayoutPlugin.d.ts +8 -0
  346. package/dist/stream/networkTypes.d.ts +346 -0
  347. package/dist/stream/ordinalSceneBuilders/barScene.d.ts +4 -0
  348. package/dist/stream/ordinalSceneBuilders/connectorScene.d.ts +3 -0
  349. package/dist/stream/ordinalSceneBuilders/pieScene.d.ts +3 -0
  350. package/dist/stream/ordinalSceneBuilders/pointScene.d.ts +4 -0
  351. package/dist/stream/ordinalSceneBuilders/statisticalScene.d.ts +6 -0
  352. package/dist/stream/ordinalSceneBuilders/timelineScene.d.ts +3 -0
  353. package/dist/stream/ordinalSceneBuilders/types.d.ts +21 -0
  354. package/dist/stream/ordinalTypes.d.ts +225 -0
  355. package/dist/stream/renderers/areaCanvasRenderer.d.ts +7 -0
  356. package/dist/stream/renderers/barCanvasRenderer.d.ts +7 -0
  357. package/dist/stream/renderers/boxplotCanvasRenderer.d.ts +2 -0
  358. package/dist/stream/renderers/candlestickCanvasRenderer.d.ts +2 -0
  359. package/dist/stream/renderers/connectorCanvasRenderer.d.ts +2 -0
  360. package/dist/stream/renderers/heatmapCanvasRenderer.d.ts +6 -0
  361. package/dist/stream/renderers/lineCanvasRenderer.d.ts +8 -0
  362. package/dist/stream/renderers/networkArcRenderer.d.ts +5 -0
  363. package/dist/stream/renderers/networkCircleRenderer.d.ts +5 -0
  364. package/dist/stream/renderers/networkEdgeRenderer.d.ts +10 -0
  365. package/dist/stream/renderers/networkParticleRenderer.d.ts +11 -0
  366. package/dist/stream/renderers/networkRectRenderer.d.ts +5 -0
  367. package/dist/stream/renderers/pointCanvasRenderer.d.ts +7 -0
  368. package/dist/stream/renderers/swarmCanvasRenderer.d.ts +7 -0
  369. package/dist/stream/renderers/types.d.ts +7 -0
  370. package/dist/stream/renderers/violinCanvasRenderer.d.ts +2 -0
  371. package/dist/stream/renderers/waterfallCanvasRenderer.d.ts +8 -0
  372. package/dist/stream/renderers/wedgeCanvasRenderer.d.ts +2 -0
  373. package/dist/stream/types.d.ts +307 -0
  374. package/dist/types/annotationTypes.d.ts +13 -18
  375. package/dist/types/canvasTypes.d.ts +1 -1
  376. package/dist/types/generalTypes.d.ts +41 -36
  377. package/dist/types/interactionTypes.d.ts +7 -9
  378. package/dist/types/legendTypes.d.ts +2 -2
  379. package/dist/types/networkTypes.d.ts +40 -30
  380. package/dist/types/ordinalTypes.d.ts +27 -18
  381. package/dist/types/xyTypes.d.ts +1 -95
  382. package/dist/visualizationLayerBehavior/axis.d.ts +3 -5
  383. package/dist/visualizationLayerBehavior/general.d.ts +8 -12
  384. package/dist/xy.js +6993 -0
  385. package/dist/xy.js.map +1 -0
  386. package/dist/xy.min.js +1 -0
  387. package/dist/xy.module.js +6957 -0
  388. package/dist/xy.module.js.map +1 -0
  389. package/dist/xy.module.min.js +1 -0
  390. package/package.json +123 -67
  391. package/dist/AnnotationLayer/helpers.d.ts +0 -6
  392. package/dist/AnnotationLayer/index.d.ts +0 -2
  393. package/dist/FacetController.d.ts +0 -12
  394. package/dist/Frame.d.ts +0 -2
  395. package/dist/InteractionLayer.d.ts +0 -3
  396. package/dist/Mark/Mark.d.ts +0 -3
  397. package/dist/Mark/Mark.types.d.ts +0 -10
  398. package/dist/Mark/constants/markTransition.d.ts +0 -10
  399. package/dist/Mark/markBehavior/drawing.d.ts +0 -13
  400. package/dist/MiniMap.d.ts +0 -14
  401. package/dist/MinimapXYFrame.d.ts +0 -10
  402. package/dist/NetworkFrame.d.ts +0 -4
  403. package/dist/OrdinalFrame.d.ts +0 -4
  404. package/dist/ResponsiveFrame.d.ts +0 -22
  405. package/dist/ResponsiveMinimapXYFrame.d.ts +0 -6
  406. package/dist/ResponsiveNetworkFrame.d.ts +0 -6
  407. package/dist/ResponsiveOrdinalFrame.d.ts +0 -6
  408. package/dist/ResponsiveXYFrame.d.ts +0 -6
  409. package/dist/SpanOrDiv.d.ts +0 -10
  410. package/dist/SparkFrame.d.ts +0 -14
  411. package/dist/SparkNetworkFrame.d.ts +0 -5
  412. package/dist/SparkOrdinalFrame.d.ts +0 -5
  413. package/dist/SparkXYFrame.d.ts +0 -5
  414. package/dist/VisualizationLayer.d.ts +0 -33
  415. package/dist/XYFrame.d.ts +0 -4
  416. package/dist/annotationRules/orframeRules.d.ts +0 -105
  417. package/dist/components/Annotation.d.ts +0 -3
  418. package/dist/components/AnnotationLayer/AnnotationLayer.d.ts +0 -26
  419. package/dist/components/Axis/Axis.d.ts +0 -7
  420. package/dist/components/Axis/axisTitle.d.ts +0 -10
  421. package/dist/components/Axis/index.d.ts +0 -2
  422. package/dist/components/Axis/summaryGraphic.d.ts +0 -17
  423. package/dist/components/Brush.d.ts +0 -12
  424. package/dist/components/DividedLine.d.ts +0 -16
  425. package/dist/components/FacetController.d.ts +0 -12
  426. package/dist/components/Frame.d.ts +0 -2
  427. package/dist/components/InteractionLayer.d.ts +0 -3
  428. package/dist/components/Legend.d.ts +0 -3
  429. package/dist/components/Mark/Mark.d.ts +0 -3
  430. package/dist/components/Mark/Mark.types.d.ts +0 -10
  431. package/dist/components/Mark/markBehavior/drawing.d.ts +0 -13
  432. package/dist/components/MiniMap.d.ts +0 -14
  433. package/dist/components/MinimapXYFrame.d.ts +0 -10
  434. package/dist/components/NetworkFrame.d.ts +0 -4
  435. package/dist/components/OrdinalFrame.d.ts +0 -4
  436. package/dist/components/ResponsiveFrame.d.ts +0 -22
  437. package/dist/components/ResponsiveMinimapXYFrame.d.ts +0 -6
  438. package/dist/components/ResponsiveNetworkFrame.d.ts +0 -6
  439. package/dist/components/ResponsiveOrdinalFrame.d.ts +0 -6
  440. package/dist/components/ResponsiveXYFrame.d.ts +0 -6
  441. package/dist/components/SpanOrDiv.d.ts +0 -10
  442. package/dist/components/SparkFrame.d.ts +0 -14
  443. package/dist/components/SparkNetworkFrame.d.ts +0 -5
  444. package/dist/components/SparkOrdinalFrame.d.ts +0 -5
  445. package/dist/components/SparkXYFrame.d.ts +0 -5
  446. package/dist/components/TooltipPositioner/index.d.ts +0 -7
  447. package/dist/components/VisualizationLayer.d.ts +0 -33
  448. package/dist/components/XYFrame.d.ts +0 -4
  449. package/dist/components/annotationLayerBehavior/annotationHandling.d.ts +0 -19
  450. package/dist/components/annotationLayerBehavior/d3labeler.d.ts +0 -9
  451. package/dist/components/annotationRules/baseRules.d.ts +0 -25
  452. package/dist/components/annotationRules/networkframeRules.d.ts +0 -48
  453. package/dist/components/annotationRules/orframeRules.d.ts +0 -105
  454. package/dist/components/annotationRules/xyframeRules.d.ts +0 -117
  455. package/dist/components/batchWork.d.ts +0 -6
  456. package/dist/components/constants/coordinateNames.d.ts +0 -8
  457. package/dist/components/constants/frame_props.d.ts +0 -4
  458. package/dist/components/constants/jsx.d.ts +0 -19
  459. package/dist/components/data/dataFunctions.d.ts +0 -46
  460. package/dist/components/data/multiAccessorUtils.d.ts +0 -1
  461. package/dist/components/data/unflowedFunctions.d.ts +0 -1
  462. package/dist/components/generic_utilities/functions.d.ts +0 -1
  463. package/dist/components/index.d.ts +0 -125
  464. package/dist/components/interactionLayerBehavior/InteractionCanvas.d.ts +0 -20
  465. package/dist/components/processing/InteractionItems.d.ts +0 -12
  466. package/dist/components/processing/network.d.ts +0 -114
  467. package/dist/components/processing/ordinal.d.ts +0 -102
  468. package/dist/components/processing/xyDrawing.d.ts +0 -135
  469. package/dist/components/semiotic.d.ts +0 -35
  470. package/dist/components/store/TooltipStore.d.ts +0 -2
  471. package/dist/components/store/createStore.d.ts +0 -1
  472. package/dist/components/svg/SvgHelper.d.ts +0 -37
  473. package/dist/components/svg/areaDrawing.d.ts +0 -31
  474. package/dist/components/svg/ckmeans.d.ts +0 -69
  475. package/dist/components/svg/frameFunctions.d.ts +0 -119
  476. package/dist/components/svg/lineDrawing.d.ts +0 -99
  477. package/dist/components/svg/networkDrawing.d.ts +0 -134
  478. package/dist/components/svg/pieceDrawing.d.ts +0 -13
  479. package/dist/components/svg/pieceLayouts.d.ts +0 -71
  480. package/dist/components/svg/summaryLayouts.d.ts +0 -74
  481. package/dist/components/types/annotationTypes.d.ts +0 -140
  482. package/dist/components/types/canvasTypes.d.ts +0 -9
  483. package/dist/components/types/generalTypes.d.ts +0 -236
  484. package/dist/components/types/interactionTypes.d.ts +0 -74
  485. package/dist/components/types/legendTypes.d.ts +0 -20
  486. package/dist/components/types/networkTypes.d.ts +0 -165
  487. package/dist/components/types/ordinalTypes.d.ts +0 -103
  488. package/dist/components/types/xyTypes.d.ts +0 -118
  489. package/dist/components/useBoundingRect.d.ts +0 -2
  490. package/dist/components/useDerivedStateFromProps.d.ts +0 -1
  491. package/dist/components/useLegacyUnmountCallback.d.ts +0 -1
  492. package/dist/components/visualizationLayerBehavior/axis.d.ts +0 -38
  493. package/dist/components/visualizationLayerBehavior/general.d.ts +0 -84
  494. package/dist/constants/jsx.d.ts +0 -19
  495. package/dist/interactionLayerBehavior/InteractionCanvas.d.ts +0 -20
  496. package/dist/processing/network.d.ts +0 -114
  497. package/dist/processing/ordinal.d.ts +0 -102
  498. package/dist/processing/xyDrawing.d.ts +0 -135
  499. package/dist/setupTests.d.ts +0 -1
  500. package/dist/svg/SvgHelper.d.ts +0 -37
  501. package/dist/svg/ckmeans.d.ts +0 -69
  502. package/dist/svg/frameFunctions.d.ts +0 -119
  503. package/dist/svg/networkDrawing.d.ts +0 -134
  504. package/dist/svg/pieceDrawing.d.ts +0 -13
  505. package/dist/svg/pieceLayouts.d.ts +0 -71
  506. package/dist/svg/summaryLayouts.d.ts +0 -74
  507. package/dist/useDerivedStateFromProps.d.ts +0 -1
  508. package/dist/useLegacyUnmountCallback.d.ts +0 -1
@@ -0,0 +1,346 @@
1
+ import type { ReactNode } from "react";
2
+ import type { HoverData, AnnotationContext } from "../realtime/types";
3
+ import type { LegendGroup } from "../types/legendTypes";
4
+ import type { Style } from "./types";
5
+ export interface TensionConfig {
6
+ weightChange: number;
7
+ newEdge: number;
8
+ newNode: number;
9
+ threshold: number;
10
+ transitionDuration: number;
11
+ }
12
+ export declare const DEFAULT_TENSION_CONFIG: TensionConfig;
13
+ export interface RealtimeNode {
14
+ id: string;
15
+ x0: number;
16
+ x1: number;
17
+ y0: number;
18
+ y1: number;
19
+ x: number;
20
+ y: number;
21
+ width: number;
22
+ height: number;
23
+ _prevX0?: number;
24
+ _prevX1?: number;
25
+ _prevY0?: number;
26
+ _prevY1?: number;
27
+ _targetX0?: number;
28
+ _targetX1?: number;
29
+ _targetY0?: number;
30
+ _targetY1?: number;
31
+ value: number;
32
+ depth?: number;
33
+ data?: Record<string, any>;
34
+ createdByFrame?: boolean;
35
+ sourceLinks?: RealtimeEdge[];
36
+ targetLinks?: RealtimeEdge[];
37
+ }
38
+ export interface RealtimeEdge {
39
+ source: RealtimeNode | string;
40
+ target: RealtimeNode | string;
41
+ value: number;
42
+ y0: number;
43
+ y1: number;
44
+ sankeyWidth: number;
45
+ _prevY0?: number;
46
+ _prevY1?: number;
47
+ _prevSankeyWidth?: number;
48
+ _targetY0?: number;
49
+ _targetY1?: number;
50
+ _targetSankeyWidth?: number;
51
+ direction?: string;
52
+ circular?: boolean;
53
+ circularPathData?: any;
54
+ bezier?: BezierCache;
55
+ data?: Record<string, any>;
56
+ }
57
+ export interface BezierPoint {
58
+ x: number;
59
+ y: number;
60
+ }
61
+ export interface BezierCache {
62
+ circular: boolean;
63
+ points?: [BezierPoint, BezierPoint, BezierPoint, BezierPoint];
64
+ segments?: Array<[BezierPoint, BezierPoint, BezierPoint, BezierPoint]>;
65
+ halfWidth: number;
66
+ }
67
+ export interface Particle {
68
+ t: number;
69
+ offset: number;
70
+ edgeIndex: number;
71
+ active: boolean;
72
+ x: number;
73
+ y: number;
74
+ }
75
+ export interface ParticleStyle {
76
+ radius?: number;
77
+ color?: string | ((edge: RealtimeEdge, node: RealtimeNode) => string);
78
+ /** Color particles by source or target node (default: "source") */
79
+ colorBy?: "source" | "target";
80
+ opacity?: number;
81
+ speedMultiplier?: number;
82
+ maxPerEdge?: number;
83
+ spawnRate?: number;
84
+ }
85
+ export declare const DEFAULT_PARTICLE_STYLE: Required<Pick<ParticleStyle, "radius" | "opacity" | "speedMultiplier" | "maxPerEdge" | "spawnRate">>;
86
+ export interface EdgePush {
87
+ source: string;
88
+ target: string;
89
+ value: number;
90
+ }
91
+ export type { HoverData };
92
+ export type RealtimeNetworkFrameHandle = StreamNetworkFrameHandle;
93
+ export interface RealtimeNetworkFrameProps {
94
+ initialEdges?: EdgePush[];
95
+ size?: [number, number];
96
+ margin?: {
97
+ top?: number;
98
+ right?: number;
99
+ bottom?: number;
100
+ left?: number;
101
+ };
102
+ orientation?: "horizontal" | "vertical";
103
+ nodeAlign?: "justify" | "left" | "right" | "center";
104
+ nodePaddingRatio?: number;
105
+ nodeWidth?: number;
106
+ tensionConfig?: Partial<TensionConfig>;
107
+ showParticles?: boolean;
108
+ particleStyle?: ParticleStyle;
109
+ colorBy?: string | ((d: RealtimeNode) => string);
110
+ colorScheme?: string | string[];
111
+ edgeColorBy?: "source" | "target" | ((d: RealtimeEdge) => string);
112
+ edgeOpacity?: number;
113
+ nodeLabel?: string | ((d: RealtimeNode) => string);
114
+ showLabels?: boolean;
115
+ enableHover?: boolean;
116
+ tooltipContent?: (d: {
117
+ type: "node" | "edge";
118
+ data: any;
119
+ }) => ReactNode;
120
+ onTopologyChange?: (nodes: RealtimeNode[], edges: RealtimeEdge[]) => void;
121
+ background?: string;
122
+ className?: string;
123
+ }
124
+ export type NetworkChartType = "force" | "sankey" | "chord" | "tree" | "cluster" | "treemap" | "circlepack" | "partition";
125
+ /** Circle node — used by force, tree, cluster, circlepack */
126
+ export interface NetworkCircleNode {
127
+ type: "circle";
128
+ cx: number;
129
+ cy: number;
130
+ r: number;
131
+ style: Style;
132
+ datum: any;
133
+ id?: string;
134
+ label?: string;
135
+ depth?: number;
136
+ }
137
+ /** Rect node — used by sankey, treemap, partition */
138
+ export interface NetworkRectNode {
139
+ type: "rect";
140
+ x: number;
141
+ y: number;
142
+ w: number;
143
+ h: number;
144
+ style: Style;
145
+ datum: any;
146
+ id?: string;
147
+ label?: string;
148
+ depth?: number;
149
+ }
150
+ /** Arc node — used by chord */
151
+ export interface NetworkArcNode {
152
+ type: "arc";
153
+ cx: number;
154
+ cy: number;
155
+ innerR: number;
156
+ outerR: number;
157
+ startAngle: number;
158
+ endAngle: number;
159
+ style: Style;
160
+ datum: any;
161
+ id?: string;
162
+ label?: string;
163
+ }
164
+ /** Line edge — used by force */
165
+ export interface NetworkLineEdge {
166
+ type: "line";
167
+ x1: number;
168
+ y1: number;
169
+ x2: number;
170
+ y2: number;
171
+ style: Style;
172
+ datum: any;
173
+ }
174
+ /** Bezier band edge — used by sankey */
175
+ export interface NetworkBezierEdge {
176
+ type: "bezier";
177
+ pathD: string;
178
+ bezierCache?: BezierCache;
179
+ style: Style;
180
+ datum: any;
181
+ }
182
+ /** Ribbon edge — used by chord */
183
+ export interface NetworkRibbonEdge {
184
+ type: "ribbon";
185
+ pathD: string;
186
+ style: Style;
187
+ datum: any;
188
+ }
189
+ /** Curved edge — used by tree, cluster */
190
+ export interface NetworkCurvedEdge {
191
+ type: "curved";
192
+ pathD: string;
193
+ style: Style;
194
+ datum: any;
195
+ }
196
+ export type NetworkSceneNode = NetworkCircleNode | NetworkRectNode | NetworkArcNode;
197
+ export type NetworkSceneEdge = NetworkLineEdge | NetworkBezierEdge | NetworkRibbonEdge | NetworkCurvedEdge;
198
+ /** Label data for the SVG overlay */
199
+ export interface NetworkLabel {
200
+ x: number;
201
+ y: number;
202
+ text: string;
203
+ anchor?: "start" | "middle" | "end";
204
+ baseline?: string;
205
+ fontSize?: number;
206
+ fontWeight?: number | string;
207
+ fill?: string;
208
+ stroke?: string;
209
+ strokeWidth?: number;
210
+ paintOrder?: string;
211
+ }
212
+ export interface NetworkLayoutPlugin {
213
+ /**
214
+ * Run the layout algorithm. May mutate node/edge positions directly.
215
+ * For bounded data, called once. For streaming, called on topology changes.
216
+ */
217
+ computeLayout(nodes: RealtimeNode[], edges: RealtimeEdge[], config: NetworkPipelineConfig, size: [number, number]): void;
218
+ /**
219
+ * Build scene nodes + labels from the positioned node/edge data.
220
+ */
221
+ buildScene(nodes: RealtimeNode[], edges: RealtimeEdge[], config: NetworkPipelineConfig, size: [number, number]): {
222
+ sceneNodes: NetworkSceneNode[];
223
+ sceneEdges: NetworkSceneEdge[];
224
+ labels: NetworkLabel[];
225
+ };
226
+ /** Whether this layout supports incremental streaming updates */
227
+ supportsStreaming: boolean;
228
+ /** Whether this layout uses hierarchical (tree) input instead of nodes+edges */
229
+ hierarchical: boolean;
230
+ }
231
+ export interface NetworkPipelineConfig {
232
+ chartType: NetworkChartType;
233
+ nodeIDAccessor?: string | ((d: any) => string);
234
+ sourceAccessor?: string | ((d: any) => string);
235
+ targetAccessor?: string | ((d: any) => string);
236
+ valueAccessor?: string | ((d: any) => number);
237
+ childrenAccessor?: string | ((d: any) => any[]);
238
+ hierarchySum?: (d: any) => number;
239
+ orientation?: "horizontal" | "vertical";
240
+ nodeAlign?: "justify" | "left" | "right" | "center";
241
+ nodePaddingRatio?: number;
242
+ nodeWidth?: number;
243
+ edgeSort?: (a: any, b: any) => number;
244
+ iterations?: number;
245
+ forceStrength?: number;
246
+ padAngle?: number;
247
+ groupWidth?: number;
248
+ sortGroups?: (a: any, b: any) => number;
249
+ treeOrientation?: "vertical" | "horizontal" | "radial";
250
+ edgeType?: "line" | "curve";
251
+ padding?: number;
252
+ paddingTop?: number;
253
+ tensionConfig?: TensionConfig;
254
+ showParticles?: boolean;
255
+ particleStyle?: ParticleStyle;
256
+ nodeStyle?: (d: any) => Record<string, any>;
257
+ edgeStyle?: (d: any) => Record<string, any>;
258
+ nodeLabel?: string | ((d: any) => string);
259
+ showLabels?: boolean;
260
+ colorBy?: string | ((d: any) => string);
261
+ colorScheme?: string | string[];
262
+ edgeColorBy?: "source" | "target" | "gradient" | ((d: any) => string);
263
+ edgeOpacity?: number;
264
+ colorByDepth?: boolean;
265
+ nodeSize?: number | string | ((d: any) => number);
266
+ nodeSizeRange?: [number, number];
267
+ }
268
+ export interface StreamNetworkFrameProps<T = Record<string, any>> {
269
+ chartType: NetworkChartType;
270
+ nodes?: T[];
271
+ edges?: T[] | T;
272
+ /** Hierarchy root (alias for edges when using tree/treemap/circlepack) */
273
+ data?: T;
274
+ initialEdges?: EdgePush[];
275
+ nodeIDAccessor?: string | ((d: T) => string);
276
+ sourceAccessor?: string | ((d: T) => string);
277
+ targetAccessor?: string | ((d: T) => string);
278
+ valueAccessor?: string | ((d: T) => number);
279
+ childrenAccessor?: string | ((d: T) => T[]);
280
+ hierarchySum?: (d: T) => number;
281
+ orientation?: "horizontal" | "vertical";
282
+ nodeAlign?: "justify" | "left" | "right" | "center";
283
+ nodePaddingRatio?: number;
284
+ nodeWidth?: number;
285
+ iterations?: number;
286
+ forceStrength?: number;
287
+ padAngle?: number;
288
+ groupWidth?: number;
289
+ sortGroups?: (a: any, b: any) => number;
290
+ edgeSort?: (a: any, b: any) => number;
291
+ treeOrientation?: "vertical" | "horizontal" | "radial";
292
+ edgeType?: "line" | "curve";
293
+ padding?: number;
294
+ paddingTop?: number;
295
+ tensionConfig?: Partial<TensionConfig>;
296
+ showParticles?: boolean;
297
+ particleStyle?: ParticleStyle;
298
+ nodeStyle?: (d: any) => Record<string, any>;
299
+ edgeStyle?: (d: any) => Record<string, any>;
300
+ colorBy?: string | ((d: any) => string);
301
+ colorScheme?: string | string[];
302
+ edgeColorBy?: "source" | "target" | "gradient" | ((d: any) => string);
303
+ edgeOpacity?: number;
304
+ colorByDepth?: boolean;
305
+ nodeSize?: number | string | ((d: any) => number);
306
+ nodeSizeRange?: [number, number];
307
+ nodeLabel?: string | ((d: any) => string);
308
+ showLabels?: boolean;
309
+ size?: [number, number];
310
+ margin?: {
311
+ top?: number;
312
+ right?: number;
313
+ bottom?: number;
314
+ left?: number;
315
+ };
316
+ className?: string;
317
+ background?: string;
318
+ enableHover?: boolean;
319
+ tooltipContent?: (d: {
320
+ type: "node" | "edge";
321
+ data: any;
322
+ x: number;
323
+ y: number;
324
+ }) => ReactNode;
325
+ onTopologyChange?: (nodes: RealtimeNode[], edges: RealtimeEdge[]) => void;
326
+ annotations?: Record<string, any>[];
327
+ svgAnnotationRules?: (annotation: Record<string, any>, index: number, context: AnnotationContext) => ReactNode;
328
+ legend?: ReactNode | {
329
+ legendGroups: LegendGroup[];
330
+ };
331
+ title?: string | ReactNode;
332
+ foregroundGraphics?: ReactNode;
333
+ backgroundGraphics?: ReactNode;
334
+ }
335
+ export interface StreamNetworkFrameHandle {
336
+ push(edge: EdgePush): void;
337
+ pushMany(edges: EdgePush[]): void;
338
+ clear(): void;
339
+ getTopology(): {
340
+ nodes: RealtimeNode[];
341
+ edges: RealtimeEdge[];
342
+ };
343
+ relayout(): void;
344
+ getTension(): number;
345
+ }
346
+ export type NetworkRendererFn = (ctx: CanvasRenderingContext2D, nodes: NetworkSceneNode[], edges: NetworkSceneEdge[], size: [number, number]) => void;
@@ -0,0 +1,4 @@
1
+ import type { OrdinalSceneNode, OrdinalLayout } from "../ordinalTypes";
2
+ import type { OrdinalSceneContext } from "./types";
3
+ export declare function buildBarScene(ctx: OrdinalSceneContext, layout: OrdinalLayout): OrdinalSceneNode[];
4
+ export declare function buildClusterBarScene(ctx: OrdinalSceneContext, layout: OrdinalLayout): OrdinalSceneNode[];
@@ -0,0 +1,3 @@
1
+ import type { ConnectorSceneNode, OrdinalSceneNode, OrdinalLayout } from "../ordinalTypes";
2
+ import type { OrdinalSceneContext } from "./types";
3
+ export declare function buildConnectors(ctx: OrdinalSceneContext, pieceNodes: OrdinalSceneNode[], layout: OrdinalLayout): ConnectorSceneNode[];
@@ -0,0 +1,3 @@
1
+ import type { WedgeSceneNode, OrdinalLayout } from "../ordinalTypes";
2
+ import type { OrdinalSceneContext } from "./types";
3
+ export declare function buildPieScene(ctx: OrdinalSceneContext, layout: OrdinalLayout): WedgeSceneNode[];
@@ -0,0 +1,4 @@
1
+ import type { OrdinalSceneNode, OrdinalLayout } from "../ordinalTypes";
2
+ import type { OrdinalSceneContext } from "./types";
3
+ export declare function buildPointScene(ctx: OrdinalSceneContext, layout: OrdinalLayout): OrdinalSceneNode[];
4
+ export declare function buildSwarmScene(ctx: OrdinalSceneContext, layout: OrdinalLayout): OrdinalSceneNode[];
@@ -0,0 +1,6 @@
1
+ import type { OrdinalSceneNode, OrdinalLayout } from "../ordinalTypes";
2
+ import type { OrdinalSceneContext } from "./types";
3
+ export declare function buildBoxplotScene(ctx: OrdinalSceneContext, layout: OrdinalLayout): OrdinalSceneNode[];
4
+ export declare function buildViolinScene(ctx: OrdinalSceneContext, layout: OrdinalLayout): OrdinalSceneNode[];
5
+ export declare function buildHistogramScene(ctx: OrdinalSceneContext, layout: OrdinalLayout): OrdinalSceneNode[];
6
+ export declare function buildRidgelineScene(ctx: OrdinalSceneContext, layout: OrdinalLayout): OrdinalSceneNode[];
@@ -0,0 +1,3 @@
1
+ import type { OrdinalSceneNode, OrdinalLayout } from "../ordinalTypes";
2
+ import type { OrdinalSceneContext } from "./types";
3
+ export declare function buildTimelineScene(ctx: OrdinalSceneContext, layout: OrdinalLayout): OrdinalSceneNode[];
@@ -0,0 +1,21 @@
1
+ import type { ScaleLinear } from "d3-scale";
2
+ import type { OrdinalScales, OrdinalColumn, OrdinalPipelineConfig, OrdinalSceneNode, OrdinalLayout } from "../ordinalTypes";
3
+ import type { Style } from "../types";
4
+ export interface OrdinalSceneContext {
5
+ scales: OrdinalScales;
6
+ columns: Record<string, OrdinalColumn>;
7
+ config: OrdinalPipelineConfig;
8
+ getR: (d: any) => number;
9
+ getStack?: (d: any) => string;
10
+ getGroup?: (d: any) => string;
11
+ getColor?: (d: any) => string;
12
+ getConnector?: (d: any) => string;
13
+ getO: (d: any) => string;
14
+ multiScales: ScaleLinear<number, number>[];
15
+ rAccessors: ((d: any) => number)[];
16
+ resolvePieceStyle: (d: any, category?: string) => Style;
17
+ resolveSummaryStyle: (d: any, category?: string) => Style;
18
+ /** For timeline: resolve rAccessor as [start, end] */
19
+ getRawRange: (d: any) => [number, number] | null;
20
+ }
21
+ export type SceneBuilderFn = (ctx: OrdinalSceneContext, layout: OrdinalLayout) => OrdinalSceneNode[];
@@ -0,0 +1,225 @@
1
+ import type { ReactNode } from "react";
2
+ import type { ScaleLinear, ScaleBand } from "d3-scale";
3
+ import type { ArrowOfTime, WindowMode, HoverAnnotationConfig, HoverData, AnnotationContext } from "../realtime/types";
4
+ import type { Style, DecayConfig, PulseConfig, TransitionConfig, StalenessConfig } from "./types";
5
+ import type { LegendGroup } from "../types/legendTypes";
6
+ export type OrdinalChartType = "bar" | "clusterbar" | "point" | "swarm" | "pie" | "donut" | "boxplot" | "violin" | "histogram" | "ridgeline" | "timeline";
7
+ export interface OrdinalScales {
8
+ o: ScaleBand<string>;
9
+ r: ScaleLinear<number, number>;
10
+ projection: "vertical" | "horizontal" | "radial";
11
+ }
12
+ export interface WedgeSceneNode {
13
+ type: "wedge";
14
+ cx: number;
15
+ cy: number;
16
+ innerRadius: number;
17
+ outerRadius: number;
18
+ startAngle: number;
19
+ endAngle: number;
20
+ style: Style;
21
+ datum: any;
22
+ category?: string;
23
+ }
24
+ export interface BoxplotSceneNode {
25
+ type: "boxplot";
26
+ /** Pixel x position of the column center */
27
+ x: number;
28
+ /** Pixel y of the value axis origin */
29
+ y: number;
30
+ projection: "vertical" | "horizontal";
31
+ columnWidth: number;
32
+ /** Pre-projected pixel positions for each quantile */
33
+ minPos: number;
34
+ q1Pos: number;
35
+ medianPos: number;
36
+ q3Pos: number;
37
+ maxPos: number;
38
+ stats: {
39
+ min: number;
40
+ q1: number;
41
+ median: number;
42
+ q3: number;
43
+ max: number;
44
+ };
45
+ style: Style;
46
+ datum: any;
47
+ category?: string;
48
+ outliers?: {
49
+ px: number;
50
+ py: number;
51
+ value: number;
52
+ datum: any;
53
+ }[];
54
+ }
55
+ export interface ViolinSceneNode {
56
+ type: "violin";
57
+ /** Pre-computed SVG path string for Path2D */
58
+ pathString: string;
59
+ /** Translation for the path */
60
+ translateX: number;
61
+ translateY: number;
62
+ /** Bounding box for hit testing */
63
+ bounds?: {
64
+ x: number;
65
+ y: number;
66
+ width: number;
67
+ height: number;
68
+ };
69
+ /** Optional IQR line overlay */
70
+ iqrLine?: {
71
+ q1Pos: number;
72
+ medianPos: number;
73
+ q3Pos: number;
74
+ };
75
+ style: Style;
76
+ datum: any;
77
+ category?: string;
78
+ }
79
+ export interface ConnectorSceneNode {
80
+ type: "connector";
81
+ x1: number;
82
+ y1: number;
83
+ x2: number;
84
+ y2: number;
85
+ style: Style;
86
+ datum: any;
87
+ group?: string;
88
+ }
89
+ export type { Style, PointSceneNode, RectSceneNode } from "./types";
90
+ import type { PointSceneNode, RectSceneNode } from "./types";
91
+ export type OrdinalSceneNode = RectSceneNode | PointSceneNode | WedgeSceneNode | BoxplotSceneNode | ViolinSceneNode | ConnectorSceneNode;
92
+ export interface OrdinalColumn {
93
+ name: string;
94
+ x: number;
95
+ y: number;
96
+ width: number;
97
+ middle: number;
98
+ padding: number;
99
+ pieceData: Record<string, any>[];
100
+ /** For radial: proportion of total (0-1) */
101
+ pct: number;
102
+ /** For radial: cumulative start proportion */
103
+ pctStart: number;
104
+ }
105
+ export interface OrdinalPipelineConfig {
106
+ chartType: OrdinalChartType;
107
+ runtimeMode?: "bounded" | "streaming";
108
+ windowSize: number;
109
+ windowMode: WindowMode;
110
+ extentPadding: number;
111
+ projection: "vertical" | "horizontal" | "radial";
112
+ oAccessor?: string | ((d: any) => string);
113
+ rAccessor?: string | ((d: any) => number) | Array<string | ((d: any) => number)>;
114
+ colorAccessor?: string | ((d: any) => string);
115
+ stackBy?: string | ((d: any) => string);
116
+ groupBy?: string | ((d: any) => string);
117
+ multiAxis?: boolean;
118
+ timeAccessor?: string | ((d: any) => number);
119
+ valueAccessor?: string | ((d: any) => number);
120
+ categoryAccessor?: string | ((d: any) => string);
121
+ rExtent?: [number?, number?];
122
+ oExtent?: string[];
123
+ barPadding?: number;
124
+ innerRadius?: number;
125
+ normalize?: boolean;
126
+ startAngle?: number;
127
+ bins?: number;
128
+ showOutliers?: boolean;
129
+ showIQR?: boolean;
130
+ amplitude?: number;
131
+ oSort?: ((a: string, b: string) => number) | boolean | "asc" | "desc";
132
+ connectorAccessor?: string | ((d: any) => string);
133
+ connectorStyle?: Style | ((d: any) => Style);
134
+ dynamicColumnWidth?: string | ((data: any[]) => number);
135
+ pieceStyle?: (d: any, category?: string) => Style;
136
+ summaryStyle?: (d: any, category?: string) => Style;
137
+ colorScheme?: string | string[];
138
+ barColors?: Record<string, string>;
139
+ decay?: DecayConfig;
140
+ pulse?: PulseConfig;
141
+ transition?: TransitionConfig;
142
+ staleness?: StalenessConfig;
143
+ }
144
+ export interface StreamOrdinalFrameProps<T = Record<string, any>> {
145
+ chartType: OrdinalChartType;
146
+ runtimeMode?: "bounded" | "streaming";
147
+ data?: T[];
148
+ oAccessor?: string | ((d: T) => string);
149
+ rAccessor?: string | ((d: T) => number) | Array<string | ((d: T) => number)>;
150
+ colorAccessor?: string | ((d: T) => string);
151
+ stackBy?: string | ((d: T) => string);
152
+ groupBy?: string | ((d: T) => string);
153
+ multiAxis?: boolean;
154
+ timeAccessor?: string | ((d: T) => number);
155
+ valueAccessor?: string | ((d: T) => number);
156
+ categoryAccessor?: string | ((d: T) => string);
157
+ projection?: "vertical" | "horizontal" | "radial";
158
+ size?: [number, number];
159
+ margin?: {
160
+ top?: number;
161
+ right?: number;
162
+ bottom?: number;
163
+ left?: number;
164
+ };
165
+ barPadding?: number;
166
+ innerRadius?: number;
167
+ normalize?: boolean;
168
+ startAngle?: number;
169
+ dynamicColumnWidth?: string | ((data: T[]) => number);
170
+ bins?: number;
171
+ showOutliers?: boolean;
172
+ showIQR?: boolean;
173
+ amplitude?: number;
174
+ rExtent?: [number?, number?];
175
+ oExtent?: string[];
176
+ extentPadding?: number;
177
+ oSort?: ((a: string, b: string) => number) | boolean | "asc" | "desc";
178
+ arrowOfTime?: ArrowOfTime;
179
+ windowMode?: WindowMode;
180
+ windowSize?: number;
181
+ connectorAccessor?: string | ((d: T) => string);
182
+ connectorStyle?: Style | ((d: any) => Style);
183
+ pieceStyle?: (d: any, category?: string) => Style;
184
+ summaryStyle?: (d: any, category?: string) => Style;
185
+ colorScheme?: string | string[];
186
+ barColors?: Record<string, string>;
187
+ showAxes?: boolean;
188
+ oLabel?: string;
189
+ rLabel?: string;
190
+ oFormat?: (d: string) => string;
191
+ rFormat?: (d: number) => string;
192
+ enableHover?: boolean;
193
+ hoverAnnotation?: boolean | HoverAnnotationConfig;
194
+ tooltipContent?: (d: HoverData) => ReactNode;
195
+ customHoverBehavior?: (d: HoverData | null) => void;
196
+ annotations?: Record<string, any>[];
197
+ svgAnnotationRules?: (annotation: Record<string, any>, index: number, context: AnnotationContext) => ReactNode;
198
+ showGrid?: boolean;
199
+ legend?: ReactNode | {
200
+ legendGroups: LegendGroup[];
201
+ };
202
+ backgroundGraphics?: ReactNode;
203
+ foregroundGraphics?: ReactNode;
204
+ title?: string | ReactNode;
205
+ className?: string;
206
+ background?: string;
207
+ centerContent?: ReactNode;
208
+ decay?: DecayConfig;
209
+ pulse?: PulseConfig;
210
+ transition?: TransitionConfig;
211
+ staleness?: StalenessConfig;
212
+ }
213
+ export interface StreamOrdinalFrameHandle<T = Record<string, any>> {
214
+ push(datum: T): void;
215
+ pushMany(data: T[]): void;
216
+ clear(): void;
217
+ getData(): T[];
218
+ getScales(): OrdinalScales | null;
219
+ }
220
+ export interface OrdinalLayout {
221
+ width: number;
222
+ height: number;
223
+ }
224
+ export type OrdinalRendererFn = (ctx: CanvasRenderingContext2D, nodes: OrdinalSceneNode[], scales: OrdinalScales, layout: OrdinalLayout) => void;
225
+ export type { HoverData, HoverAnnotationConfig, AnnotationContext, ArrowOfTime, WindowMode };
@@ -0,0 +1,7 @@
1
+ import type { StreamRendererFn } from "./types";
2
+ /**
3
+ * Canvas area renderer.
4
+ * Renders AreaSceneNode as filled regions between topPath and bottomPath.
5
+ * Supports both overlapping areas and stacked areas.
6
+ */
7
+ export declare const areaCanvasRenderer: StreamRendererFn;
@@ -0,0 +1,7 @@
1
+ import type { StreamRendererFn } from "./types";
2
+ /**
3
+ * Canvas bar renderer.
4
+ * Renders RectSceneNode as filled rectangles. Supports icon/isotype mode
5
+ * where an image is stamped repeatedly to fill the bar instead of a solid fill.
6
+ */
7
+ export declare const barCanvasRenderer: StreamRendererFn;
@@ -0,0 +1,2 @@
1
+ import type { OrdinalSceneNode, OrdinalScales, OrdinalLayout } from "../ordinalTypes";
2
+ export declare const boxplotCanvasRenderer: (ctx: CanvasRenderingContext2D, nodes: OrdinalSceneNode[], _scales: OrdinalScales, _layout: OrdinalLayout) => void;
@@ -0,0 +1,2 @@
1
+ import type { StreamRendererFn } from "./types";
2
+ export declare const candlestickCanvasRenderer: StreamRendererFn;
@@ -0,0 +1,2 @@
1
+ import type { OrdinalSceneNode, OrdinalScales, OrdinalLayout } from "../ordinalTypes";
2
+ export declare const connectorCanvasRenderer: (ctx: CanvasRenderingContext2D, nodes: OrdinalSceneNode[], _scales: OrdinalScales, _layout: OrdinalLayout) => void;
@@ -0,0 +1,6 @@
1
+ import type { StreamRendererFn } from "./types";
2
+ /**
3
+ * Canvas heatmap renderer.
4
+ * Renders HeatcellSceneNode as filled rectangles with color encoding.
5
+ */
6
+ export declare const heatmapCanvasRenderer: StreamRendererFn;
@@ -0,0 +1,8 @@
1
+ import type { StreamRendererFn } from "./types";
2
+ /**
3
+ * Canvas line renderer.
4
+ * Renders LineSceneNode paths using moveTo/lineTo.
5
+ * Supports threshold-based segment coloring when colorThresholds + rawValues
6
+ * are present on the node.
7
+ */
8
+ export declare const lineCanvasRenderer: StreamRendererFn;
@@ -0,0 +1,5 @@
1
+ import type { NetworkSceneNode } from "../networkTypes";
2
+ /**
3
+ * Canvas painter for NetworkArcNode (chord diagram arc segments).
4
+ */
5
+ export declare function networkArcRenderer(ctx: CanvasRenderingContext2D, nodes: NetworkSceneNode[]): void;
@@ -0,0 +1,5 @@
1
+ import type { NetworkSceneNode } from "../networkTypes";
2
+ /**
3
+ * Canvas painter for NetworkCircleNode (force nodes, tree nodes, circlepack).
4
+ */
5
+ export declare function networkCircleRenderer(ctx: CanvasRenderingContext2D, nodes: NetworkSceneNode[]): void;