semiotic 2.0.2 → 3.0.0-beta.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (359) hide show
  1. package/CLAUDE.md +530 -0
  2. package/README.md +190 -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 +373 -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/DividedLine.js +65 -0
  15. package/ai/dist/src/components/FacetController.js +259 -0
  16. package/ai/dist/src/components/Frame.js +139 -0
  17. package/ai/dist/src/components/InteractionLayer.js +328 -0
  18. package/ai/dist/src/components/Legend.js +140 -0
  19. package/ai/dist/src/components/MiniMap.js +75 -0
  20. package/ai/dist/src/components/MinimapXYFrame.js +99 -0
  21. package/ai/dist/src/components/NetworkFrame.js +335 -0
  22. package/ai/dist/src/components/OrdinalFrame.js +437 -0
  23. package/ai/dist/src/components/ResponsiveFrame.js +68 -0
  24. package/ai/dist/src/components/ResponsiveMinimapXYFrame.js +11 -0
  25. package/ai/dist/src/components/ResponsiveNetworkFrame.js +11 -0
  26. package/ai/dist/src/components/ResponsiveOrdinalFrame.js +11 -0
  27. package/ai/dist/src/components/ResponsiveXYFrame.js +10 -0
  28. package/ai/dist/src/components/SparkFrame.js +113 -0
  29. package/ai/dist/src/components/SparkNetworkFrame.js +11 -0
  30. package/ai/dist/src/components/SparkOrdinalFrame.js +11 -0
  31. package/ai/dist/src/components/SparkXYFrame.js +11 -0
  32. package/ai/dist/src/components/Tooltip/Tooltip.js +304 -0
  33. package/ai/dist/src/components/TooltipPositioner/index.js +132 -0
  34. package/ai/dist/src/components/VisualizationLayer.js +395 -0
  35. package/ai/dist/src/components/XYFrame.js +524 -0
  36. package/ai/dist/src/components/annotationLayerBehavior/annotationHandling.js +73 -0
  37. package/ai/dist/src/components/annotationLayerBehavior/d3labeler.js +254 -0
  38. package/ai/dist/src/components/annotationRules/baseRules.js +150 -0
  39. package/ai/dist/src/components/annotationRules/networkframeRules.js +198 -0
  40. package/ai/dist/src/components/annotationRules/orframeRules.js +695 -0
  41. package/ai/dist/src/components/annotationRules/xyframeRules.js +299 -0
  42. package/ai/dist/src/components/batchWork.js +35 -0
  43. package/ai/dist/src/components/charts/index.js +96 -0
  44. package/ai/dist/src/components/charts/network/ChordDiagram.js +245 -0
  45. package/ai/dist/src/components/charts/network/CirclePack.js +177 -0
  46. package/ai/dist/src/components/charts/network/ForceDirectedGraph.js +248 -0
  47. package/ai/dist/src/components/charts/network/SankeyDiagram.js +305 -0
  48. package/ai/dist/src/components/charts/network/TreeDiagram.js +268 -0
  49. package/ai/dist/src/components/charts/network/Treemap.js +177 -0
  50. package/ai/dist/src/components/charts/ordinal/BarChart.js +191 -0
  51. package/ai/dist/src/components/charts/ordinal/BoxPlot.js +235 -0
  52. package/ai/dist/src/components/charts/ordinal/DonutChart.js +178 -0
  53. package/ai/dist/src/components/charts/ordinal/DotPlot.js +194 -0
  54. package/ai/dist/src/components/charts/ordinal/GroupedBarChart.js +194 -0
  55. package/ai/dist/src/components/charts/ordinal/PieChart.js +155 -0
  56. package/ai/dist/src/components/charts/ordinal/StackedBarChart.js +213 -0
  57. package/ai/dist/src/components/charts/ordinal/SwarmPlot.js +219 -0
  58. package/ai/dist/src/components/charts/realtime/RealtimeBarChart.js +91 -0
  59. package/ai/dist/src/components/charts/realtime/RealtimeLineChart.js +73 -0
  60. package/ai/dist/src/components/charts/realtime/RealtimeSwarmChart.js +85 -0
  61. package/ai/dist/src/components/charts/realtime/RealtimeWaterfallChart.js +86 -0
  62. package/ai/dist/src/components/charts/shared/ChartError.js +72 -0
  63. package/ai/dist/src/components/charts/shared/colorUtils.js +138 -0
  64. package/ai/dist/src/components/charts/shared/formatUtils.js +176 -0
  65. package/ai/dist/src/components/charts/shared/hooks.js +49 -0
  66. package/ai/dist/src/components/charts/shared/legendUtils.js +57 -0
  67. package/ai/dist/src/components/charts/shared/types.js +2 -0
  68. package/ai/dist/src/components/charts/shared/validateChartData.js +82 -0
  69. package/ai/dist/src/components/charts/shared/validateProps.js +640 -0
  70. package/ai/dist/src/components/charts/xy/AreaChart.js +220 -0
  71. package/ai/dist/src/components/charts/xy/BubbleChart.js +222 -0
  72. package/ai/dist/src/components/charts/xy/Heatmap.js +230 -0
  73. package/ai/dist/src/components/charts/xy/LineChart.js +302 -0
  74. package/ai/dist/src/components/charts/xy/Scatterplot.js +136 -0
  75. package/ai/dist/src/components/charts/xy/StackedAreaChart.js +220 -0
  76. package/ai/dist/src/components/constants/coordinateNames.js +11 -0
  77. package/ai/dist/src/components/constants/frame_props.js +251 -0
  78. package/ai/dist/src/components/constants/jsx.js +71 -0
  79. package/ai/dist/src/components/data/dataFunctions.js +473 -0
  80. package/ai/dist/src/components/data/multiAccessorUtils.js +14 -0
  81. package/ai/dist/src/components/data/networkPipelineCache.js +43 -0
  82. package/ai/dist/src/components/data/ordinalPipelineCache.js +53 -0
  83. package/ai/dist/src/components/data/unflowedFunctions.js +5 -0
  84. package/ai/dist/src/components/data/xyPipelineCache.js +49 -0
  85. package/ai/dist/src/components/generic_utilities/functions.js +5 -0
  86. package/ai/dist/src/components/index.js +145 -0
  87. package/ai/dist/src/components/interactionLayerBehavior/InteractionCanvas.js +128 -0
  88. package/ai/dist/src/components/processing/InteractionItems.js +223 -0
  89. package/ai/dist/src/components/processing/hierarchyUtils.js +104 -0
  90. package/ai/dist/src/components/processing/layouts/chordLayout.js +58 -0
  91. package/ai/dist/src/components/processing/layouts/forceLayout.js +142 -0
  92. package/ai/dist/src/components/processing/layouts/hierarchyLayout.js +31 -0
  93. package/ai/dist/src/components/processing/layouts/index.js +32 -0
  94. package/ai/dist/src/components/processing/layouts/sankeyLayout.js +96 -0
  95. package/ai/dist/src/components/processing/layouts/simpleLayouts.js +34 -0
  96. package/ai/dist/src/components/processing/layouts/types.js +2 -0
  97. package/ai/dist/src/components/processing/network.js +771 -0
  98. package/ai/dist/src/components/processing/networkDefaults.js +39 -0
  99. package/ai/dist/src/components/processing/networkLayoutHelpers.js +98 -0
  100. package/ai/dist/src/components/processing/ordinal.js +889 -0
  101. package/ai/dist/src/components/processing/ordinalConstants.js +23 -0
  102. package/ai/dist/src/components/processing/ordinalOverlays.js +88 -0
  103. package/ai/dist/src/components/processing/ordinalRenderPipeline.js +196 -0
  104. package/ai/dist/src/components/processing/xyDrawing.js +484 -0
  105. package/ai/dist/src/components/realtime/BinAccumulator.js +36 -0
  106. package/ai/dist/src/components/realtime/IncrementalExtent.js +55 -0
  107. package/ai/dist/src/components/realtime/RealtimeFrame.js +710 -0
  108. package/ai/dist/src/components/realtime/RingBuffer.js +104 -0
  109. package/ai/dist/src/components/realtime/renderers/barRenderer.js +133 -0
  110. package/ai/dist/src/components/realtime/renderers/candlestickRenderer.js +7 -0
  111. package/ai/dist/src/components/realtime/renderers/lineRenderer.js +164 -0
  112. package/ai/dist/src/components/realtime/renderers/swarmRenderer.js +91 -0
  113. package/ai/dist/src/components/realtime/renderers/types.js +2 -0
  114. package/ai/dist/src/components/realtime/renderers/waterfallRenderer.js +163 -0
  115. package/ai/dist/src/components/realtime/types.js +2 -0
  116. package/ai/dist/src/components/semiotic-ai.js +66 -0
  117. package/ai/dist/src/components/semiotic-network.js +30 -0
  118. package/ai/dist/src/components/semiotic-ordinal.js +28 -0
  119. package/ai/dist/src/components/semiotic-realtime.js +37 -0
  120. package/ai/dist/src/components/semiotic-server.js +8 -0
  121. package/ai/dist/src/components/semiotic-xy.js +41 -0
  122. package/ai/dist/src/components/semiotic.js +101 -0
  123. package/ai/dist/src/components/server/renderToStaticSVG.js +392 -0
  124. package/ai/dist/src/components/store/TooltipStore.js +13 -0
  125. package/ai/dist/src/components/store/createStore.js +77 -0
  126. package/ai/dist/src/components/svg/SvgHelper.js +308 -0
  127. package/ai/dist/src/components/svg/areaDrawing.js +312 -0
  128. package/ai/dist/src/components/svg/boxplotRenderer.js +441 -0
  129. package/ai/dist/src/components/svg/bucketizedRenderer.js +677 -0
  130. package/ai/dist/src/components/svg/ckbinsRenderer.js +92 -0
  131. package/ai/dist/src/components/svg/ckmeans.js +238 -0
  132. package/ai/dist/src/components/svg/contourLayout.js +73 -0
  133. package/ai/dist/src/components/svg/contourRenderer.js +53 -0
  134. package/ai/dist/src/components/svg/edgeGenerators.js +181 -0
  135. package/ai/dist/src/components/svg/frameFunctions.js +579 -0
  136. package/ai/dist/src/components/svg/graphAlgorithms.js +138 -0
  137. package/ai/dist/src/components/svg/hexbinLayout.js +163 -0
  138. package/ai/dist/src/components/svg/lineDrawing.js +427 -0
  139. package/ai/dist/src/components/svg/networkDrawing.js +207 -0
  140. package/ai/dist/src/components/svg/nodeGenerators.js +131 -0
  141. package/ai/dist/src/components/svg/pieceDrawing.js +110 -0
  142. package/ai/dist/src/components/svg/pieceLayouts.js +588 -0
  143. package/ai/dist/src/components/svg/sankeyLinks.js +143 -0
  144. package/ai/dist/src/components/svg/summaryAxis.js +48 -0
  145. package/ai/dist/src/components/svg/summaryLayouts.js +202 -0
  146. package/ai/dist/src/components/svg/swarmLayout.js +128 -0
  147. package/ai/dist/src/components/types/annotationTypes.js +2 -0
  148. package/ai/dist/src/components/types/canvasTypes.js +2 -0
  149. package/ai/dist/src/components/types/generalTypes.js +2 -0
  150. package/ai/dist/src/components/types/interactionTypes.js +2 -0
  151. package/ai/dist/src/components/types/legendTypes.js +2 -0
  152. package/ai/dist/src/components/types/networkTypes.js +2 -0
  153. package/ai/dist/src/components/types/ordinalTypes.js +2 -0
  154. package/ai/dist/src/components/types/xyTypes.js +2 -0
  155. package/ai/dist/src/components/useBoundingRect.js +24 -0
  156. package/ai/dist/src/components/useDerivedStateFromProps.js +25 -0
  157. package/ai/dist/src/components/useLegacyUnmountCallback.js +21 -0
  158. package/ai/dist/src/components/visualizationLayerBehavior/axis.js +249 -0
  159. package/ai/dist/src/components/visualizationLayerBehavior/general.js +435 -0
  160. package/ai/dist/src/setupTests.js +4 -0
  161. package/ai/examples.md +394 -0
  162. package/ai/schema.json +1178 -0
  163. package/ai/system-prompt.md +38 -0
  164. package/dist/Annotation.d.ts +3 -0
  165. package/dist/AnnotationLayer/AnnotationLayer.d.ts +25 -0
  166. package/dist/Axis/Axis.d.ts +7 -0
  167. package/dist/Axis/axisTitle.d.ts +10 -0
  168. package/dist/Axis/index.d.ts +2 -0
  169. package/dist/Axis/summaryGraphic.d.ts +17 -0
  170. package/dist/Brush.d.ts +12 -0
  171. package/dist/DividedLine.d.ts +16 -0
  172. package/dist/FacetController.d.ts +12 -0
  173. package/dist/Frame.d.ts +2 -0
  174. package/dist/InteractionLayer.d.ts +3 -0
  175. package/dist/Legend.d.ts +3 -0
  176. package/dist/MiniMap.d.ts +14 -0
  177. package/dist/MinimapXYFrame.d.ts +10 -0
  178. package/dist/NetworkFrame.d.ts +8 -0
  179. package/dist/OrdinalFrame.d.ts +8 -0
  180. package/dist/ResponsiveFrame.d.ts +22 -0
  181. package/dist/ResponsiveMinimapXYFrame.d.ts +3 -0
  182. package/dist/ResponsiveNetworkFrame.d.ts +3 -0
  183. package/dist/ResponsiveOrdinalFrame.d.ts +3 -0
  184. package/dist/ResponsiveXYFrame.d.ts +3 -0
  185. package/dist/SparkFrame.d.ts +14 -0
  186. package/dist/SparkNetworkFrame.d.ts +5 -0
  187. package/dist/SparkOrdinalFrame.d.ts +5 -0
  188. package/dist/SparkXYFrame.d.ts +5 -0
  189. package/dist/Tooltip/Tooltip.d.ts +141 -0
  190. package/dist/TooltipPositioner/index.d.ts +7 -0
  191. package/dist/VisualizationLayer.d.ts +33 -0
  192. package/dist/XYFrame.d.ts +8 -0
  193. package/dist/annotationLayerBehavior/annotationHandling.d.ts +19 -0
  194. package/dist/annotationLayerBehavior/d3labeler.d.ts +9 -0
  195. package/dist/annotationRules/baseRules.d.ts +25 -0
  196. package/dist/annotationRules/networkframeRules.d.ts +48 -0
  197. package/dist/annotationRules/orframeRules.d.ts +103 -0
  198. package/dist/annotationRules/xyframeRules.d.ts +117 -0
  199. package/dist/batchWork.d.ts +6 -0
  200. package/dist/charts/index.d.ts +62 -0
  201. package/dist/charts/network/ChordDiagram.d.ts +181 -0
  202. package/dist/charts/network/CirclePack.d.ts +103 -0
  203. package/dist/charts/network/ForceDirectedGraph.d.ts +192 -0
  204. package/dist/charts/network/SankeyDiagram.d.ts +195 -0
  205. package/dist/charts/network/TreeDiagram.d.ts +200 -0
  206. package/dist/charts/network/Treemap.d.ts +98 -0
  207. package/dist/charts/ordinal/BarChart.d.ts +119 -0
  208. package/dist/charts/ordinal/BoxPlot.d.ts +125 -0
  209. package/dist/charts/ordinal/DonutChart.d.ts +95 -0
  210. package/dist/charts/ordinal/DotPlot.d.ts +128 -0
  211. package/dist/charts/ordinal/GroupedBarChart.d.ts +113 -0
  212. package/dist/charts/ordinal/PieChart.d.ts +83 -0
  213. package/dist/charts/ordinal/StackedBarChart.d.ts +119 -0
  214. package/dist/charts/ordinal/SwarmPlot.d.ts +137 -0
  215. package/dist/charts/realtime/RealtimeBarChart.d.ts +102 -0
  216. package/dist/charts/realtime/RealtimeLineChart.d.ts +78 -0
  217. package/dist/charts/realtime/RealtimeSwarmChart.d.ts +88 -0
  218. package/dist/charts/realtime/RealtimeWaterfallChart.d.ts +85 -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 +82 -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/types.d.ts +58 -0
  225. package/dist/charts/shared/validateChartData.d.ts +41 -0
  226. package/dist/charts/shared/validateProps.d.ts +18 -0
  227. package/dist/charts/xy/AreaChart.d.ts +127 -0
  228. package/dist/charts/xy/BubbleChart.d.ts +157 -0
  229. package/dist/charts/xy/Heatmap.d.ts +153 -0
  230. package/dist/charts/xy/LineChart.d.ts +193 -0
  231. package/dist/charts/xy/Scatterplot.d.ts +50 -0
  232. package/dist/charts/xy/StackedAreaChart.d.ts +131 -0
  233. package/dist/constants/coordinateNames.d.ts +8 -0
  234. package/dist/constants/frame_props.d.ts +13 -0
  235. package/dist/constants/jsx.d.ts +19 -0
  236. package/dist/data/dataFunctions.d.ts +45 -0
  237. package/dist/data/multiAccessorUtils.d.ts +1 -0
  238. package/dist/data/networkPipelineCache.d.ts +27 -0
  239. package/dist/data/ordinalPipelineCache.d.ts +33 -0
  240. package/dist/data/unflowedFunctions.d.ts +1 -0
  241. package/dist/data/xyPipelineCache.d.ts +35 -0
  242. package/dist/generic_utilities/functions.d.ts +1 -0
  243. package/dist/index.d.ts +133 -0
  244. package/dist/interactionLayerBehavior/InteractionCanvas.d.ts +20 -0
  245. package/dist/network.js +8520 -0
  246. package/dist/network.js.map +1 -0
  247. package/dist/network.min.js +1 -0
  248. package/dist/network.module.js +8484 -0
  249. package/dist/network.module.js.map +1 -0
  250. package/dist/network.module.min.js +1 -0
  251. package/dist/ordinal.js +9276 -0
  252. package/dist/ordinal.js.map +1 -0
  253. package/dist/ordinal.min.js +1 -0
  254. package/dist/ordinal.module.js +9242 -0
  255. package/dist/ordinal.module.js.map +1 -0
  256. package/dist/ordinal.module.min.js +1 -0
  257. package/dist/processing/InteractionItems.d.ts +13 -0
  258. package/dist/processing/hierarchyUtils.d.ts +16 -0
  259. package/dist/processing/layouts/chordLayout.d.ts +2 -0
  260. package/dist/processing/layouts/forceLayout.d.ts +3 -0
  261. package/dist/processing/layouts/hierarchyLayout.d.ts +10 -0
  262. package/dist/processing/layouts/index.d.ts +8 -0
  263. package/dist/processing/layouts/sankeyLayout.d.ts +8 -0
  264. package/dist/processing/layouts/simpleLayouts.d.ts +7 -0
  265. package/dist/processing/layouts/types.d.ts +17 -0
  266. package/dist/processing/network.d.ts +111 -0
  267. package/dist/processing/networkDefaults.d.ts +36 -0
  268. package/dist/processing/networkLayoutHelpers.d.ts +54 -0
  269. package/dist/processing/ordinal.d.ts +102 -0
  270. package/dist/processing/ordinalConstants.d.ts +33 -0
  271. package/dist/processing/ordinalOverlays.d.ts +33 -0
  272. package/dist/processing/ordinalRenderPipeline.d.ts +148 -0
  273. package/dist/processing/xyDrawing.d.ts +140 -0
  274. package/dist/realtime/BinAccumulator.d.ts +8 -0
  275. package/dist/realtime/IncrementalExtent.d.ts +13 -0
  276. package/dist/realtime/RealtimeFrame.d.ts +4 -0
  277. package/dist/realtime/RingBuffer.d.ts +19 -0
  278. package/dist/realtime/renderers/barRenderer.d.ts +2 -0
  279. package/dist/realtime/renderers/candlestickRenderer.d.ts +2 -0
  280. package/dist/realtime/renderers/lineRenderer.d.ts +2 -0
  281. package/dist/realtime/renderers/swarmRenderer.d.ts +2 -0
  282. package/dist/realtime/renderers/types.d.ts +9 -0
  283. package/dist/realtime/renderers/waterfallRenderer.d.ts +3 -0
  284. package/dist/realtime/types.d.ts +113 -0
  285. package/dist/realtime.js +1598 -0
  286. package/dist/realtime.js.map +1 -0
  287. package/dist/realtime.min.js +1 -0
  288. package/dist/realtime.module.js +1566 -0
  289. package/dist/realtime.module.js.map +1 -0
  290. package/dist/realtime.module.min.js +1 -0
  291. package/dist/semiotic-ai.d.ts +28 -0
  292. package/dist/semiotic-ai.js +18722 -0
  293. package/dist/semiotic-ai.js.map +1 -0
  294. package/dist/semiotic-ai.min.js +1 -0
  295. package/dist/semiotic-ai.module.js +18668 -0
  296. package/dist/semiotic-ai.module.js.map +1 -0
  297. package/dist/semiotic-ai.module.min.js +1 -0
  298. package/dist/semiotic-network.d.ts +19 -0
  299. package/dist/semiotic-ordinal.d.ts +18 -0
  300. package/dist/semiotic-realtime.d.ts +23 -0
  301. package/dist/semiotic-server.d.ts +1 -0
  302. package/dist/semiotic-xy.d.ts +24 -0
  303. package/dist/semiotic.d.ts +51 -0
  304. package/dist/semiotic.js +18723 -12996
  305. package/dist/semiotic.js.map +1 -0
  306. package/dist/semiotic.min.js +1 -0
  307. package/dist/semiotic.module.js +18666 -12965
  308. package/dist/semiotic.module.js.map +1 -0
  309. package/dist/semiotic.module.min.js +1 -0
  310. package/dist/server/renderToStaticSVG.d.ts +9 -0
  311. package/dist/server.js +8360 -0
  312. package/dist/server.js.map +1 -0
  313. package/dist/server.min.js +1 -0
  314. package/dist/server.module.js +8331 -0
  315. package/dist/server.module.js.map +1 -0
  316. package/dist/server.module.min.js +1 -0
  317. package/dist/store/TooltipStore.d.ts +2 -0
  318. package/dist/store/createStore.d.ts +1 -0
  319. package/dist/svg/SvgHelper.d.ts +33 -0
  320. package/dist/svg/areaDrawing.d.ts +21 -0
  321. package/dist/svg/boxplotRenderer.d.ts +15 -0
  322. package/dist/svg/bucketizedRenderer.d.ts +16 -0
  323. package/dist/svg/ckbinsRenderer.d.ts +20 -0
  324. package/dist/svg/ckmeans.d.ts +69 -0
  325. package/dist/svg/contourLayout.d.ts +6 -0
  326. package/dist/svg/contourRenderer.d.ts +12 -0
  327. package/dist/svg/edgeGenerators.d.ts +51 -0
  328. package/dist/svg/frameFunctions.d.ts +108 -0
  329. package/dist/svg/graphAlgorithms.d.ts +14 -0
  330. package/dist/svg/hexbinLayout.d.ts +7 -0
  331. package/dist/svg/lineDrawing.d.ts +99 -0
  332. package/dist/svg/networkDrawing.d.ts +16 -0
  333. package/dist/svg/nodeGenerators.d.ts +58 -0
  334. package/dist/svg/pieceDrawing.d.ts +12 -0
  335. package/dist/svg/pieceLayouts.d.ts +53 -0
  336. package/dist/svg/sankeyLinks.d.ts +3 -0
  337. package/dist/svg/summaryAxis.d.ts +6 -0
  338. package/dist/svg/summaryLayouts.d.ts +53 -0
  339. package/dist/svg/swarmLayout.d.ts +13 -0
  340. package/dist/types/annotationTypes.d.ts +135 -0
  341. package/dist/types/canvasTypes.d.ts +9 -0
  342. package/dist/types/generalTypes.d.ts +238 -0
  343. package/dist/types/interactionTypes.d.ts +72 -0
  344. package/dist/types/legendTypes.d.ts +20 -0
  345. package/dist/types/networkTypes.d.ts +175 -0
  346. package/dist/types/ordinalTypes.d.ts +112 -0
  347. package/dist/types/xyTypes.d.ts +115 -0
  348. package/dist/useBoundingRect.d.ts +2 -0
  349. package/dist/useDerivedStateFromProps.d.ts +1 -0
  350. package/dist/useLegacyUnmountCallback.d.ts +2 -0
  351. package/dist/visualizationLayerBehavior/axis.d.ts +36 -0
  352. package/dist/visualizationLayerBehavior/general.d.ts +80 -0
  353. package/dist/xy.js +7944 -0
  354. package/dist/xy.js.map +1 -0
  355. package/dist/xy.min.js +1 -0
  356. package/dist/xy.module.js +7903 -0
  357. package/dist/xy.module.js.map +1 -0
  358. package/dist/xy.module.min.js +1 -0
  359. package/package.json +116 -65
