@fundar/data-chart-telling 1.1.0 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (539) hide show
  1. package/CHANGELOG.md +45 -0
  2. package/README.md +8 -7
  3. package/dist/configuration/config.svelte.d.ts +1 -1
  4. package/dist/configuration/config.svelte.js +177 -100
  5. package/dist/configuration/themes/index.d.ts +5 -1428
  6. package/dist/index.d.ts +23 -14
  7. package/dist/index.js +20 -11
  8. package/dist/layout/base/BasePlotLayout.svelte +115 -50
  9. package/dist/layout/base/BasePlotLayout.svelte.d.ts +1 -38
  10. package/dist/layout/coordinates/CoordinatesLayout.svelte +42 -40
  11. package/dist/layout/coordinates/CoordinatesLayout.svelte.d.ts +0 -2
  12. package/dist/layout/coordinates/ProjectionZoom.svelte +48 -0
  13. package/dist/layout/coordinates/ProjectionZoom.svelte.d.ts +10 -0
  14. package/dist/layout/coordinates/ZoomedProjection.d.ts +11 -0
  15. package/dist/layout/coordinates/ZoomedProjection.js +24 -0
  16. package/dist/layout/coordinates/camera.svelte.js +11 -8
  17. package/dist/layout/coordinates/projections/argentina.js +1 -1
  18. package/dist/layout/coordinates/projections/fit.d.ts +1 -1
  19. package/dist/layout/coordinates/projections/fit.js +1 -1
  20. package/dist/layout/coordinates/zoom.svelte.d.ts +4 -5
  21. package/dist/layout/coordinates/zoom.svelte.js +4 -5
  22. package/dist/layout/facet/FacetLayout.svelte +1 -1
  23. package/dist/layout/facet/config.js +1 -1
  24. package/dist/layout/facet/scope.d.ts +40 -0
  25. package/dist/layout/facet/scope.js +104 -0
  26. package/dist/layout/figure/Figure.svelte +2 -0
  27. package/dist/layout/geometry/GeometryLayout.svelte +14 -9
  28. package/dist/layout/geometry/GeometryLayout.svelte.d.ts +0 -3
  29. package/dist/layout/geometry/MarkerOffset.svelte +28 -0
  30. package/dist/layout/geometry/MarkerOffset.svelte.d.ts +13 -0
  31. package/dist/layout/grid/GridCell.svelte +6 -8
  32. package/dist/layout/legend/ContinuousSection.svelte +44 -9
  33. package/dist/layout/legend/DiscreteBadgeItem.svelte +2 -2
  34. package/dist/layout/legend/DiscreteSection.svelte +2 -2
  35. package/dist/layout/legend/DiscreteSymbolIcon.svelte +39 -15
  36. package/dist/layout/legend/LegendChannels.js +36 -12
  37. package/dist/layout/legend/LegendLayout.svelte +9 -1
  38. package/dist/layout/legend/LegendState.svelte.d.ts +4 -0
  39. package/dist/layout/legend/LegendState.svelte.js +23 -8
  40. package/dist/layout/legend/SizeSection.svelte +1 -1
  41. package/dist/layout/margins/PlotMargins.svelte.d.ts +2 -5
  42. package/dist/layout/margins/PlotMargins.svelte.js +35 -8
  43. package/dist/layout/plot/Plot.svelte +22 -2
  44. package/dist/layout/plot/Slice.d.ts +5 -1
  45. package/dist/layout/plot/Slice.js +14 -4
  46. package/dist/layout/scales/NiceTicks.d.ts +3 -0
  47. package/dist/layout/scales/NiceTicks.js +4 -0
  48. package/dist/layout/scales/ScalesLayout.svelte +93 -7
  49. package/dist/layout/scales/ScalesLayout.svelte.d.ts +5 -0
  50. package/dist/layout/scales/SveltePlotScale.d.ts +2 -2
  51. package/dist/layout/scales/SveltePlotScale.js +13 -6
  52. package/dist/layout/scales/TickLabels.d.ts +32 -0
  53. package/dist/layout/scales/TickLabels.js +55 -0
  54. package/dist/layout/styles/StylesLayout.svelte +2 -2
  55. package/dist/layout/styles/ValueLabels.d.ts +33 -5
  56. package/dist/layout/styles/ValueLabels.js +80 -21
  57. package/dist/layout/timeline/TimelineLayout.svelte +1 -1
  58. package/dist/layout/tooltip/Tooltip.svelte +4 -4
  59. package/dist/layout/tooltip/Tooltip.svelte.d.ts +4 -4
  60. package/dist/layout/tooltip/TooltipState.svelte.js +1 -1
  61. package/dist/markers/MarkerKinds.d.ts +5 -0
  62. package/dist/markers/MarkerKinds.js +1 -0
  63. package/dist/markers/area/AreaMarker.svelte +15 -63
  64. package/dist/markers/arrow/ArrowMarker.svelte +51 -9
  65. package/dist/markers/bar/BarMarker.svelte +8 -4
  66. package/dist/markers/bollinger/BollingerMarker.svelte +33 -18
  67. package/dist/markers/box/BoxMarker.svelte +40 -9
  68. package/dist/markers/delta/Delta.d.ts +6 -1
  69. package/dist/markers/delta/Delta.js +16 -1
  70. package/dist/markers/delta/DeltaMarker.svelte +9 -87
  71. package/dist/markers/delta/DeltaPoint.svelte +97 -0
  72. package/dist/markers/delta/DeltaPoint.svelte.d.ts +29 -0
  73. package/dist/markers/dot/DotMarker.svelte +24 -27
  74. package/dist/markers/image/ImageMarker.svelte +17 -12
  75. package/dist/markers/inset/InsetMarker.svelte +2 -2
  76. package/dist/markers/line/LineMarker.svelte +1 -0
  77. package/dist/markers/link/LinkMarker.svelte +174 -29
  78. package/dist/markers/regression/RegressionMarker.svelte +16 -33
  79. package/dist/markers/rule/RuleMarker.svelte +14 -5
  80. package/dist/markers/text/Declutter.d.ts +4 -0
  81. package/dist/markers/text/Declutter.js +26 -11
  82. package/dist/markers/text/TextMarker.svelte +91 -48
  83. package/dist/markers/tick/TickMarker.svelte +27 -25
  84. package/dist/markers/utils/MarkerChannels.d.ts +24 -0
  85. package/dist/markers/utils/MarkerChannels.js +42 -7
  86. package/dist/markers/utils/RowOffset.d.ts +23 -0
  87. package/dist/markers/utils/RowOffset.js +23 -0
  88. package/dist/markers/utils/RowOffsetMarks.svelte +30 -0
  89. package/dist/markers/utils/RowOffsetMarks.svelte.d.ts +33 -0
  90. package/dist/markers/utils/RowStroke.d.ts +31 -0
  91. package/dist/markers/utils/RowStroke.js +28 -0
  92. package/dist/markers/violin/ViolinMarker.svelte +75 -0
  93. package/dist/markers/violin/ViolinMarker.svelte.d.ts +7 -0
  94. package/dist/markers/violin/ViolinProfiles.d.ts +29 -0
  95. package/dist/markers/violin/ViolinProfiles.js +55 -0
  96. package/dist/markers/waffle/WaffleMarker.svelte +17 -37
  97. package/dist/phases/Pipeline.d.ts +5 -0
  98. package/dist/phases/Pipeline.js +5 -0
  99. package/dist/phases/data/DataPhase.js +3 -3
  100. package/dist/phases/data/PlotAxes.d.ts +10 -0
  101. package/dist/phases/data/PlotAxes.js +14 -1
  102. package/dist/phases/facet/FacetPanels.d.ts +1 -0
  103. package/dist/phases/facet/FacetPanels.js +1 -0
  104. package/dist/phases/facet/FacetPhase.d.ts +2 -1
  105. package/dist/phases/facet/FacetPhase.js +19 -4
  106. package/dist/phases/mapping/MappingPhase.js +1 -1
  107. package/dist/phases/markers/MarkersPhase.js +2 -1
  108. package/dist/phases/scales/CategoryOrder.d.ts +23 -0
  109. package/dist/phases/scales/CategoryOrder.js +73 -0
  110. package/dist/phases/scales/ScalesPhase.js +21 -7
  111. package/dist/phases/sharedScales/SharedScalesPhase.d.ts +3 -2
  112. package/dist/phases/sharedScales/SharedScalesPhase.js +5 -2
  113. package/dist/phases/statistics/Statistics.d.ts +10 -6
  114. package/dist/phases/statistics/Statistics.js +20 -10
  115. package/dist/phases/statistics/StatisticsPhase.js +16 -3
  116. package/dist/phases/statistics/methods/BollingerStatistic.d.ts +1 -1
  117. package/dist/phases/statistics/methods/BollingerStatistic.js +13 -11
  118. package/dist/phases/statistics/methods/BoxStatistic.d.ts +1 -1
  119. package/dist/phases/statistics/methods/BoxStatistic.js +14 -12
  120. package/dist/phases/statistics/methods/Density2dStatistic.d.ts +1 -1
  121. package/dist/phases/statistics/methods/Density2dStatistic.js +13 -11
  122. package/dist/phases/statistics/methods/DensityStatistic.d.ts +1 -1
  123. package/dist/phases/statistics/methods/DensityStatistic.js +11 -9
  124. package/dist/phases/statistics/methods/DeviationStatistic.d.ts +8 -0
  125. package/dist/phases/statistics/methods/DeviationStatistic.js +111 -0
  126. package/dist/phases/statistics/methods/MovingAverageStatistic.d.ts +1 -1
  127. package/dist/phases/statistics/methods/MovingAverageStatistic.js +11 -9
  128. package/dist/phases/statistics/methods/RegressionStatistic.d.ts +1 -1
  129. package/dist/phases/statistics/methods/RegressionStatistic.js +16 -14
  130. package/dist/phases/transforms/ProcessedPositions.js +1 -1
  131. package/dist/phases/transforms/TransformsPhase.js +49 -3
  132. package/dist/phases/transforms/ValueSelection.d.ts +30 -0
  133. package/dist/phases/transforms/ValueSelection.js +53 -0
  134. package/dist/plots/{heatmap → correlation/heatmap}/Plot.svelte +5 -2
  135. package/dist/plots/{heatmap → correlation/heatmap}/Plot.svelte.d.ts +2 -2
  136. package/dist/plots/{heatmap → correlation/heatmap}/defaults.d.ts +2 -2
  137. package/dist/plots/{heatmap → correlation/heatmap}/defaults.js +5 -5
  138. package/dist/plots/{heatmap → correlation/heatmap}/markers.d.ts +4 -4
  139. package/dist/plots/{heatmap → correlation/heatmap}/markers.js +3 -3
  140. package/dist/plots/{scatter → correlation/scatter}/Plot.svelte +5 -2
  141. package/dist/plots/{scatter → correlation/scatter}/Plot.svelte.d.ts +2 -2
  142. package/dist/plots/{scatter → correlation/scatter}/defaults.d.ts +2 -2
  143. package/dist/plots/{scatter → correlation/scatter}/defaults.js +4 -4
  144. package/dist/plots/{scatter → correlation/scatter}/markers.d.ts +4 -4
  145. package/dist/plots/{scatter → correlation/scatter}/markers.js +3 -3
  146. package/dist/plots/{box → distribution/box}/BoxSummaries.d.ts +2 -2
  147. package/dist/plots/{box → distribution/box}/BoxSummaries.js +6 -6
  148. package/dist/plots/{box → distribution/box}/Plot.svelte +2 -2
  149. package/dist/plots/{box → distribution/box}/Plot.svelte.d.ts +2 -2
  150. package/dist/plots/{box → distribution/box}/defaults.d.ts +2 -2
  151. package/dist/plots/{box → distribution/box}/defaults.js +1 -1
  152. package/dist/plots/{box → distribution/box}/markers.d.ts +2 -2
  153. package/dist/plots/distribution/density/Plot.svelte +45 -0
  154. package/dist/plots/distribution/density/Plot.svelte.d.ts +26 -0
  155. package/dist/plots/distribution/density/defaults.d.ts +9 -0
  156. package/dist/plots/distribution/density/defaults.js +29 -0
  157. package/dist/plots/distribution/density/markers.d.ts +9 -0
  158. package/dist/plots/distribution/density/markers.js +42 -0
  159. package/dist/plots/{histogram → distribution/histogram}/Plot.svelte +2 -2
  160. package/dist/plots/{histogram → distribution/histogram}/Plot.svelte.d.ts +2 -2
  161. package/dist/plots/{histogram → distribution/histogram}/defaults.d.ts +2 -2
  162. package/dist/plots/{histogram → distribution/histogram}/defaults.js +3 -3
  163. package/dist/plots/{histogram → distribution/histogram}/markers.d.ts +3 -3
  164. package/dist/plots/{histogram → distribution/histogram}/markers.js +5 -5
  165. package/dist/plots/{pyramid → distribution/pyramid}/Plot.svelte +5 -2
  166. package/dist/plots/{pyramid → distribution/pyramid}/Plot.svelte.d.ts +2 -2
  167. package/dist/plots/{pyramid → distribution/pyramid}/defaults.d.ts +2 -2
  168. package/dist/plots/{pyramid → distribution/pyramid}/defaults.js +6 -6
  169. package/dist/plots/{pyramid → distribution/pyramid}/markers.d.ts +4 -4
  170. package/dist/plots/{pyramid → distribution/pyramid}/markers.js +6 -6
  171. package/dist/plots/distribution/violin/Plot.svelte +45 -0
  172. package/dist/plots/distribution/violin/Plot.svelte.d.ts +26 -0
  173. package/dist/plots/distribution/violin/defaults.d.ts +10 -0
  174. package/dist/plots/distribution/violin/defaults.js +58 -0
  175. package/dist/plots/distribution/violin/markers.d.ts +10 -0
  176. package/dist/plots/distribution/violin/markers.js +71 -0
  177. package/dist/plots/{area → evolution/area}/Plot.svelte +2 -2
  178. package/dist/plots/{area → evolution/area}/Plot.svelte.d.ts +2 -2
  179. package/dist/plots/{area → evolution/area}/defaults.d.ts +2 -2
  180. package/dist/plots/{area → evolution/area}/defaults.js +2 -0
  181. package/dist/plots/{area → evolution/area}/markers.d.ts +2 -2
  182. package/dist/plots/{area → evolution/area}/markers.js +1 -1
  183. package/dist/plots/{line → evolution/line}/Plot.svelte +2 -2
  184. package/dist/plots/{line → evolution/line}/Plot.svelte.d.ts +2 -2
  185. package/dist/plots/{line → evolution/line}/defaults.d.ts +2 -2
  186. package/dist/plots/{line → evolution/line}/defaults.js +2 -0
  187. package/dist/plots/{line → evolution/line}/markers.d.ts +11 -8
  188. package/dist/plots/{line → evolution/line}/markers.js +6 -4
  189. package/dist/plots/evolution/slope/Plot.svelte +42 -0
  190. package/dist/plots/evolution/slope/Plot.svelte.d.ts +26 -0
  191. package/dist/plots/evolution/slope/defaults.d.ts +8 -0
  192. package/dist/plots/evolution/slope/defaults.js +31 -0
  193. package/dist/plots/evolution/slope/markers.d.ts +16 -0
  194. package/dist/plots/evolution/slope/markers.js +79 -0
  195. package/dist/plots/evolution/sparkline/Plot.svelte +45 -0
  196. package/dist/plots/evolution/sparkline/Plot.svelte.d.ts +26 -0
  197. package/dist/plots/evolution/sparkline/defaults.d.ts +7 -0
  198. package/dist/plots/evolution/sparkline/defaults.js +23 -0
  199. package/dist/plots/evolution/sparkline/markers.d.ts +7 -0
  200. package/dist/plots/evolution/sparkline/markers.js +56 -0
  201. package/dist/plots/{geo → map/geo}/Core.svelte +11 -10
  202. package/dist/plots/{geo → map/geo}/Core.svelte.d.ts +1 -1
  203. package/dist/plots/map/geo/GeoFeatures.svelte.d.ts +9 -0
  204. package/dist/plots/map/geo/GeoFeatures.svelte.js +55 -0
  205. package/dist/plots/map/geo/GeoGeometry.d.ts +27 -0
  206. package/dist/plots/map/geo/GeoGeometry.js +142 -0
  207. package/dist/plots/map/geo/GeoSegments.d.ts +16 -0
  208. package/dist/plots/map/geo/GeoSegments.js +23 -0
  209. package/dist/plots/{geo → map/geo}/Plot.svelte +10 -10
  210. package/dist/plots/{geo → map/geo}/Plot.svelte.d.ts +2 -2
  211. package/dist/plots/{geo → map/geo}/defaults.d.ts +2 -2
  212. package/dist/plots/{geo → map/geo}/defaults.js +1 -1
  213. package/dist/plots/{geo → map/geo}/phases/data.d.ts +1 -1
  214. package/dist/plots/{geo → map/geo}/phases/data.js +7 -6
  215. package/dist/plots/{geo → map/geo}/phases/hover.d.ts +1 -1
  216. package/dist/plots/{geo → map/geo}/phases/hover.js +2 -2
  217. package/dist/plots/{geo → map/geo}/phases/markers.d.ts +1 -1
  218. package/dist/plots/{geo → map/geo}/phases/markers.js +6 -10
  219. package/dist/plots/{geo → map/geo}/phases/scales.d.ts +2 -2
  220. package/dist/plots/{geo → map/geo}/phases/scales.js +28 -12
  221. package/dist/plots/{geo → map/geo}/phases/tooltip.d.ts +1 -1
  222. package/dist/plots/map/geo/phases/tooltip.js +5 -0
  223. package/dist/plots/{geo → map/geo}/slices.d.ts +2 -2
  224. package/dist/plots/{geo → map/geo}/slices.js +2 -2
  225. package/dist/plots/{bar → ranking/bar}/Plot.svelte +2 -2
  226. package/dist/plots/{bar → ranking/bar}/Plot.svelte.d.ts +2 -2
  227. package/dist/plots/ranking/bar/defaults.d.ts +16 -0
  228. package/dist/plots/{bar → ranking/bar}/defaults.js +15 -9
  229. package/dist/plots/{bar → ranking/bar}/markers.d.ts +8 -8
  230. package/dist/plots/{bar → ranking/bar}/markers.js +8 -17
  231. package/dist/plots/ranking/bullet/Plot.svelte +42 -0
  232. package/dist/plots/ranking/bullet/Plot.svelte.d.ts +26 -0
  233. package/dist/plots/ranking/bullet/defaults.d.ts +8 -0
  234. package/dist/plots/ranking/bullet/defaults.js +24 -0
  235. package/dist/plots/ranking/bullet/markers.d.ts +10 -0
  236. package/dist/plots/ranking/bullet/markers.js +90 -0
  237. package/dist/plots/ranking/cleveland/ClevelandConnector.d.ts +48 -0
  238. package/dist/plots/ranking/cleveland/ClevelandConnector.js +140 -0
  239. package/dist/plots/ranking/cleveland/ClevelandMarkers.d.ts +33 -0
  240. package/dist/plots/ranking/cleveland/ClevelandMarkers.js +375 -0
  241. package/dist/plots/ranking/cleveland/ClevelandRanges.d.ts +31 -0
  242. package/dist/plots/ranking/cleveland/ClevelandRanges.js +116 -0
  243. package/dist/plots/ranking/cleveland/Plot.svelte +45 -0
  244. package/dist/plots/ranking/cleveland/Plot.svelte.d.ts +26 -0
  245. package/dist/plots/ranking/cleveland/defaults.d.ts +13 -0
  246. package/dist/plots/ranking/cleveland/defaults.js +66 -0
  247. package/dist/plots/ranking/dumbbell/Plot.svelte +45 -0
  248. package/dist/plots/ranking/dumbbell/Plot.svelte.d.ts +26 -0
  249. package/dist/plots/ranking/dumbbell/defaults.d.ts +9 -0
  250. package/dist/plots/ranking/dumbbell/defaults.js +19 -0
  251. package/dist/plots/ranking/forest/Plot.svelte +42 -0
  252. package/dist/plots/ranking/forest/Plot.svelte.d.ts +26 -0
  253. package/dist/plots/ranking/forest/defaults.d.ts +11 -0
  254. package/dist/plots/ranking/forest/defaults.js +20 -0
  255. package/dist/plots/ranking/lollipop/Plot.svelte +45 -0
  256. package/dist/plots/ranking/lollipop/Plot.svelte.d.ts +26 -0
  257. package/dist/plots/ranking/lollipop/defaults.d.ts +9 -0
  258. package/dist/plots/ranking/lollipop/defaults.js +18 -0
  259. package/dist/plots/utils/RowNumbers.d.ts +16 -0
  260. package/dist/plots/utils/RowNumbers.js +24 -0
  261. package/dist/plots/utils/gaps.js +1 -1
  262. package/dist/plots/utils/segments.d.ts +4 -1
  263. package/dist/plots/utils/segments.js +20 -7
  264. package/dist/types/configuration/styling.d.ts +284 -143
  265. package/dist/types/layout/coordinates.d.ts +5 -4
  266. package/dist/types/layout/facet.d.ts +18 -0
  267. package/dist/types/layout/legend.d.ts +23 -5
  268. package/dist/types/layout/plot.d.ts +46 -1
  269. package/dist/types/layout/scales.d.ts +39 -7
  270. package/dist/types/layout/statistics/deviation.d.ts +40 -0
  271. package/dist/types/layout/statistics/index.d.ts +7 -2
  272. package/dist/types/layout/styles/base.d.ts +18 -0
  273. package/dist/types/layout/styles/bullet.d.ts +25 -0
  274. package/dist/types/layout/styles/connector.d.ts +98 -0
  275. package/dist/types/layout/styles/curve.d.ts +11 -0
  276. package/dist/types/layout/styles/frame.d.ts +17 -0
  277. package/dist/types/layout/styles/gaps.d.ts +12 -0
  278. package/dist/types/layout/styles/geo.d.ts +55 -0
  279. package/dist/types/layout/styles/index.d.ts +8 -0
  280. package/dist/types/layout/styles/index.js +8 -0
  281. package/dist/types/layout/styles/values.d.ts +47 -0
  282. package/dist/types/layout/timeline.d.ts +5 -2
  283. package/dist/types/layout/tooltip.d.ts +6 -2
  284. package/dist/types/markers/axis/area.d.ts +2 -2
  285. package/dist/types/markers/axis/arrow.d.ts +3 -0
  286. package/dist/types/markers/axis/axisBasedMarkersConfig.d.ts +2 -1
  287. package/dist/types/markers/axis/bar.d.ts +1 -1
  288. package/dist/types/markers/axis/box.d.ts +5 -0
  289. package/dist/types/markers/axis/delta.d.ts +15 -2
  290. package/dist/types/markers/axis/difference.d.ts +2 -2
  291. package/dist/types/markers/axis/image.d.ts +3 -2
  292. package/dist/types/markers/axis/line.d.ts +2 -0
  293. package/dist/types/markers/axis/rule.d.ts +18 -2
  294. package/dist/types/markers/axis/trail.d.ts +2 -3
  295. package/dist/types/markers/axis/violin.d.ts +25 -0
  296. package/dist/types/markers/basic/dot.d.ts +3 -2
  297. package/dist/types/markers/basic/text.d.ts +13 -3
  298. package/dist/types/markers/channels/commonMarkerConfig.d.ts +7 -3
  299. package/dist/types/markers/channels/commonMarkerConfigWithRowOffset.d.ts +13 -0
  300. package/dist/types/markers/common.d.ts +1 -1
  301. package/dist/types/markers/common.js +1 -0
  302. package/dist/types/markers/geo/link.d.ts +5 -1
  303. package/dist/types/phases/facet/phase.d.ts +4 -0
  304. package/dist/types/phases/index.d.ts +1 -1
  305. package/dist/types/phases/scales/phase.d.ts +5 -1
  306. package/dist/types/phases/state.d.ts +15 -2
  307. package/dist/types/phases/statistics/source.d.ts +3 -1
  308. package/dist/types/phases/transforms/phase.d.ts +22 -0
  309. package/dist/types/plots/{heatmap → correlation/heatmap}/props.d.ts +6 -6
  310. package/dist/types/plots/{heatmap → correlation/heatmap}/state.d.ts +4 -4
  311. package/dist/types/plots/{scatter → correlation/scatter}/props.d.ts +6 -6
  312. package/dist/types/plots/{scatter → correlation/scatter}/state.d.ts +2 -2
  313. package/dist/types/plots/{box → distribution/box}/props.d.ts +6 -6
  314. package/dist/types/plots/{box → distribution/box}/state.d.ts +3 -3
  315. package/dist/types/plots/distribution/density/props.d.ts +23 -0
  316. package/dist/types/plots/distribution/density/state.d.ts +6 -0
  317. package/dist/types/plots/{histogram → distribution/histogram}/props.d.ts +7 -7
  318. package/dist/types/plots/{histogram → distribution/histogram}/state.d.ts +2 -2
  319. package/dist/types/plots/distribution/histogram/state.js +1 -0
  320. package/dist/types/plots/{pyramid → distribution/pyramid}/props.d.ts +6 -6
  321. package/dist/types/plots/distribution/pyramid/props.js +1 -0
  322. package/dist/types/plots/{pyramid → distribution/pyramid}/state.d.ts +3 -3
  323. package/dist/types/plots/distribution/pyramid/state.js +1 -0
  324. package/dist/types/plots/distribution/violin/props.d.ts +23 -0
  325. package/dist/types/plots/distribution/violin/props.js +1 -0
  326. package/dist/types/plots/distribution/violin/state.d.ts +6 -0
  327. package/dist/types/plots/distribution/violin/state.js +1 -0
  328. package/dist/types/plots/{area → evolution/area}/props.d.ts +6 -6
  329. package/dist/types/plots/evolution/area/props.js +1 -0
  330. package/dist/types/plots/{area → evolution/area}/state.d.ts +2 -2
  331. package/dist/types/plots/evolution/area/state.js +1 -0
  332. package/dist/types/plots/evolution/line/props.d.ts +10 -0
  333. package/dist/types/plots/evolution/line/props.js +1 -0
  334. package/dist/types/plots/{line → evolution/line}/state.d.ts +3 -3
  335. package/dist/types/plots/evolution/line/state.js +1 -0
  336. package/dist/types/plots/evolution/slope/props.d.ts +5 -0
  337. package/dist/types/plots/evolution/slope/props.js +1 -0
  338. package/dist/types/plots/evolution/slope/state.d.ts +5 -0
  339. package/dist/types/plots/evolution/slope/state.js +1 -0
  340. package/dist/types/plots/evolution/sparkline/props.d.ts +5 -0
  341. package/dist/types/plots/evolution/sparkline/props.js +1 -0
  342. package/dist/types/plots/evolution/sparkline/state.d.ts +5 -0
  343. package/dist/types/plots/evolution/sparkline/state.js +1 -0
  344. package/dist/types/plots/{geo → map/geo}/props.d.ts +8 -8
  345. package/dist/types/plots/map/geo/props.js +1 -0
  346. package/dist/types/plots/{geo → map/geo}/state.d.ts +18 -11
  347. package/dist/types/plots/map/geo/state.js +1 -0
  348. package/dist/types/plots/props.d.ts +7 -4
  349. package/dist/types/plots/{bar → ranking/bar}/props.d.ts +6 -6
  350. package/dist/types/plots/ranking/bar/props.js +1 -0
  351. package/dist/types/plots/{bar → ranking/bar}/state.d.ts +2 -2
  352. package/dist/types/plots/ranking/bar/state.js +1 -0
  353. package/dist/types/plots/ranking/bullet/props.d.ts +22 -0
  354. package/dist/types/plots/ranking/bullet/props.js +1 -0
  355. package/dist/types/plots/ranking/bullet/state.d.ts +5 -0
  356. package/dist/types/plots/ranking/bullet/state.js +1 -0
  357. package/dist/types/plots/ranking/cleveland/props.d.ts +10 -0
  358. package/dist/types/plots/ranking/cleveland/props.js +1 -0
  359. package/dist/types/plots/ranking/cleveland/state.d.ts +49 -0
  360. package/dist/types/plots/ranking/cleveland/state.js +1 -0
  361. package/dist/types/plots/ranking/dumbbell/props.d.ts +10 -0
  362. package/dist/types/plots/ranking/dumbbell/props.js +1 -0
  363. package/dist/types/plots/ranking/dumbbell/state.d.ts +5 -0
  364. package/dist/types/plots/ranking/dumbbell/state.js +1 -0
  365. package/dist/types/plots/ranking/forest/props.d.ts +23 -0
  366. package/dist/types/plots/ranking/forest/props.js +1 -0
  367. package/dist/types/plots/ranking/forest/state.d.ts +5 -0
  368. package/dist/types/plots/ranking/forest/state.js +1 -0
  369. package/dist/types/plots/ranking/lollipop/props.d.ts +10 -0
  370. package/dist/types/plots/ranking/lollipop/props.js +1 -0
  371. package/dist/types/plots/ranking/lollipop/state.d.ts +5 -0
  372. package/dist/types/plots/ranking/lollipop/state.js +1 -0
  373. package/dist/types/plots/segments/common.d.ts +4 -1
  374. package/dist/types/plots/segments/config.d.ts +4 -2
  375. package/dist/utils/OpacityScale.d.ts +14 -0
  376. package/dist/utils/OpacityScale.js +43 -0
  377. package/dist/utils/{symbol.d.ts → SymbolPath.d.ts} +0 -12
  378. package/dist/utils/{symbol.js → SymbolPath.js} +0 -24
  379. package/dist/utils/SymbolScale.d.ts +18 -0
  380. package/dist/utils/SymbolScale.js +29 -0
  381. package/dist/utils/color/ColorRamp.d.ts +27 -0
  382. package/dist/utils/color/ColorRamp.js +120 -0
  383. package/dist/utils/color/CssColor.d.ts +19 -0
  384. package/dist/utils/color/CssColor.js +114 -0
  385. package/dist/utils/color/Palette.d.ts +21 -0
  386. package/dist/utils/color/Palette.js +52 -0
  387. package/dist/utils/color/index.d.ts +11 -3
  388. package/dist/utils/color/index.js +14 -3
  389. package/dist/utils/grouping.js +1 -1
  390. package/docs/architecture.md +1 -1
  391. package/docs/chrome.md +2 -2
  392. package/docs/composer.md +2 -2
  393. package/docs/concepts.md +1 -1
  394. package/docs/development.md +1 -1
  395. package/docs/facets.md +50 -3
  396. package/docs/getting-started.md +2 -2
  397. package/docs/legend.md +13 -11
  398. package/docs/markers.md +57 -27
  399. package/docs/plots/correlation/heatmap.md +26 -0
  400. package/docs/plots/correlation/scatter.md +35 -0
  401. package/docs/plots/distribution/box.md +28 -0
  402. package/docs/plots/distribution/density.md +26 -0
  403. package/docs/plots/distribution/histogram.md +33 -0
  404. package/docs/plots/distribution/pyramid.md +31 -0
  405. package/docs/plots/distribution/violin.md +35 -0
  406. package/docs/plots/evolution/area.md +32 -0
  407. package/docs/plots/evolution/line.md +93 -0
  408. package/docs/plots/evolution/slope.md +39 -0
  409. package/docs/plots/evolution/sparkline.md +34 -0
  410. package/docs/plots/ranking/bar.md +59 -0
  411. package/docs/plots/ranking/bullet.md +37 -0
  412. package/docs/plots/ranking/cleveland.md +54 -0
  413. package/docs/plots/ranking/dumbbell.md +39 -0
  414. package/docs/plots/ranking/forest.md +40 -0
  415. package/docs/plots/ranking/lollipop.md +39 -0
  416. package/docs/plots.md +22 -280
  417. package/docs/scales.md +30 -24
  418. package/docs/styles-and-segments.md +25 -21
  419. package/docs/theming.md +23 -20
  420. package/docs/timeline.md +3 -3
  421. package/docs/tooltip-and-hover.md +10 -10
  422. package/docs/transforms-and-statistics.md +13 -12
  423. package/examples/BarValues.svelte +1 -1
  424. package/examples/Box.svelte +1 -1
  425. package/examples/Bullet.svelte +17 -0
  426. package/examples/Chrome.svelte +1 -1
  427. package/examples/ChromeOrder.svelte +1 -1
  428. package/examples/Cleveland.svelte +15 -0
  429. package/examples/Composer.svelte +2 -2
  430. package/examples/CustomTooltip.svelte +1 -1
  431. package/examples/Density.svelte +7 -0
  432. package/examples/Dumbbell.svelte +16 -0
  433. package/examples/Facets.svelte +1 -1
  434. package/examples/FacetsCarousel.svelte +1 -1
  435. package/examples/FacetsRowsCols.svelte +1 -1
  436. package/examples/FacetsScoped.svelte +26 -0
  437. package/examples/FirstPlot.svelte +1 -1
  438. package/examples/Forest.svelte +17 -0
  439. package/examples/Gaps.svelte +2 -2
  440. package/examples/GroupedBars.svelte +1 -1
  441. package/examples/Heatmap.svelte +3 -3
  442. package/examples/HeatmapSegments.svelte +8 -8
  443. package/examples/Histogram.svelte +1 -1
  444. package/examples/HorizontalBars.svelte +1 -1
  445. package/examples/LegendSections.svelte +1 -1
  446. package/examples/LegendToggle.svelte +1 -1
  447. package/examples/LineByRegion.svelte +1 -1
  448. package/examples/LineDates.svelte +1 -1
  449. package/examples/LineStep.svelte +16 -0
  450. package/examples/LineStepSegment.svelte +18 -0
  451. package/examples/Lollipop.svelte +17 -0
  452. package/examples/Markers.svelte +1 -1
  453. package/examples/MovingAverage.svelte +1 -1
  454. package/examples/Pyramid.svelte +9 -2
  455. package/examples/Regression.svelte +2 -2
  456. package/examples/ResponsiveLine.svelte +1 -1
  457. package/examples/Scales.svelte +1 -1
  458. package/examples/Scatter.svelte +2 -2
  459. package/examples/SegmentHighlight.svelte +1 -1
  460. package/examples/Segments.svelte +1 -1
  461. package/examples/SegmentsBySeries.svelte +1 -1
  462. package/examples/Slope.svelte +17 -0
  463. package/examples/Sparkline.svelte +14 -0
  464. package/examples/StackedArea.svelte +1 -1
  465. package/examples/StackedBars.svelte +1 -1
  466. package/examples/TimelinePlayer.svelte +1 -1
  467. package/examples/TimelineRule.svelte +1 -1
  468. package/examples/Tooltip.svelte +1 -1
  469. package/examples/ValueLabels.svelte +1 -1
  470. package/examples/Violin.svelte +14 -0
  471. package/examples/datasets/argentina-chile-trends.ts +34 -0
  472. package/examples/datasets/commodity-prices.ts +48 -0
  473. package/examples/datasets/countries-over-time.ts +368 -0
  474. package/examples/datasets/daily-temperature.ts +121 -0
  475. package/examples/datasets/earthquakes.ts +977 -0
  476. package/examples/datasets/flight-routes.ts +29 -0
  477. package/examples/datasets/height-density.ts +37 -0
  478. package/examples/datasets/heights.ts +370 -0
  479. package/examples/datasets/index.ts +24 -0
  480. package/examples/datasets/inflation-by-region.ts +44 -0
  481. package/examples/datasets/inflation-ranges.ts +34 -0
  482. package/examples/datasets/iris-flower.ts +207 -0
  483. package/examples/datasets/life-expectancy.ts +95 -0
  484. package/examples/datasets/napoleons-march.ts +182 -0
  485. package/examples/datasets/penguins.ts +54 -0
  486. package/examples/datasets/population-by-age-with-gaps.ts +23 -0
  487. package/examples/datasets/population-by-age.ts +890 -0
  488. package/examples/datasets/province-population.ts +521 -0
  489. package/examples/datasets/stock-prices.ts +63 -0
  490. package/examples/datasets/weather-stations-over-time.ts +31 -0
  491. package/examples/datasets/weather-stations.ts +22 -0
  492. package/examples/datasets/wind-vectors.ts +30 -0
  493. package/examples/datasets/world-temperature.ts +400 -0
  494. package/llms-full.txt +27 -14
  495. package/llms.txt +33 -4
  496. package/package.json +10 -1
  497. package/dist/plots/bar/defaults.d.ts +0 -9
  498. package/dist/plots/geo/features.svelte.d.ts +0 -5
  499. package/dist/plots/geo/features.svelte.js +0 -44
  500. package/dist/plots/geo/phases/tooltip.js +0 -5
  501. package/dist/plots/utils/geoAccessors.d.ts +0 -72
  502. package/dist/plots/utils/geoAccessors.js +0 -220
  503. package/dist/plots/utils/geoSegments.d.ts +0 -29
  504. package/dist/plots/utils/geoSegments.js +0 -37
  505. package/dist/types/layout/styles.d.ts +0 -122
  506. package/dist/types/markers/axis/curveName.d.ts +0 -2
  507. package/dist/types/plots/line/props.d.ts +0 -10
  508. package/dist/utils/color/contrast.d.ts +0 -9
  509. package/dist/utils/color/contrast.js +0 -40
  510. package/dist/utils/color/cssColor.d.ts +0 -4
  511. package/dist/utils/color/cssColor.js +0 -77
  512. package/dist/utils/color/ramp.d.ts +0 -17
  513. package/dist/utils/color/ramp.js +0 -110
  514. package/dist/utils/opacity.d.ts +0 -9
  515. package/dist/utils/opacity.js +0 -38
  516. package/examples/data.ts +0 -324
  517. /package/dist/plots/{box → distribution/box}/markers.js +0 -0
  518. /package/dist/types/layout/{styles.js → statistics/deviation.js} +0 -0
  519. /package/dist/types/{markers/axis/curveName.js → layout/styles/base.js} +0 -0
  520. /package/dist/types/{plots/area/props.js → layout/styles/bullet.js} +0 -0
  521. /package/dist/types/{plots/area/state.js → layout/styles/connector.js} +0 -0
  522. /package/dist/types/{plots/bar/props.js → layout/styles/curve.js} +0 -0
  523. /package/dist/types/{plots/bar/state.js → layout/styles/frame.js} +0 -0
  524. /package/dist/types/{plots/box/props.js → layout/styles/gaps.js} +0 -0
  525. /package/dist/types/{plots/box/state.js → layout/styles/geo.js} +0 -0
  526. /package/dist/types/{plots/geo/props.js → layout/styles/values.js} +0 -0
  527. /package/dist/types/{plots/geo/state.js → markers/axis/violin.js} +0 -0
  528. /package/dist/types/{plots/heatmap/props.js → markers/channels/commonMarkerConfigWithRowOffset.js} +0 -0
  529. /package/dist/types/plots/{histogram → correlation/heatmap}/props.js +0 -0
  530. /package/dist/types/plots/{heatmap → correlation/heatmap}/state.js +0 -0
  531. /package/dist/types/plots/{line → correlation/scatter}/props.js +0 -0
  532. /package/dist/types/plots/{histogram → correlation/scatter}/state.js +0 -0
  533. /package/dist/types/plots/{pyramid → distribution/box}/props.js +0 -0
  534. /package/dist/types/plots/{line → distribution/box}/state.js +0 -0
  535. /package/dist/types/plots/{scatter → distribution/density}/props.js +0 -0
  536. /package/dist/types/plots/{pyramid → distribution/density}/state.js +0 -0
  537. /package/dist/types/plots/{scatter/state.js → distribution/histogram/props.js} +0 -0
  538. /package/dist/{plots/utils → utils}/accessors.d.ts +0 -0
  539. /package/dist/{plots/utils → utils}/accessors.js +0 -0