@@ -0,0 +1,358 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
14
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
15
+ }) : function(o, v) {
16
+ o["default"] = v;
17
+ });
18
+ var __importStar = (this && this.__importStar) || (function () {
19
+ var ownKeys = function(o) {
20
+ ownKeys = Object.getOwnPropertyNames || function (o) {
21
+ var ar = [];
22
+ for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
23
+ return ar;
24
+ };
25
+ return ownKeys(o);
26
+ };
27
+ return function (mod) {
28
+ if (mod && mod.__esModule) return mod;
29
+ var result = {};
30
+ if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
31
+ __setModuleDefault(result, mod);
32
+ return result;
33
+ };
34
+ })();
35
+ Object.defineProperty(exports, "__esModule", { value: true });
36
+ exports.default = SemioticAnnotation;
37
+ const React = __importStar(require("react"));
38
+ function wrapText(text, wrap = 120, charWidth = 8) {
39
+ if (!text)
40
+ return [];
41
+ const maxChars = Math.max(1, Math.floor(wrap / charWidth));
42
+ const words = text.split(/\s+/);
43
+ const lines = [];
44
+ let currentLine = "";
45
+ for (const word of words) {
46
+ if (currentLine && currentLine.length + 1 + word.length > maxChars) {
47
+ lines.push(currentLine);
48
+ currentLine = word;
49
+ }
50
+ else {
51
+ currentLine = currentLine ? `${currentLine} ${word}` : word;
52
+ }
53
+ }
54
+ if (currentLine)
55
+ lines.push(currentLine);
56
+ return lines;
57
+ }
58
+ function bracketPath(type, span, depth, isVertical) {
59
+ if (type === "curly") {
60
+ if (isVertical) {
61
+ return `M0,0 C${depth * 0.6},0 ${depth * 0.4},${span / 2} ${depth},${span / 2} C${depth * 0.4},${span / 2} ${depth * 0.6},${span} 0,${span}`;
62
+ }
63
+ return `M0,0 C0,${depth * 0.6} ${span / 2},${depth * 0.4} ${span / 2},${depth} C${span / 2},${depth * 0.4} ${span},${depth * 0.6} ${span},0`;
64
+ }
65
+ // square bracket
66
+ if (isVertical) {
67
+ return `M0,0 L${depth},0 L${depth},${span} L0,${span}`;
68
+ }
69
+ return `M0,0 L0,${depth} L${span},${depth} L${span},0`;
70
+ }
71
+ function renderNote(note, dx, dy, color) {
72
+ if (!note)
73
+ return React.createElement("g", { className: "annotation-note" });
74
+ const { label, title, orientation: explicitOrientation, align: explicitAlign, wrap = 120, noWrap } = note;
75
+ if (!label && !title)
76
+ return React.createElement("g", { className: "annotation-note" });
77
+ let orientation = explicitOrientation;
78
+ if (!orientation) {
79
+ orientation = Math.abs(dx) > Math.abs(dy) ? "leftRight" : "topBottom";
80
+ }
81
+ let align = explicitAlign;
82
+ if (!align || align === "dynamic") {
83
+ if (orientation === "topBottom") {
84
+ align = dx >= 0 ? "left" : "right";
85
+ }
86
+ else {
87
+ align = dy >= 0 ? "top" : "bottom";
88
+ }
89
+ }
90
+ let textAnchor = "start";
91
+ if (orientation === "topBottom") {
92
+ if (align === "right")
93
+ textAnchor = "end";
94
+ else if (align === "middle")
95
+ textAnchor = "middle";
96
+ }
97
+ else {
98
+ textAnchor = dx >= 0 ? "start" : "end";
99
+ }
100
+ const lineHeight = 16;
101
+ const padding = 4;
102
+ const titleLines = title ? (noWrap ? [title] : wrapText(title, wrap)) : [];
103
+ const labelLines = label ? (noWrap ? [label] : wrapText(label, wrap)) : [];
104
+ // For leftRight orientation, offset text horizontally away from the note-line
105
+ const textX = orientation === "leftRight"
106
+ ? (textAnchor === "end" ? -padding : padding)
107
+ : 0;
108
+ let yOffset = 0;
109
+ const textElements = [];
110
+ if (titleLines.length > 0) {
111
+ textElements.push(React.createElement("text", { key: "annotation-note-title", className: "annotation-note-title", fill: color || undefined, textAnchor: textAnchor, fontWeight: "bold" }, titleLines.map((line, i) => (React.createElement("tspan", { key: i, x: textX, dy: i === 0 ? 0 : lineHeight }, line)))));
112
+ yOffset = titleLines.length * lineHeight;
113
+ }
114
+ if (labelLines.length > 0) {
115
+ textElements.push(React.createElement("text", { key: "annotation-note-label", className: "annotation-note-label", fill: color || undefined, textAnchor: textAnchor, y: yOffset }, labelLines.map((line, i) => (React.createElement("tspan", { key: i, x: textX, dy: i === 0 ? lineHeight : lineHeight }, line)))));
116
+ }
117
+ let noteLine = null;
118
+ if ((title || label) && (dx !== 0 || dy !== 0)) {
119
+ if (orientation === "topBottom") {
120
+ const lineWidth = Math.min(wrap, 120);
121
+ let x1 = 0;
122
+ let x2 = lineWidth;
123
+ if (textAnchor === "end") {
124
+ x1 = -lineWidth;
125
+ x2 = 0;
126
+ }
127
+ else if (textAnchor === "middle") {
128
+ x1 = -lineWidth / 2;
129
+ x2 = lineWidth / 2;
130
+ }
131
+ noteLine = (React.createElement("line", { className: "note-line", x1: x1, x2: x2, y1: 0, y2: 0, stroke: color || "currentColor" }));
132
+ }
133
+ else {
134
+ const totalHeight = (titleLines.length + labelLines.length) * lineHeight +
135
+ (labelLines.length > 0 ? lineHeight : 0);
136
+ let y1 = 0;
137
+ let y2 = totalHeight;
138
+ if (align === "bottom") {
139
+ y1 = -totalHeight;
140
+ y2 = 0;
141
+ }
142
+ else if (align === "middle") {
143
+ y1 = -totalHeight / 2;
144
+ y2 = totalHeight / 2;
145
+ }
146
+ noteLine = (React.createElement("line", { className: "note-line", x1: 0, x2: 0, y1: y1, y2: y2, stroke: color || "currentColor" }));
147
+ }
148
+ }
149
+ // Compute vertical offset for note content based on orientation and alignment.
150
+ // The label's first tspan adds an extra lineHeight gap below the title,
151
+ // so total visual height is larger when a label is present.
152
+ const totalLines = titleLines.length + labelLines.length;
153
+ const totalTextHeight = totalLines * lineHeight;
154
+ const labelGap = labelLines.length > 0 ? lineHeight : 0;
155
+ const visualHeight = totalTextHeight + labelGap;
156
+ let contentYOffset = 0;
157
+ if (orientation === "topBottom") {
158
+ if (dy < 0) {
159
+ contentYOffset = -visualHeight;
160
+ }
161
+ }
162
+ else if (orientation === "leftRight") {
163
+ if (align === "middle") {
164
+ contentYOffset = -(visualHeight / 2);
165
+ }
166
+ else if (align === "bottom" || dy < 0) {
167
+ contentYOffset = -visualHeight;
168
+ }
169
+ }
170
+ const contentTransform = contentYOffset !== 0
171
+ ? `translate(0,${contentYOffset})`
172
+ : undefined;
173
+ return (React.createElement("g", { className: "annotation-note", transform: `translate(${dx},${dy})` },
174
+ React.createElement("g", { className: "annotation-note-content", transform: contentTransform }, textElements),
175
+ noteLine));
176
+ }
177
+ function renderSubject(type, subject, color, annotX, annotY) {
178
+ const elements = [];
179
+ switch (type) {
180
+ case "callout-circle": {
181
+ const totalRadius = (subject?.radius || 0) + (subject?.radiusPadding || 0);
182
+ if (totalRadius > 0) {
183
+ elements.push(React.createElement("circle", { key: "subject-circle", r: totalRadius, fill: "none", stroke: color || "currentColor" }));
184
+ }
185
+ break;
186
+ }
187
+ case "callout-rect": {
188
+ const width = subject?.width || 0;
189
+ const height = subject?.height || 0;
190
+ if (width > 0 || height > 0) {
191
+ elements.push(React.createElement("rect", { key: "subject-rect", width: width, height: height, fill: "none", stroke: color || "currentColor" }));
192
+ }
193
+ break;
194
+ }
195
+ case "callout-custom": {
196
+ if (subject?.custom) {
197
+ const customElements = Array.isArray(subject.custom)
198
+ ? subject.custom
199
+ : [subject.custom];
200
+ elements.push(...customElements);
201
+ }
202
+ break;
203
+ }
204
+ case "xy-threshold": {
205
+ const x = annotX || 0;
206
+ const y = annotY || 0;
207
+ if (subject?.x !== undefined) {
208
+ const y1 = (subject.y1 || 0) - y;
209
+ const y2 = (subject.y2 || 0) - y;
210
+ const sx = (subject.x || 0) - x;
211
+ elements.push(React.createElement("line", { key: "threshold-line", x1: sx, y1: y1, x2: sx, y2: y2, stroke: color || "currentColor", strokeDasharray: "5,5" }));
212
+ }
213
+ else if (subject?.y !== undefined) {
214
+ const x1 = (subject.x1 || 0) - x;
215
+ const x2 = (subject.x2 || 0) - x;
216
+ const sy = (subject.y || 0) - y;
217
+ elements.push(React.createElement("line", { key: "threshold-line", x1: x1, y1: sy, x2: x2, y2: sy, stroke: color || "currentColor", strokeDasharray: "5,5" }));
218
+ }
219
+ else if (subject?.x1 !== undefined || subject?.x2 !== undefined) {
220
+ // Horizontal threshold line when only x1/x2 provided (no subject.x or subject.y)
221
+ const x1 = (subject.x1 || 0) - x;
222
+ const x2 = (subject.x2 || 0) - x;
223
+ elements.push(React.createElement("line", { key: "threshold-line", x1: x1, y1: 0, x2: x2, y2: 0, stroke: color || "currentColor", strokeDasharray: "5,5" }));
224
+ }
225
+ else if (subject?.y1 !== undefined || subject?.y2 !== undefined) {
226
+ // Vertical threshold line when only y1/y2 provided (no subject.x or subject.y)
227
+ const y1 = (subject.y1 || 0) - y;
228
+ const y2 = (subject.y2 || 0) - y;
229
+ elements.push(React.createElement("line", { key: "threshold-line", x1: 0, y1: y1, x2: 0, y2: y2, stroke: color || "currentColor", strokeDasharray: "5,5" }));
230
+ }
231
+ break;
232
+ }
233
+ case "bracket": {
234
+ const bracketType = subject?.type || "curly";
235
+ const span = subject?.width ?? subject?.height;
236
+ const depth = subject?.depth || 30;
237
+ const isVertical = subject?.width === undefined;
238
+ if (span !== undefined) {
239
+ elements.push(React.createElement("path", { key: "bracket-path", d: bracketPath(bracketType, span, depth, isVertical), fill: "none", stroke: color || "currentColor" }));
240
+ }
241
+ break;
242
+ }
243
+ }
244
+ return React.createElement("g", { className: "annotation-subject" }, elements);
245
+ }
246
+ function renderConnector(dx, dy, connector, color, type, subject) {
247
+ const elements = [];
248
+ let startX = 0;
249
+ let startY = 0;
250
+ if ((type === "callout-circle" || type === "label") &&
251
+ subject?.radius) {
252
+ const totalRadius = (subject.radius || 0) + (subject.radiusPadding || 0);
253
+ if (totalRadius > 0 && (dx !== 0 || dy !== 0)) {
254
+ const angle = Math.atan2(dy, dx);
255
+ startX = Math.cos(angle) * totalRadius;
256
+ startY = Math.sin(angle) * totalRadius;
257
+ }
258
+ }
259
+ else if (type === "callout-rect" && subject) {
260
+ const w = subject.width || 0;
261
+ const h = subject.height || 0;
262
+ if (w > 0 || h > 0) {
263
+ const cx = w / 2;
264
+ const cy = h / 2;
265
+ const tdx = dx - cx;
266
+ const tdy = dy - cy;
267
+ if (tdx !== 0 || tdy !== 0) {
268
+ const absTdx = Math.abs(tdx);
269
+ const absTdy = Math.abs(tdy);
270
+ const hw = w / 2;
271
+ const hh = h / 2;
272
+ const t = absTdx * hh > absTdy * hw ? hw / absTdx : hh / absTdy;
273
+ startX = cx + tdx * t;
274
+ startY = cy + tdy * t;
275
+ }
276
+ }
277
+ }
278
+ else if (type === "bracket" && subject) {
279
+ const width = subject.width;
280
+ const height = subject.height;
281
+ const depth = subject.depth || 30;
282
+ if (width !== undefined) {
283
+ startX = width / 2;
284
+ startY = depth;
285
+ }
286
+ else if (height !== undefined) {
287
+ startX = depth;
288
+ startY = height / 2;
289
+ }
290
+ }
291
+ const connectorLength = Math.sqrt((dx - startX) ** 2 + (dy - startY) ** 2);
292
+ if (connectorLength > 0.5) {
293
+ elements.push(React.createElement("line", { key: "connector-line", x1: startX, y1: startY, x2: dx, y2: dy, stroke: color || "currentColor" }));
294
+ if (connector?.end === "arrow") {
295
+ const arrowSize = 10;
296
+ const angleOffset = 16 / 180 * Math.PI;
297
+ const angle = Math.atan2(dy - startY, dx - startX);
298
+ const a1x = startX + arrowSize * Math.cos(angle + angleOffset);
299
+ const a1y = startY + arrowSize * Math.sin(angle + angleOffset);
300
+ const a2x = startX + arrowSize * Math.cos(angle - angleOffset);
301
+ const a2y = startY + arrowSize * Math.sin(angle - angleOffset);
302
+ elements.push(React.createElement("path", { key: "connector-arrow", d: `M${startX},${startY}L${a1x},${a1y}L${a2x},${a2y}Z`, fill: color || "currentColor", stroke: "none" }));
303
+ }
304
+ }
305
+ return React.createElement("g", { className: "annotation-connector" }, elements);
306
+ }
307
+ function AnnotationRenderer(props) {
308
+ const { x = 0, y = 0, dx: baseDx, dy: baseDy, nx, ny, note, connector, subject, type, color, className, disable, events = {}, "data-testid": dataTestId } = props;
309
+ const disableSet = new Set(Array.isArray(disable) ? disable : []);
310
+ let dx = baseDx || 0;
311
+ let dy = baseDy || 0;
312
+ if (nx !== undefined && nx !== null)
313
+ dx = nx - x;
314
+ if (ny !== undefined && ny !== null)
315
+ dy = ny - y;
316
+ const resolvedType = typeof type === "string" ? type : "label";
317
+ // For bracket type, auto-position note at bracket midpoint tip
318
+ if (resolvedType === "bracket" && subject && dx === 0 && dy === 0) {
319
+ if (subject.width !== undefined) {
320
+ dx = subject.width / 2;
321
+ const depthVal = subject.depth || 30;
322
+ dy = depthVal + (depthVal >= 0 ? 5 : -5);
323
+ }
324
+ else if (subject.height !== undefined) {
325
+ const depthVal = subject.depth || 30;
326
+ dx = depthVal + (depthVal >= 0 ? 5 : -5);
327
+ dy = subject.height / 2;
328
+ }
329
+ }
330
+ return (React.createElement("g", { className: `annotation ${className || ""}`.trim(), transform: `translate(${x},${y})`, "data-testid": dataTestId, ...events },
331
+ !disableSet.has("connector") && renderConnector(dx, dy, connector, color, resolvedType, subject),
332
+ !disableSet.has("subject") && renderSubject(resolvedType, subject, color, x, y),
333
+ !disableSet.has("note") && renderNote(note, dx, dy, color)));
334
+ }
335
+ function SemioticAnnotation(props) {
336
+ const { noteData } = props;
337
+ const { screenCoordinates } = noteData;
338
+ const annotationType = typeof noteData.type === "string" ? noteData.type : "label";
339
+ const eventListeners = noteData.eventListeners || noteData.events || {};
340
+ if (noteData.coordinates && screenCoordinates) {
341
+ const setNX = noteData.nx || screenCoordinates[0][0] + noteData.dx;
342
+ const setNY = noteData.ny || screenCoordinates[0][1] + noteData.dy;
343
+ const notes = screenCoordinates.map((d, i) => {
344
+ const subjectNote = Object.assign({}, noteData, {
345
+ note: i === 0 ? noteData.note : { label: "" },
346
+ x: d[0],
347
+ y: d[1],
348
+ nx: setNX,
349
+ ny: setNY
350
+ });
351
+ return (React.createElement(AnnotationRenderer, { "data-testid": "semiotic-annotation", key: `multi-annotation-${i}`, ...subjectNote, type: annotationType }));
352
+ });
353
+ return React.createElement("g", null, notes);
354
+ }
355
+ const keyData = noteData.note || { title: "none", label: noteData.label };
356
+ const annotationKey = `${keyData.label}-${keyData.title}-${noteData.i}`;
357
+ return (React.createElement(AnnotationRenderer, { "data-testid": "semiotic-annotation", key: annotationKey, events: eventListeners, ...noteData, type: annotationType }));
358
+ }