@@ -1,18 +1,18 @@
1
1
  import type { Snippet } from 'svelte';
2
- import type { TooltipAnchorX, TooltipAnchorY } from '../../types/layout/tooltip';
2
+ import type { TooltipAnchorX, TooltipAnchorY, TooltipRow } from '../../types/layout/tooltip';
3
3
  declare function $$render<TRow extends Record<string, unknown>>(): {
4
4
  props: {
5
5
  visible: boolean;
6
6
  x: number;
7
7
  y: number;
8
- /** Every row the hover matched. */
9
- rows: TRow[];
8
+ /** Every row the hover matched, with the color the plot draws it in. */
9
+ rows: TooltipRow<TRow>[];
10
10
  format: (row: TRow) => string;
11
11
  /** The order the `format` text reads the rows in. Unset, as matched. */
12
12
  sort?: (a: TRow, b: TRow) => number;
13
13
  /** Custom tooltip body, given every row; replaces the `format` text and the default box. */
14
14
  content?: Snippet<[{
15
- rows: TRow[];
15
+ rows: TooltipRow<TRow>[];
16
16
  }]>;
17
17
  /** Box the tooltip must stay within. Defaults to its plot's box. */
18
18
  bounds?: {
@@ -1,6 +1,6 @@
1
1
  import { Box } from '../margins/Box';
2
2
  import { PlotMargins } from '../margins/PlotMargins.svelte';
3
- import { resolveAccessor } from '../../plots/utils/accessors';
3
+ import { resolveAccessor } from '../../utils/accessors';
4
4
  import { SERIES_KEY } from '../../phases/transforms/TransformsPhase';
5
5
  import { ValueLabels } from '../styles/ValueLabels';
6
6
  /** A tooltip anchor as the side of the point the tooltip sits on. */
@@ -155,6 +155,11 @@ export declare class MarkerKinds {
155
155
  clip: false;
156
156
  drawsRows: false;
157
157
  };
158
+ violin: {
159
+ clip: true;
160
+ drawsRows: true;
161
+ legendSymbol: "area";
162
+ };
158
163
  voronoi: {
159
164
  clip: true;
160
165
  drawsRows: true;
@@ -38,6 +38,7 @@ export class MarkerKinds {
38
38
  tick: { clip: true, drawsRows: true },
39
39
  trail: { clip: true, drawsRows: true, legendSymbol: 'line' },
40
40
  vector: { clip: false, drawsRows: false },
41
+ violin: { clip: true, drawsRows: true, legendSymbol: 'area' },
41
42
  voronoi: { clip: true, drawsRows: true },
42
43
  voronoiMesh: { clip: true, drawsRows: true },
43
44
  waffle: { clip: true, drawsRows: true }
@@ -15,6 +15,7 @@
15
15
 
16
16
  const plot = usePlot();
17
17
  const isHorizontal = $derived(plot.axes?.isHorizontal ?? false);
18
+ const AreaMark = $derived(isHorizontal ? AreaX : AreaY);
18
19
 
19
20
  const cfg = $derived(getConfiguration());
20
21
  const data = $derived(marker.data ?? []);
@@ -29,82 +30,33 @@
29
30
  const y2 = $derived(hasYBand ? marker.y2 : (marker.y ?? 0));
30
31
  const x1 = $derived(hasXBand ? marker.x1 : 0);
31
32
  const x2 = $derived(hasXBand ? marker.x2 : (marker.x ?? 0));
33
+ /** The band's two ends: along `x` when the plot runs horizontally, else along `y`. */
34
+ const band = $derived(isHorizontal ? { x1, x2 } : { y1, y2 });
32
35
  </script>
33
36
 
34
- {#if opacityBuckets}
35
- {#each opacityBuckets as bucket (bucket.value)}
36
- {#if isHorizontal}
37
- <AreaX
38
- data={bucket.data}
39
- x={marker.x}
40
- {x1}
41
- {x2}
42
- y={marker.y}
43
- z={marker.grouping}
44
- stack={false}
45
- curve={marker.curve}
46
- tension={marker.tension}
47
- fill={channelFill ?? marker.styles?.fill}
48
- fillOpacity={bucket.value}
49
- stroke={marker.styles?.stroke}
50
- strokeWidth={marker.styles?.strokeWidth}
51
- strokeOpacity={marker.styles?.strokeOpacity}
52
- strokeDasharray={marker.styles?.strokeDasharray}
53
- />
54
- {:else}
55
- <AreaY
56
- data={bucket.data}
57
- x={marker.x}
58
- y={marker.y}
59
- {y1}
60
- {y2}
61
- z={marker.grouping}
62
- stack={false}
63
- curve={marker.curve}
64
- tension={marker.tension}
65
- fill={channelFill ?? marker.styles?.fill}
66
- fillOpacity={bucket.value}
67
- stroke={marker.styles?.stroke}
68
- strokeWidth={marker.styles?.strokeWidth}
69
- strokeOpacity={marker.styles?.strokeOpacity}
70
- strokeDasharray={marker.styles?.strokeDasharray}
71
- />
72
- {/if}
73
- {/each}
74
- {:else if isHorizontal}
75
- <AreaX
76
- {data}
37
+ {#snippet area(rows: typeof data, fillOpacity: number | undefined)}
38
+ <AreaMark
39
+ data={rows}
77
40
  x={marker.x}
78
- {x1}
79
- {x2}
80
41
  y={marker.y}
42
+ {...band}
81
43
  z={marker.grouping}
82
44
  stack={false}
83
45
  curve={marker.curve}
84
46
  tension={marker.tension}
85
47
  fill={channelFill ?? marker.styles?.fill}
86
- fillOpacity={marker.styles?.fillOpacity ?? cfg.area.fillOpacity}
48
+ {fillOpacity}
87
49
  stroke={marker.styles?.stroke}
88
50
  strokeWidth={marker.styles?.strokeWidth}
89
51
  strokeOpacity={marker.styles?.strokeOpacity}
90
52
  strokeDasharray={marker.styles?.strokeDasharray}
91
53
  />
54
+ {/snippet}
55
+
56
+ {#if opacityBuckets}
57
+ {#each opacityBuckets as bucket (bucket.value)}
58
+ {@render area(bucket.data, bucket.value)}
59
+ {/each}
92
60
  {:else}
93
- <AreaY
94
- {data}
95
- x={marker.x}
96
- y={marker.y}
97
- {y1}
98
- {y2}
99
- z={marker.grouping}
100
- stack={false}
101
- curve={marker.curve}
102
- tension={marker.tension}
103
- fill={channelFill ?? marker.styles?.fill}
104
- fillOpacity={marker.styles?.fillOpacity ?? cfg.area.fillOpacity}
105
- stroke={marker.styles?.stroke}
106
- strokeWidth={marker.styles?.strokeWidth}
107
- strokeOpacity={marker.styles?.strokeOpacity}
108
- strokeDasharray={marker.styles?.strokeDasharray}
109
- />
61
+ {@render area(data, marker.styles?.fillOpacity ?? cfg.area.fillOpacity)}
110
62
  {/if}
@@ -1,19 +1,61 @@
1
1
  <script lang="ts">
2
2
  import { Arrow } from 'svelteplot';
3
+ import { usePlot } from '../../layout/plot/usePlot';
4
+ import { RowStroke } from '../utils/RowStroke';
3
5
  import type { ArrowMarkerConfig } from '../../types/markers/common';
4
6
 
5
- /** Renders one `'arrow'` marker as `<Arrow>` - a point-to-point annotation. Restates svelteplot's own defaults, which an explicit `undefined` would otherwise erase. */
7
+ /**
8
+ * Renders one `'arrow'` marker as `<Arrow>` - a point-to-point annotation.
9
+ * Restates svelteplot's own defaults, which an explicit `undefined` would
10
+ * otherwise erase. An arrow on a band axis ends at the middle of its band: the
11
+ * `<Arrow>` mark reads its start as the band's first edge and its end as the
12
+ * last, so such an arrow is placed in pixels instead.
13
+ */
6
14
  let { marker }: { marker: ArrowMarkerConfig } = $props();
7
15
 
16
+ const plot = usePlot().svelteplot;
8
17
  const data = $derived(marker.data ?? []);
18
+ /** Each row's own stroke, over the marker's `styles`. */
19
+ const row = $derived(RowStroke.of(marker, marker.styles, { stroke: 'currentColor' }));
20
+
21
+ type Row = Record<string, unknown>;
22
+ type Channel = string | number | ((d: never) => unknown) | undefined;
23
+ /** A channel of a row: a field key, a function of the row, or a literal. */
24
+ const read = (channel: Channel, d: Row) =>
25
+ typeof channel === 'string'
26
+ ? d[channel]
27
+ : typeof channel === 'function'
28
+ ? (channel as (d: Row) => unknown)(d)
29
+ : channel;
30
+ /** Where `value` sits along `axis`, in pixels, at the middle of its band on a band axis. */
31
+ const pixel = (axis: 'x' | 'y', value: unknown) => {
32
+ const scale = plot.scales[axis];
33
+ const at = scale.fn(value as never) as number;
34
+ return scale.type === 'band' ? at + scale.fn.bandwidth() / 2 : at;
35
+ };
36
+ const onBand = $derived(plot.scales.x.type === 'band' || plot.scales.y.type === 'band');
37
+ /** The rows with their ends in pixels, when an axis is a band. */
38
+ const placed = $derived(
39
+ onBand
40
+ ? data.map((d) => ({
41
+ ...d,
42
+ __x1: pixel('x', read(marker.x1, d as Row)),
43
+ __x2: pixel('x', read(marker.x2, d as Row)),
44
+ __y1: pixel('y', read(marker.y1, d as Row)),
45
+ __y2: pixel('y', read(marker.y2, d as Row))
46
+ }))
47
+ : data
48
+ );
49
+ /** A pixel channel the scales leave alone. */
50
+ const own = (key: string) => ({ value: (d: Row) => d[key], scale: null }) as never;
9
51
  </script>
10
52
 
11
53
  <Arrow
12
- {data}
13
- x1={marker.x1}
14
- y1={marker.y1}
15
- x2={marker.x2}
16
- y2={marker.y2}
54
+ data={placed}
55
+ x1={onBand ? own('__x1') : marker.x1}
56
+ y1={onBand ? own('__y1') : marker.y1}
57
+ x2={onBand ? own('__x2') : marker.x2}
58
+ y2={onBand ? own('__y2') : marker.y2}
17
59
  bend={marker.bend}
18
60
  headAngle={marker.headAngle ?? 60}
19
61
  headLength={marker.headLength ?? 8}
@@ -21,8 +63,8 @@
21
63
  insetStart={marker.insetStart}
22
64
  insetEnd={marker.insetEnd}
23
65
  sweep={marker.sweep}
24
- stroke={marker.styles?.stroke ?? 'currentColor'}
25
- strokeWidth={marker.styles?.strokeWidth}
26
- strokeOpacity={marker.styles?.strokeOpacity}
66
+ stroke={row.stroke}
67
+ strokeWidth={row.strokeWidth}
68
+ strokeOpacity={row.strokeOpacity}
27
69
  strokeDasharray={marker.styles?.strokeDasharray}
28
70
  />
@@ -43,14 +43,17 @@
43
43
  {#if marker.role === 'segment'}
44
44
  {@const categoryScale = categoryScaleFor(marker.isHorizontal)}
45
45
  {@const bandwidth = categoryScale?.type === 'band' ? categoryScale.fn.bandwidth() : 0}
46
+ {@const centered =
47
+ marker.thickness != null ? Math.max(0, (bandwidth - marker.thickness) / 2) : undefined}
46
48
  {#if marker.isHorizontal}
47
49
  <BarX
48
50
  {data}
49
51
  y={marker.y}
50
52
  x1={marker.x1}
51
53
  x2={marker.x2}
52
- insetTop={marker.insetTop != null ? marker.insetTop * bandwidth : undefined}
53
- insetBottom={marker.insetBottom != null ? marker.insetBottom * bandwidth : undefined}
54
+ insetTop={centered ?? (marker.insetTop != null ? marker.insetTop * bandwidth : undefined)}
55
+ insetBottom={centered ??
56
+ (marker.insetBottom != null ? marker.insetBottom * bandwidth : undefined)}
54
57
  fill={channelFill ?? marker.styles?.fill}
55
58
  fillOpacity={marker.styles?.fillOpacity}
56
59
  stroke={marker.styles?.stroke}
@@ -65,8 +68,9 @@
65
68
  x={marker.x}
66
69
  y1={marker.y1}
67
70
  y2={marker.y2}
68
- insetLeft={marker.insetLeft != null ? marker.insetLeft * bandwidth : undefined}
69
- insetRight={marker.insetRight != null ? marker.insetRight * bandwidth : undefined}
71
+ insetLeft={centered ?? (marker.insetLeft != null ? marker.insetLeft * bandwidth : undefined)}
72
+ insetRight={centered ??
73
+ (marker.insetRight != null ? marker.insetRight * bandwidth : undefined)}
70
74
  fill={channelFill ?? marker.styles?.fill}
71
75
  fillOpacity={marker.styles?.fillOpacity}
72
76
  stroke={marker.styles?.stroke}
@@ -1,6 +1,10 @@
1
1
  <script lang="ts">
2
+ import { SvelteMap } from 'svelte/reactivity';
2
3
  import { BollingerX, BollingerY } from 'svelteplot';
3
4
  import { usePlot } from '../../layout/plot/usePlot';
5
+ import { MarkerChannels } from '../utils/MarkerChannels';
6
+ import { resolveAccessor } from '../../utils/accessors';
7
+ import { getConfiguration } from '../../configuration/config.svelte';
4
8
  import type { BollingerMarkerConfig } from '../../types/markers/common';
5
9
 
6
10
  /**
@@ -9,36 +13,47 @@
9
13
  * (`usePlot().axes`). A `stroke`-independent `fill`-style option
10
14
  * is deliberately not offered - confirmed empirically to have no visible
11
15
  * effect on svelteplot's own line (see `BollingerStatisticOptions`'s own
12
- * doc comment).
16
+ * doc comment). svelteplot draws one line and one band over all its rows, so
17
+ * with a `grouping` each group is drawn as a mark of its own, in the color
18
+ * the plot gives that group unless `styles` sets one.
13
19
  */
14
20
  let { marker }: { marker: BollingerMarkerConfig } = $props();
15
21
 
16
22
  const plot = usePlot();
17
23
  const isHorizontal = $derived(plot.axes?.isHorizontal ?? false);
24
+ const BollingerMark = $derived(isHorizontal ? BollingerX : BollingerY);
18
25
 
26
+ const cfg = $derived(getConfiguration());
19
27
  const data = $derived(marker.data ?? []);
28
+
29
+ /** The rows of each group, in the order the groups first appear. */
30
+ const groups = $derived.by(() => {
31
+ if (!marker.grouping) return [{ key: 'all', rows: data }];
32
+ const groupOf = resolveAccessor(marker.grouping as never) as (row: unknown) => unknown;
33
+ const byKey = new SvelteMap<string, typeof data>();
34
+ for (const row of data) {
35
+ const key = String(groupOf(row));
36
+ const rows = byKey.get(key);
37
+ if (rows) rows.push(row);
38
+ else byKey.set(key, [row]);
39
+ }
40
+ return [...byKey].map(([key, rows]) => ({ key, rows }));
41
+ });
42
+
43
+ /** What the plot's palette gives a row's group. */
44
+ const groupFill = $derived(MarkerChannels.buildFill(data, marker.grouping, marker.scales, cfg));
20
45
  </script>
21
46
 
22
- {#if isHorizontal}
23
- <BollingerX
24
- {data}
25
- x={marker.x}
26
- y={marker.y}
27
- n={marker.n}
28
- k={marker.k}
29
- stroke={marker.styles?.stroke}
30
- strokeOpacity={marker.styles?.strokeOpacity}
31
- fill={marker.styles?.bandFill}
32
- />
33
- {:else}
34
- <BollingerY
35
- {data}
47
+ {#each groups as group (group.key)}
48
+ {@const color = marker.grouping ? groupFill?.(group.rows[0]) : undefined}
49
+ <BollingerMark
50
+ data={group.rows}
36
51
  x={marker.x}
37
52
  y={marker.y}
38
53
  n={marker.n}
39
54
  k={marker.k}
40
- stroke={marker.styles?.stroke}
55
+ stroke={marker.styles?.stroke ?? color}
41
56
  strokeOpacity={marker.styles?.strokeOpacity}
42
- fill={marker.styles?.bandFill}
57
+ fill={marker.styles?.bandFill ?? color}
43
58
  />
44
- {/if}
59
+ {/each}
@@ -1,7 +1,7 @@
1
1
  <script lang="ts">
2
2
  import { BoxX, BoxY } from 'svelteplot';
3
3
  import { usePlot } from '../../layout/plot/usePlot';
4
- import { contrastTextColor } from '../../utils/color';
4
+ import { CssColor } from '../../utils/color';
5
5
  import { getConfiguration } from '../../configuration/config.svelte';
6
6
  import type { BoxMarkerConfig } from '../../types/markers/common';
7
7
 
@@ -18,6 +18,33 @@
18
18
 
19
19
  const plot = usePlot();
20
20
  const isHorizontal = $derived(plot.axes?.isHorizontal ?? false);
21
+ const BoxMark = $derived(isHorizontal ? BoxX : BoxY);
22
+
23
+ /**
24
+ * With `thickness`, the box is that many pixels across, centered on the
25
+ * marker's share of its category's band (`slot`), instead of filling the band:
26
+ * the bar's insets and every sub-mark's offset follow it.
27
+ */
28
+ const thickness = $derived(marker.thickness);
29
+ const slotIndex = $derived(marker.slot?.index ?? 0);
30
+ const slotCount = $derived(marker.slot?.count ?? 1);
31
+ const bandwidth = $derived.by(() => {
32
+ const scale = isHorizontal ? plot.svelteplot.scales.y : plot.svelteplot.scales.x;
33
+ return scale?.type === 'band' ? scale.fn.bandwidth() : 0;
34
+ });
35
+ const placement = $derived.by(() => {
36
+ if (thickness == null || !bandwidth) return undefined;
37
+ const share = bandwidth / slotCount;
38
+ const offset = share * slotIndex + share / 2 - bandwidth / 2;
39
+ const inset = Math.max(0, (bandwidth - thickness) / 2);
40
+ return {
41
+ inset,
42
+ side: isHorizontal
43
+ ? { insetTop: inset, insetBottom: inset }
44
+ : { insetLeft: inset, insetRight: inset },
45
+ shift: isHorizontal ? { dy: offset } : { dx: offset }
46
+ };
47
+ });
21
48
 
22
49
  // eslint-disable-next-line @typescript-eslint/no-explicit-any
23
50
  const data = $derived((marker.data ?? []) as any[]);
@@ -39,12 +66,15 @@
39
66
  (typeof marker.bar === 'object' && marker.bar.fill != null
40
67
  ? (marker.bar.fill as string)
41
68
  : undefined) ?? cfg.palette[0],
69
+ ...placement?.side,
70
+ ...placement?.shift,
42
71
  ...(typeof marker.bar === 'object' ? marker.bar : {})
43
72
  });
44
73
  const barFill = $derived(bar.fill as string);
45
74
 
46
75
  /** `bar.insetLeft`/`insetRight` averaged into one symmetric value - a tick's own `inset` is a single number/percentage, not independent left/right. */
47
76
  const tickInset = $derived.by(() => {
77
+ if (placement) return placement.inset;
48
78
  const l = typeof bar.insetLeft === 'number' ? bar.insetLeft : undefined;
49
79
  const r = typeof bar.insetRight === 'number' ? bar.insetRight : undefined;
50
80
  if (l === undefined && r === undefined) return undefined;
@@ -77,14 +107,19 @@
77
107
  return out;
78
108
  }
79
109
 
80
- const ruleDefault = $derived(lineStyleDefaults(barFill));
81
- const dotDefault = $derived(fillStyleDefaults());
110
+ const ruleDefault = $derived({ ...lineStyleDefaults(barFill), ...placement?.shift });
111
+ const dotDefault: Record<string, unknown> = $derived({
112
+ ...fillStyleDefaults(),
113
+ ...placement?.shift
114
+ });
82
115
  const tickMedianDefault = $derived({
83
- ...lineStyleDefaults(contrastTextColor(barFill)),
116
+ ...lineStyleDefaults(CssColor.contrastText(barFill)),
117
+ ...placement?.shift,
84
118
  ...(tickInset !== undefined ? { inset: tickInset } : {})
85
119
  });
86
120
  const tickMinMaxDefault = $derived({
87
121
  ...lineStyleDefaults(barFill),
122
+ ...placement?.shift,
88
123
  ...(tickInset !== undefined ? { inset: tickInset } : {})
89
124
  });
90
125
 
@@ -136,8 +171,4 @@
136
171
  });
137
172
  </script>
138
173
 
139
- {#if isHorizontal}
140
- <BoxX {data} x={marker.x} y={marker.y} sort={marker.sort} {...passthrough} />
141
- {:else}
142
- <BoxY {data} x={marker.x} y={marker.y} sort={marker.sort} {...passthrough} />
143
- {/if}
174
+ <BoxMark {data} x={marker.x} y={marker.y} sort={marker.sort} {...passthrough} />
@@ -1,5 +1,5 @@
1
1
  import type { Series } from '../../types/plots/data/common';
2
- import type { DeltaConfig } from '../../types/markers/axis/delta';
2
+ import type { DeltaConfig, DeltaMarkerConfig, DeltaPointConfig } from '../../types/markers/axis/delta';
3
3
  /** A delta, measured: where it sits (`at`), its two ends and what lies between. */
4
4
  export type ResolvedDelta = {
5
5
  cfg: DeltaConfig;
@@ -16,6 +16,11 @@ export type ResolvedDelta = {
16
16
  */
17
17
  export declare class Delta {
18
18
  #private;
19
+ /**
20
+ * The deltas a marker draws: one for its `at`, or one for each position of a list, each with the
21
+ * `line`, `text` and `dot` its style functions give for that position.
22
+ */
23
+ static points(marker: DeltaMarkerConfig): DeltaPointConfig[];
19
24
  /** The delta `config` asks for over `allSeries`, or `undefined` while an end has no value there. */
20
25
  static build<T extends Record<string, unknown>>(axis: 'x' | 'y', allSeries: Series<T>[], config: DeltaConfig): ResolvedDelta | undefined;
21
26
  }
@@ -1,10 +1,25 @@
1
- import { resolveAccessor } from '../../plots/utils/accessors';
1
+ import { resolveAccessor } from '../../utils/accessors';
2
2
  /**
3
3
  * A delta marker's measure: the gap, at one position along `axis`, between
4
4
  * the two curves (or axis lines) it compares. A target series is read where
5
5
  * it crosses that position, interpolated linearly between its two nearest points.
6
6
  */
7
7
  export class Delta {
8
+ /**
9
+ * The deltas a marker draws: one for its `at`, or one for each position of a list, each with the
10
+ * `line`, `text` and `dot` its style functions give for that position.
11
+ */
12
+ static points(marker) {
13
+ const positions = Array.isArray(marker.at) ? marker.at : [marker.at];
14
+ const own = (style, at) => typeof style === 'function' ? style(at) : style;
15
+ return positions.map((at) => ({
16
+ ...marker,
17
+ at,
18
+ line: own(marker.line, at),
19
+ text: own(marker.text, at),
20
+ dot: own(marker.dot, at)
21
+ }));
22
+ }
8
23
  /** The delta `config` asks for over `allSeries`, or `undefined` while an end has no value there. */
9
24
  static build(axis, allSeries, config) {
10
25
  const at = Number(config.at);
@@ -1,96 +1,18 @@
1
1
  <script lang="ts" generics="TData extends Record<string, unknown>">
2
- import { Line } from 'svelteplot';
3
- import DotMarker from '../dot/DotMarker.svelte';
4
- import TextMarker from '../text/TextMarker.svelte';
2
+ import DeltaPoint from './DeltaPoint.svelte';
5
3
  import { Delta } from './Delta';
6
- import { getConfiguration } from '../../configuration/config.svelte';
7
4
  import type { Series } from '../../types/plots/data/common';
8
5
  import type { DeltaMarkerConfig } from '../../types/markers/axis/delta';
9
6
 
7
+ /**
8
+ * A delta annotation: one at `marker.at`, or, when it is a list, one at each position - all with the
9
+ * same ends. `line`, `text` and `dot` can be functions of the position.
10
+ */
10
11
  let { marker, data = [] }: { marker: DeltaMarkerConfig; data?: Series<TData>[] } = $props();
11
12
 
12
- const resolved = $derived(Delta.build(marker.axis, data, marker));
13
- const label = $derived(getConfiguration().delta.text[marker.axis]);
14
- const lineAnchor = $derived(marker.text?.lineAnchor ?? label.lineAnchor);
15
-
16
- const clampRange = $derived.by((): [number, number] | undefined => {
17
- const domain = marker.axis === 'x' ? marker.yDomain : marker.xDomain;
18
- if (!domain || domain.length < 2) return undefined;
19
- const lo = Number(domain[0]);
20
- const hi = Number(domain[domain.length - 1]);
21
- return isNaN(lo) || isNaN(hi) ? undefined : [Math.min(lo, hi), Math.max(lo, hi)];
22
- });
23
-
24
- function clamp(v: number): number {
25
- return clampRange ? Math.max(clampRange[0], Math.min(clampRange[1], v)) : v;
26
- }
27
-
28
- function pt(fixed: number, varying: number) {
29
- return marker.axis === 'x' ? { x: fixed, y: varying } : { x: varying, y: fixed };
30
- }
31
-
32
- function textVaryCoord(fromVis: number, toVis: number) {
33
- return lineAnchor === 'top'
34
- ? Math.max(fromVis, toVis)
35
- : lineAnchor === 'bottom'
36
- ? Math.min(fromVis, toVis)
37
- : (fromVis + toVis) / 2;
38
- }
39
-
40
- // Pre-derive all coordinates as script-level signals so prop getters read safe
41
- // values during Svelte 5 teardown, before the {#if} guard finishes unmounting.
42
- const coords = $derived.by(() => {
43
- if (!resolved) return null;
44
- const fromVis = clamp(resolved.from ?? 0);
45
- const toVis = clamp(resolved.to ?? 0);
46
- const at = resolved.at ?? 0;
47
- return {
48
- fromPt: pt(at, fromVis),
49
- toPt: pt(at, toVis),
50
- textPt: pt(at, textVaryCoord(fromVis, toVis)),
51
- lineData: [pt(at, fromVis), pt(at, toVis)],
52
- diff: resolved.diff ?? 0
53
- };
54
- });
55
-
56
- const dotStyles = $derived({
57
- dotRadius: 4,
58
- dotFill: marker.line?.stroke,
59
- dotStroke: marker.line?.stroke,
60
- dotStrokeWidth: 2,
61
- ...marker.dot
62
- });
13
+ const points = $derived(Delta.points(marker));
63
14
  </script>
64
15
 
65
- {#if coords}
66
- <Line
67
- data={coords.lineData}
68
- x={(p) => p.x}
69
- y={(p) => p.y}
70
- stroke={marker.line?.stroke ?? 'currentColor'}
71
- strokeWidth={marker.line?.strokeWidth ?? 2}
72
- strokeOpacity={marker.line?.strokeOpacity ?? 0.8}
73
- strokeDasharray={marker.line?.strokeDasharray ?? '6 6'}
74
- strokeLinecap={marker.line?.strokeLinecap ?? 'round'}
75
- />
76
- <DotMarker marker={{ type: 'dot', x: coords.fromPt.x, y: coords.fromPt.y, styles: dotStyles }} />
77
- <DotMarker marker={{ type: 'dot', x: coords.toPt.x, y: coords.toPt.y, styles: dotStyles }} />
78
- <TextMarker
79
- marker={{
80
- type: 'text',
81
- x: coords.textPt.x,
82
- y: coords.textPt.y,
83
- text: (marker.formatDiff ?? ((v: number) => v.toFixed(1)))(coords.diff),
84
- styles: {
85
- fontWeight: 'bold',
86
- fontSize: 14,
87
- textAnchor: label.textAnchor,
88
- fill: marker.line?.stroke ?? 'currentColor',
89
- ...marker.text,
90
- dx: marker.text?.dx ?? label.dx,
91
- dy: marker.text?.dy ?? label.dy,
92
- lineAnchor
93
- }
94
- }}
95
- />
96
- {/if}
16
+ {#each points as point (String(point.at))}
17
+ <DeltaPoint marker={point} {data} />
18
+ {/each}