@d3plus/core 3.1.6 → 4.1.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 (579) hide show
  1. package/README.md +9924 -78528
  2. package/es/index.js +8 -0
  3. package/es/index.js.map +1 -1
  4. package/es/internal.js +54 -0
  5. package/es/internal.js.map +1 -0
  6. package/es/src/charts/AreaPlot/index.js +36 -0
  7. package/es/src/charts/AreaPlot/index.js.map +1 -0
  8. package/es/src/charts/BarChart/index.js +48 -0
  9. package/es/src/charts/BarChart/index.js.map +1 -0
  10. package/es/src/charts/BoxWhisker/index.js +52 -0
  11. package/es/src/charts/BoxWhisker/index.js.map +1 -0
  12. package/es/src/charts/BumpChart/index.js +81 -0
  13. package/es/src/charts/BumpChart/index.js.map +1 -0
  14. package/es/src/charts/Donut/index.js +42 -0
  15. package/es/src/charts/Donut/index.js.map +1 -0
  16. package/es/src/charts/Geomap/applyLayout.js +208 -0
  17. package/es/src/charts/Geomap/applyLayout.js.map +1 -0
  18. package/es/src/charts/Geomap/emit.js +169 -0
  19. package/es/src/charts/Geomap/emit.js.map +1 -0
  20. package/es/src/charts/Geomap/index.js +521 -0
  21. package/es/src/charts/Geomap/index.js.map +1 -0
  22. package/es/src/charts/LinePlot/index.js +32 -0
  23. package/es/src/charts/LinePlot/index.js.map +1 -0
  24. package/es/src/charts/Matrix/applyLayout.js +92 -0
  25. package/es/src/charts/Matrix/applyLayout.js.map +1 -0
  26. package/es/src/charts/Matrix/emit.js +44 -0
  27. package/es/src/charts/Matrix/emit.js.map +1 -0
  28. package/es/src/charts/Matrix/index.js +154 -0
  29. package/es/src/charts/Matrix/index.js.map +1 -0
  30. package/es/src/charts/Network/applyLayout.js +322 -0
  31. package/es/src/charts/Network/applyLayout.js.map +1 -0
  32. package/es/src/charts/Network/emit.js +273 -0
  33. package/es/src/charts/Network/emit.js.map +1 -0
  34. package/es/src/charts/Network/index.js +422 -0
  35. package/es/src/charts/Network/index.js.map +1 -0
  36. package/es/src/charts/Pack/applyLayout.js +46 -0
  37. package/es/src/charts/Pack/applyLayout.js.map +1 -0
  38. package/es/src/charts/Pack/emit.js +116 -0
  39. package/es/src/charts/Pack/emit.js.map +1 -0
  40. package/es/src/charts/Pack/index.js +194 -0
  41. package/es/src/charts/Pack/index.js.map +1 -0
  42. package/es/src/charts/Pack/recursionCircles.js +18 -0
  43. package/es/src/charts/Pack/recursionCircles.js.map +1 -0
  44. package/es/src/charts/Pie/applyLayout.js +44 -0
  45. package/es/src/charts/Pie/applyLayout.js.map +1 -0
  46. package/es/src/charts/Pie/emit.js +111 -0
  47. package/es/src/charts/Pie/emit.js.map +1 -0
  48. package/es/src/charts/Pie/index.js +134 -0
  49. package/es/src/charts/Pie/index.js.map +1 -0
  50. package/es/src/charts/Plot/draw.js +424 -0
  51. package/es/src/charts/Plot/draw.js.map +1 -0
  52. package/es/src/charts/Plot/index.js +827 -0
  53. package/es/src/charts/Plot/index.js.map +1 -0
  54. package/es/src/charts/Plot/labelPlacement.js +36 -0
  55. package/es/src/charts/Plot/labelPlacement.js.map +1 -0
  56. package/es/src/charts/Plot/pipeline.js +594 -0
  57. package/es/src/charts/Plot/pipeline.js.map +1 -0
  58. package/es/src/charts/Plot/pipelineDomains.js +254 -0
  59. package/es/src/charts/Plot/pipelineDomains.js.map +1 -0
  60. package/es/src/charts/Plot/pipelineLineLabels.js +210 -0
  61. package/es/src/charts/Plot/pipelineLineLabels.js.map +1 -0
  62. package/es/src/charts/Plot/shapeDefaults.js +189 -0
  63. package/es/src/charts/Plot/shapeDefaults.js.map +1 -0
  64. package/es/src/charts/Plot/stackHelpers.js +52 -0
  65. package/es/src/charts/Plot/stackHelpers.js.map +1 -0
  66. package/es/src/charts/Priestley/applyLayout.js +121 -0
  67. package/es/src/charts/Priestley/applyLayout.js.map +1 -0
  68. package/es/src/charts/Priestley/emit.js +129 -0
  69. package/es/src/charts/Priestley/emit.js.map +1 -0
  70. package/es/src/charts/Priestley/index.js +97 -0
  71. package/es/src/charts/Priestley/index.js.map +1 -0
  72. package/es/src/charts/Radar/applyLayout.js +326 -0
  73. package/es/src/charts/Radar/applyLayout.js.map +1 -0
  74. package/es/src/charts/Radar/emit.js +28 -0
  75. package/es/src/charts/Radar/emit.js.map +1 -0
  76. package/es/src/charts/Radar/index.js +98 -0
  77. package/es/src/charts/Radar/index.js.map +1 -0
  78. package/es/src/charts/RadialMatrix/applyLayout.js +132 -0
  79. package/es/src/charts/RadialMatrix/applyLayout.js.map +1 -0
  80. package/es/src/charts/RadialMatrix/emit.js +33 -0
  81. package/es/src/charts/RadialMatrix/emit.js.map +1 -0
  82. package/es/src/charts/RadialMatrix/index.js +144 -0
  83. package/es/src/charts/RadialMatrix/index.js.map +1 -0
  84. package/es/src/charts/Rings/applyLayout.js +508 -0
  85. package/es/src/charts/Rings/applyLayout.js.map +1 -0
  86. package/es/src/charts/Rings/emit.js +222 -0
  87. package/es/src/charts/Rings/emit.js.map +1 -0
  88. package/es/src/charts/Rings/index.js +245 -0
  89. package/es/src/charts/Rings/index.js.map +1 -0
  90. package/es/src/charts/Sankey/applyLayout.js +107 -0
  91. package/es/src/charts/Sankey/applyLayout.js.map +1 -0
  92. package/es/src/charts/Sankey/emit.js +134 -0
  93. package/es/src/charts/Sankey/emit.js.map +1 -0
  94. package/es/src/charts/Sankey/index.js +219 -0
  95. package/es/src/charts/Sankey/index.js.map +1 -0
  96. package/es/src/charts/StackedArea/index.js +27 -0
  97. package/es/src/charts/StackedArea/index.js.map +1 -0
  98. package/es/src/charts/Tree/applyLayout.js +233 -0
  99. package/es/src/charts/Tree/applyLayout.js.map +1 -0
  100. package/es/src/charts/Tree/emit.js +257 -0
  101. package/es/src/charts/Tree/emit.js.map +1 -0
  102. package/es/src/charts/Tree/index.js +105 -0
  103. package/es/src/charts/Tree/index.js.map +1 -0
  104. package/es/src/charts/Treemap/applyLayout.js +85 -0
  105. package/es/src/charts/Treemap/applyLayout.js.map +1 -0
  106. package/es/src/charts/Treemap/emit.js +141 -0
  107. package/es/src/charts/Treemap/emit.js.map +1 -0
  108. package/es/src/charts/Treemap/index.js +177 -0
  109. package/es/src/charts/Treemap/index.js.map +1 -0
  110. package/es/src/charts/Treemap/thresholdFunction.js +112 -0
  111. package/es/src/charts/Treemap/thresholdFunction.js.map +1 -0
  112. package/es/src/charts/definition/ChartDefinition.js +12 -0
  113. package/es/src/charts/definition/ChartDefinition.js.map +1 -0
  114. package/es/src/charts/definition/applyDefinition.js +107 -0
  115. package/es/src/charts/definition/applyDefinition.js.map +1 -0
  116. package/es/src/charts/definition/makeChart.js +153 -0
  117. package/es/src/charts/definition/makeChart.js.map +1 -0
  118. package/es/src/charts/drawSteps/zoomControls.js +231 -96
  119. package/es/src/charts/drawSteps/zoomControls.js.map +1 -1
  120. package/es/src/charts/events/click.legend.js +2 -2
  121. package/es/src/charts/events/click.legend.js.map +1 -1
  122. package/es/src/charts/events/click.shape.js +5 -5
  123. package/es/src/charts/events/click.shape.js.map +1 -1
  124. package/es/src/charts/events/mouseenter.js +20 -1
  125. package/es/src/charts/events/mouseenter.js.map +1 -1
  126. package/es/src/charts/events/mouseleave.js +19 -4
  127. package/es/src/charts/events/mouseleave.js.map +1 -1
  128. package/es/src/charts/events/mousemove.legend.js +10 -10
  129. package/es/src/charts/events/mousemove.legend.js.map +1 -1
  130. package/es/src/charts/events/mousemove.shape.js +14 -8
  131. package/es/src/charts/events/mousemove.shape.js.map +1 -1
  132. package/es/src/charts/events/touchstart.body.js.map +1 -1
  133. package/es/src/charts/features/axes.js +432 -0
  134. package/es/src/charts/features/axes.js.map +1 -0
  135. package/es/src/charts/features/chartGeometry.js +66 -0
  136. package/es/src/charts/features/chartGeometry.js.map +1 -0
  137. package/es/src/charts/features/colorScaleBucket.js +92 -0
  138. package/es/src/charts/features/colorScaleBucket.js.map +1 -0
  139. package/es/src/charts/features/emitHelpers.js +217 -0
  140. package/es/src/charts/features/emitHelpers.js.map +1 -0
  141. package/es/src/charts/features/ensureZoomDom.js +71 -0
  142. package/es/src/charts/features/ensureZoomDom.js.map +1 -0
  143. package/es/src/charts/features/features.js +650 -0
  144. package/es/src/charts/features/features.js.map +1 -0
  145. package/es/src/charts/features/featuresLegend.js +180 -0
  146. package/es/src/charts/features/featuresLegend.js.map +1 -0
  147. package/es/src/charts/features/legendLabel.js +12 -0
  148. package/es/src/charts/features/legendLabel.js.map +1 -0
  149. package/es/src/charts/features/lineLabels.js +154 -0
  150. package/es/src/charts/features/lineLabels.js.map +1 -0
  151. package/es/src/charts/features/plotPaint.js +512 -0
  152. package/es/src/charts/features/plotPaint.js.map +1 -0
  153. package/es/src/charts/features/shapeEmit.js +273 -0
  154. package/es/src/charts/features/shapeEmit.js.map +1 -0
  155. package/es/src/charts/helpers/matrixData.js +3 -3
  156. package/es/src/charts/helpers/matrixData.js.map +1 -1
  157. package/es/src/charts/index.js +21 -21
  158. package/es/src/charts/index.js.map +1 -1
  159. package/es/src/charts/pipeline/resolveSpec.js +44 -0
  160. package/es/src/charts/pipeline/resolveSpec.js.map +1 -0
  161. package/es/src/charts/pipeline/runChartDraw.js +109 -0
  162. package/es/src/charts/pipeline/runChartDraw.js.map +1 -0
  163. package/es/src/charts/pipeline/runVizPipeline.js +84 -0
  164. package/es/src/charts/pipeline/runVizPipeline.js.map +1 -0
  165. package/es/src/charts/pipeline/stages.js +103 -0
  166. package/es/src/charts/pipeline/stages.js.map +1 -0
  167. package/es/src/charts/pipeline/vizContext.js +29 -0
  168. package/es/src/charts/pipeline/vizContext.js.map +1 -0
  169. package/es/src/charts/pipeline/vizDraw.js +37 -0
  170. package/es/src/charts/pipeline/vizDraw.js.map +1 -0
  171. package/es/src/charts/pipeline/vizDrawPure.js +174 -0
  172. package/es/src/charts/pipeline/vizDrawPure.js.map +1 -0
  173. package/es/src/charts/pipeline/vizPreDraw.js +145 -0
  174. package/es/src/charts/pipeline/vizPreDraw.js.map +1 -0
  175. package/es/src/charts/pipeline/vizPreDrawPure.js +279 -0
  176. package/es/src/charts/pipeline/vizPreDrawPure.js.map +1 -0
  177. package/es/src/charts/plotBuffers/Bar.js +4 -4
  178. package/es/src/charts/plotBuffers/Bar.js.map +1 -1
  179. package/es/src/charts/plotBuffers/Box.js +4 -4
  180. package/es/src/charts/plotBuffers/Box.js.map +1 -1
  181. package/es/src/charts/plotBuffers/Circle.js +2 -2
  182. package/es/src/charts/plotBuffers/Circle.js.map +1 -1
  183. package/es/src/charts/plotBuffers/Line.js +5 -5
  184. package/es/src/charts/plotBuffers/Line.js.map +1 -1
  185. package/es/src/charts/plotBuffers/Rect.js +2 -2
  186. package/es/src/charts/plotBuffers/Rect.js.map +1 -1
  187. package/es/src/charts/plotBuffers/discreteBuffer.js +1 -2
  188. package/es/src/charts/plotBuffers/discreteBuffer.js.map +1 -1
  189. package/es/src/charts/plotBuffers/numericBuffer.js +1 -2
  190. package/es/src/charts/plotBuffers/numericBuffer.js.map +1 -1
  191. package/es/src/charts/viz/Viz.js +985 -0
  192. package/es/src/charts/viz/Viz.js.map +1 -0
  193. package/es/src/charts/viz/VizBase.js +447 -0
  194. package/es/src/charts/viz/VizBase.js.map +1 -0
  195. package/es/src/charts/viz/VizBaseConfig.js +504 -0
  196. package/es/src/charts/viz/VizBaseConfig.js.map +1 -0
  197. package/es/src/charts/viz/interactionOpacity.js +247 -0
  198. package/es/src/charts/viz/interactionOpacity.js.map +1 -0
  199. package/es/src/charts/viz/ordinalColor.js +71 -0
  200. package/es/src/charts/viz/ordinalColor.js.map +1 -0
  201. package/es/src/charts/viz/trailCatchup.js +127 -0
  202. package/es/src/charts/viz/trailCatchup.js.map +1 -0
  203. package/es/src/charts/viz/vizDefaults.js +602 -0
  204. package/es/src/charts/viz/vizDefaults.js.map +1 -0
  205. package/es/src/charts/viz/vizRender.js +251 -0
  206. package/es/src/charts/viz/vizRender.js.map +1 -0
  207. package/es/src/charts/viz/vizTypes.js +28 -0
  208. package/es/src/charts/viz/vizTypes.js.map +1 -0
  209. package/es/src/components/Axis/Axis.js +691 -0
  210. package/es/src/components/Axis/Axis.js.map +1 -0
  211. package/es/src/components/Axis/AxisBottom.js.map +1 -0
  212. package/es/src/components/Axis/AxisLeft.js.map +1 -0
  213. package/es/src/components/Axis/AxisRight.js.map +1 -0
  214. package/es/src/components/Axis/AxisTop.js.map +1 -0
  215. package/es/src/components/Axis/axisLayout.js +208 -0
  216. package/es/src/components/Axis/axisLayout.js.map +1 -0
  217. package/es/src/components/Axis/axisLayoutLabels.js +177 -0
  218. package/es/src/components/Axis/axisLayoutLabels.js.map +1 -0
  219. package/es/src/components/Axis/axisLayoutScale.js +374 -0
  220. package/es/src/components/Axis/axisLayoutScale.js.map +1 -0
  221. package/es/src/components/Axis/axisRender.js +535 -0
  222. package/es/src/components/Axis/axisRender.js.map +1 -0
  223. package/es/src/components/ColorScale/ColorScale.js +506 -0
  224. package/es/src/components/ColorScale/ColorScale.js.map +1 -0
  225. package/es/src/components/ColorScale/colorScaleRender.js +277 -0
  226. package/es/src/components/ColorScale/colorScaleRender.js.map +1 -0
  227. package/es/src/components/ColorScale/colorScaleScale.js +274 -0
  228. package/es/src/components/ColorScale/colorScaleScale.js.map +1 -0
  229. package/es/src/components/Legend/Legend.js +445 -0
  230. package/es/src/components/Legend/Legend.js.map +1 -0
  231. package/es/src/components/Legend/legendConfig.js +87 -0
  232. package/es/src/components/Legend/legendConfig.js.map +1 -0
  233. package/es/src/components/Legend/legendRender.js +245 -0
  234. package/es/src/components/Legend/legendRender.js.map +1 -0
  235. package/es/src/components/Message.js.map +1 -1
  236. package/es/src/components/TextBox.js +655 -453
  237. package/es/src/components/TextBox.js.map +1 -1
  238. package/es/src/components/Timeline/Timeline.js +674 -0
  239. package/es/src/components/Timeline/Timeline.js.map +1 -0
  240. package/es/src/components/Timeline/timelineConfig.js +115 -0
  241. package/es/src/components/Timeline/timelineConfig.js.map +1 -0
  242. package/es/src/components/Timeline/timelineRender.js +267 -0
  243. package/es/src/components/Timeline/timelineRender.js.map +1 -0
  244. package/es/src/components/Tooltip.js +288 -249
  245. package/es/src/components/Tooltip.js.map +1 -1
  246. package/es/src/components/index.js +8 -8
  247. package/es/src/components/index.js.map +1 -1
  248. package/es/src/fluent.js +265 -0
  249. package/es/src/fluent.js.map +1 -0
  250. package/es/src/shapes/Area.js +96 -114
  251. package/es/src/shapes/Area.js.map +1 -1
  252. package/es/src/shapes/Bar.js +71 -86
  253. package/es/src/shapes/Bar.js.map +1 -1
  254. package/es/src/shapes/Box.js +295 -190
  255. package/es/src/shapes/Box.js.map +1 -1
  256. package/es/src/shapes/Circle.js +84 -35
  257. package/es/src/shapes/Circle.js.map +1 -1
  258. package/es/src/shapes/Image.js +164 -85
  259. package/es/src/shapes/Image.js.map +1 -1
  260. package/es/src/shapes/Line.js +51 -94
  261. package/es/src/shapes/Line.js.map +1 -1
  262. package/es/src/shapes/Path.js +33 -41
  263. package/es/src/shapes/Path.js.map +1 -1
  264. package/es/src/shapes/Rect.js +86 -37
  265. package/es/src/shapes/Rect.js.map +1 -1
  266. package/es/src/shapes/Shape.js +655 -678
  267. package/es/src/shapes/Shape.js.map +1 -1
  268. package/es/src/shapes/Whisker.js +156 -61
  269. package/es/src/shapes/Whisker.js.map +1 -1
  270. package/es/src/shapes/buildLabelData.js +125 -0
  271. package/es/src/shapes/buildLabelData.js.map +1 -0
  272. package/es/src/shapes/emitLabels.js +84 -0
  273. package/es/src/shapes/emitLabels.js.map +1 -0
  274. package/es/src/shapes/hitAreaNode.js +37 -0
  275. package/es/src/shapes/hitAreaNode.js.map +1 -0
  276. package/es/src/shapes/sceneSort.js +57 -0
  277. package/es/src/shapes/sceneSort.js.map +1 -0
  278. package/es/src/shapes/shapeConfig.js +31 -0
  279. package/es/src/shapes/shapeConfig.js.map +1 -0
  280. package/es/src/utils/BaseClass.js +35 -19
  281. package/es/src/utils/BaseClass.js.map +1 -1
  282. package/es/src/utils/D3Scale.js +16 -0
  283. package/es/src/utils/D3Scale.js.map +1 -0
  284. package/es/src/utils/D3plusConfig.js.map +1 -1
  285. package/es/src/utils/configPrep.js +8 -3
  286. package/es/src/utils/configPrep.js.map +1 -1
  287. package/es/src/utils/getProp.js +1 -1
  288. package/es/src/utils/getProp.js.map +1 -1
  289. package/es/src/utils/index.js +1 -0
  290. package/es/src/utils/index.js.map +1 -1
  291. package/es/src/utils/paintComponentScene.js +59 -0
  292. package/es/src/utils/paintComponentScene.js.map +1 -0
  293. package/es/umd-entry.js +16 -0
  294. package/es/umd-entry.js.map +1 -0
  295. package/package.json +15 -10
  296. package/types/index.d.ts +3 -1
  297. package/types/internal.d.ts +54 -0
  298. package/types/src/charts/AreaPlot/index.d.ts +10 -0
  299. package/types/src/charts/BarChart/index.d.ts +10 -0
  300. package/types/src/charts/BoxWhisker/index.d.ts +11 -0
  301. package/types/src/charts/BumpChart/index.d.ts +11 -0
  302. package/types/src/charts/ChartDefinition.d.ts +75 -0
  303. package/types/src/charts/Donut/index.d.ts +13 -0
  304. package/types/src/charts/Geomap/applyLayout.d.ts +7 -0
  305. package/types/src/charts/Geomap/emit.d.ts +7 -0
  306. package/types/src/charts/Geomap/index.d.ts +14 -0
  307. package/types/src/charts/Geomap.d.ts +6 -0
  308. package/types/src/charts/LinePlot/index.d.ts +10 -0
  309. package/types/src/charts/Matrix/applyLayout.d.ts +9 -0
  310. package/types/src/charts/Matrix/emit.d.ts +6 -0
  311. package/types/src/charts/Matrix/index.d.ts +14 -0
  312. package/types/src/charts/Matrix.d.ts +0 -26
  313. package/types/src/charts/Network/applyLayout.d.ts +10 -0
  314. package/types/src/charts/Network/emit.d.ts +6 -0
  315. package/types/src/charts/Network/index.d.ts +7 -0
  316. package/types/src/charts/Network.d.ts +0 -24
  317. package/types/src/charts/Pack/applyLayout.d.ts +16 -0
  318. package/types/src/charts/Pack/emit.d.ts +6 -0
  319. package/types/src/charts/Pack/index.d.ts +15 -0
  320. package/types/src/charts/Pack/recursionCircles.d.ts +7 -0
  321. package/types/src/charts/Pack.d.ts +0 -13
  322. package/types/src/charts/Pie/applyLayout.d.ts +8 -0
  323. package/types/src/charts/Pie/emit.d.ts +5 -0
  324. package/types/src/charts/Pie/index.d.ts +14 -0
  325. package/types/src/charts/Pie.d.ts +0 -27
  326. package/types/src/charts/Plot/draw.d.ts +2 -0
  327. package/types/src/charts/Plot/index.d.ts +167 -0
  328. package/types/src/charts/Plot/labelPlacement.d.ts +15 -0
  329. package/types/src/charts/Plot/pipeline.d.ts +70 -0
  330. package/types/src/charts/Plot/pipelineDomains.d.ts +2 -0
  331. package/types/src/charts/Plot/pipelineLineLabels.d.ts +2 -0
  332. package/types/src/charts/Plot/shapeDefaults.d.ts +64 -0
  333. package/types/src/charts/Plot/stackHelpers.d.ts +24 -0
  334. package/types/src/charts/Plot.d.ts +23 -72
  335. package/types/src/charts/Priestley/applyLayout.d.ts +21 -0
  336. package/types/src/charts/Priestley/emit.d.ts +6 -0
  337. package/types/src/charts/Priestley/index.d.ts +14 -0
  338. package/types/src/charts/Radar/applyLayout.d.ts +10 -0
  339. package/types/src/charts/Radar/emit.d.ts +7 -0
  340. package/types/src/charts/Radar/index.d.ts +14 -0
  341. package/types/src/charts/RadialMatrix/applyLayout.d.ts +11 -0
  342. package/types/src/charts/RadialMatrix/emit.d.ts +6 -0
  343. package/types/src/charts/RadialMatrix/index.d.ts +14 -0
  344. package/types/src/charts/RadialMatrix.d.ts +0 -15
  345. package/types/src/charts/Rings/applyLayout.d.ts +2 -0
  346. package/types/src/charts/Rings/emit.d.ts +7 -0
  347. package/types/src/charts/Rings/index.d.ts +15 -0
  348. package/types/src/charts/Rings.d.ts +0 -13
  349. package/types/src/charts/Sankey/applyLayout.d.ts +7 -0
  350. package/types/src/charts/Sankey/emit.d.ts +6 -0
  351. package/types/src/charts/Sankey/index.d.ts +7 -0
  352. package/types/src/charts/Sankey.d.ts +0 -4
  353. package/types/src/charts/StackedArea/index.d.ts +10 -0
  354. package/types/src/charts/Tree/applyLayout.d.ts +2 -0
  355. package/types/src/charts/Tree/emit.d.ts +7 -0
  356. package/types/src/charts/Tree/index.d.ts +14 -0
  357. package/types/src/charts/Tree.d.ts +0 -16
  358. package/types/src/charts/Treemap/applyLayout.d.ts +16 -0
  359. package/types/src/charts/Treemap/emit.d.ts +6 -0
  360. package/types/src/charts/Treemap/index.d.ts +18 -0
  361. package/types/src/charts/Treemap/thresholdFunction.d.ts +25 -0
  362. package/types/src/charts/Treemap.d.ts +4 -13
  363. package/types/src/charts/Viz.d.ts +49 -361
  364. package/types/src/charts/VizBase.d.ts +158 -0
  365. package/types/src/charts/VizBaseConfig.d.ts +148 -0
  366. package/types/src/charts/applyDefinition.d.ts +13 -0
  367. package/types/src/charts/axes.d.ts +134 -0
  368. package/types/src/charts/chartGeometry.d.ts +58 -0
  369. package/types/src/charts/definition/ChartDefinition.d.ts +84 -0
  370. package/types/src/charts/definition/applyDefinition.d.ts +13 -0
  371. package/types/src/charts/definition/makeChart.d.ts +22 -0
  372. package/types/src/charts/drawSteps/zoomControls.d.ts +25 -5
  373. package/types/src/charts/emitHelpers.d.ts +122 -0
  374. package/types/src/charts/ensureZoomDom.d.ts +39 -0
  375. package/types/src/charts/events/click.legend.d.ts +1 -1
  376. package/types/src/charts/events/click.shape.d.ts +1 -1
  377. package/types/src/charts/events/mouseenter.d.ts +1 -1
  378. package/types/src/charts/events/mouseleave.d.ts +1 -1
  379. package/types/src/charts/events/mousemove.legend.d.ts +1 -1
  380. package/types/src/charts/events/mousemove.shape.d.ts +1 -1
  381. package/types/src/charts/events/touchstart.body.d.ts +1 -1
  382. package/types/src/charts/factories.d.ts +73 -0
  383. package/types/src/charts/features/axes.d.ts +134 -0
  384. package/types/src/charts/features/chartGeometry.d.ts +58 -0
  385. package/types/src/charts/features/colorScaleBucket.d.ts +43 -0
  386. package/types/src/charts/features/colorScaleBucketShare.d.ts +16 -0
  387. package/types/src/charts/features/emitHelpers.d.ts +123 -0
  388. package/types/src/charts/features/ensureZoomDom.d.ts +39 -0
  389. package/types/src/charts/features/features.d.ts +152 -0
  390. package/types/src/charts/features/featuresLegend.d.ts +12 -0
  391. package/types/src/charts/features/legendLabel.d.ts +11 -0
  392. package/types/src/charts/features/lineLabels.d.ts +40 -0
  393. package/types/src/charts/features/plotPaint.d.ts +233 -0
  394. package/types/src/charts/features/shapeEmit.d.ts +61 -0
  395. package/types/src/charts/features.d.ts +152 -0
  396. package/types/src/charts/featuresLegend.d.ts +12 -0
  397. package/types/src/charts/helpers/matrixData.d.ts +1 -1
  398. package/types/src/charts/index.d.ts +21 -21
  399. package/types/src/charts/legendLabel.d.ts +11 -0
  400. package/types/src/charts/lineLabels.d.ts +40 -0
  401. package/types/src/charts/makeChart.d.ts +22 -0
  402. package/types/src/charts/pipeline/resolveSpec.d.ts +51 -0
  403. package/types/src/charts/pipeline/runChartDraw.d.ts +38 -0
  404. package/types/src/charts/pipeline/runVizPipeline.d.ts +31 -0
  405. package/types/src/charts/pipeline/stages.d.ts +160 -0
  406. package/types/src/charts/pipeline/vizContext.d.ts +45 -0
  407. package/types/src/charts/pipeline/vizDraw.d.ts +25 -0
  408. package/types/src/charts/pipeline/vizDrawPure.d.ts +46 -0
  409. package/types/src/charts/pipeline/vizPreDraw.d.ts +22 -0
  410. package/types/src/charts/pipeline/vizPreDrawPure.d.ts +68 -0
  411. package/types/src/charts/plotBuffers/Bar.d.ts +6 -5
  412. package/types/src/charts/plotBuffers/Box.d.ts +6 -5
  413. package/types/src/charts/plotBuffers/Circle.d.ts +6 -5
  414. package/types/src/charts/plotBuffers/Line.d.ts +6 -5
  415. package/types/src/charts/plotBuffers/Rect.d.ts +6 -5
  416. package/types/src/charts/plotBuffers/discreteBuffer.d.ts +2 -1
  417. package/types/src/charts/plotBuffers/numericBuffer.d.ts +2 -1
  418. package/types/src/charts/plotPaint.d.ts +233 -0
  419. package/types/src/charts/resolveSpec.d.ts +50 -0
  420. package/types/src/charts/runChartDraw.d.ts +38 -0
  421. package/types/src/charts/runVizPipeline.d.ts +31 -0
  422. package/types/src/charts/shapeEmit.d.ts +61 -0
  423. package/types/src/charts/stages.d.ts +117 -0
  424. package/types/src/charts/viz/Viz.d.ts +111 -0
  425. package/types/src/charts/viz/VizBase.d.ts +160 -0
  426. package/types/src/charts/viz/VizBaseConfig.d.ts +157 -0
  427. package/types/src/charts/viz/interactionOpacity.d.ts +23 -0
  428. package/types/src/charts/viz/ordinalColor.d.ts +14 -0
  429. package/types/src/charts/viz/trailCatchup.d.ts +14 -0
  430. package/types/src/charts/viz/vizDefaults.d.ts +8 -0
  431. package/types/src/charts/viz/vizRender.d.ts +8 -0
  432. package/types/src/charts/viz/vizTypes.d.ts +250 -0
  433. package/types/src/charts/vizContext.d.ts +46 -0
  434. package/types/src/charts/vizDefaults.d.ts +8 -0
  435. package/types/src/charts/vizDraw.d.ts +25 -0
  436. package/types/src/charts/vizDrawPure.d.ts +17 -0
  437. package/types/src/charts/vizPreDraw.d.ts +22 -0
  438. package/types/src/charts/vizPreDrawPure.d.ts +40 -0
  439. package/types/src/charts/vizRender.d.ts +8 -0
  440. package/types/src/charts/vizTypes.d.ts +202 -0
  441. package/types/src/components/Axis/Axis.d.ts +182 -0
  442. package/types/src/components/Axis/AxisBottom.d.ts +11 -0
  443. package/types/src/components/Axis/AxisLeft.d.ts +11 -0
  444. package/types/src/components/Axis/AxisRight.d.ts +11 -0
  445. package/types/src/components/Axis/AxisTop.d.ts +11 -0
  446. package/types/src/components/Axis/axisLayout.d.ts +29 -0
  447. package/types/src/components/Axis/axisLayoutLabels.d.ts +70 -0
  448. package/types/src/components/Axis/axisLayoutScale.d.ts +14 -0
  449. package/types/src/components/Axis/axisRender.d.ts +68 -0
  450. package/types/src/components/Axis.d.ts +68 -194
  451. package/types/src/components/ColorScale/ColorScale.d.ts +100 -0
  452. package/types/src/components/ColorScale/colorScaleRender.d.ts +15 -0
  453. package/types/src/components/ColorScale/colorScaleScale.d.ts +19 -0
  454. package/types/src/components/ColorScale.d.ts +1 -129
  455. package/types/src/components/Legend/Legend.d.ts +95 -0
  456. package/types/src/components/Legend/legendConfig.d.ts +7 -0
  457. package/types/src/components/Legend/legendRender.d.ts +16 -0
  458. package/types/src/components/Legend.d.ts +9 -73
  459. package/types/src/components/TextBox.d.ts +25 -218
  460. package/types/src/components/Timeline/Timeline.d.ts +118 -0
  461. package/types/src/components/Timeline/timelineConfig.d.ts +6 -0
  462. package/types/src/components/Timeline/timelineRender.d.ts +24 -0
  463. package/types/src/components/Timeline.d.ts +7 -81
  464. package/types/src/components/Tooltip.d.ts +20 -200
  465. package/types/src/components/axisLayout.d.ts +27 -0
  466. package/types/src/components/axisLayoutLabels.d.ts +42 -0
  467. package/types/src/components/axisLayoutScale.d.ts +12 -0
  468. package/types/src/components/axisRender.d.ts +65 -0
  469. package/types/src/components/colorScaleRender.d.ts +15 -0
  470. package/types/src/components/colorScaleScale.d.ts +19 -0
  471. package/types/src/components/index.d.ts +8 -8
  472. package/types/src/components/legendConfig.d.ts +7 -0
  473. package/types/src/components/legendRender.d.ts +16 -0
  474. package/types/src/components/timelineConfig.d.ts +6 -0
  475. package/types/src/components/timelineRender.d.ts +14 -0
  476. package/types/src/fluent.d.ts +94 -0
  477. package/types/src/shapes/Area.d.ts +15 -27
  478. package/types/src/shapes/Bar.d.ts +13 -33
  479. package/types/src/shapes/Box.d.ts +17 -56
  480. package/types/src/shapes/Circle.d.ts +11 -17
  481. package/types/src/shapes/Image.d.ts +18 -84
  482. package/types/src/shapes/Line.d.ts +12 -22
  483. package/types/src/shapes/Path.d.ts +12 -19
  484. package/types/src/shapes/Rect.d.ts +11 -27
  485. package/types/src/shapes/Shape.d.ts +46 -257
  486. package/types/src/shapes/Whisker.d.ts +15 -42
  487. package/types/src/shapes/buildLabelData.d.ts +50 -0
  488. package/types/src/shapes/emitLabels.d.ts +16 -0
  489. package/types/src/shapes/hitAreaNode.d.ts +19 -0
  490. package/types/src/shapes/sceneSort.d.ts +20 -0
  491. package/types/src/shapes/shapeConfig.d.ts +226 -0
  492. package/types/src/utils/BaseClass.d.ts +13 -7
  493. package/types/src/utils/D3Scale.d.ts +48 -0
  494. package/types/src/utils/D3plusConfig.d.ts +270 -15
  495. package/types/src/utils/configPrep.d.ts +7 -4
  496. package/types/src/utils/getProp.d.ts +3 -1
  497. package/types/src/utils/index.d.ts +3 -1
  498. package/types/src/utils/paintComponentScene.d.ts +28 -0
  499. package/types/umd-entry.d.ts +15 -0
  500. package/umd/d3plus-core.full.js +30966 -19051
  501. package/umd/d3plus-core.full.js.map +1 -1
  502. package/umd/d3plus-core.full.min.js +5400 -2949
  503. package/umd/d3plus-core.js +17364 -10534
  504. package/umd/d3plus-core.js.map +1 -1
  505. package/umd/d3plus-core.min.js +3494 -1877
  506. package/es/src/charts/AreaPlot.js +0 -85
  507. package/es/src/charts/AreaPlot.js.map +0 -1
  508. package/es/src/charts/BarChart.js +0 -92
  509. package/es/src/charts/BarChart.js.map +0 -1
  510. package/es/src/charts/BoxWhisker.js +0 -92
  511. package/es/src/charts/BoxWhisker.js.map +0 -1
  512. package/es/src/charts/BumpChart.js +0 -147
  513. package/es/src/charts/BumpChart.js.map +0 -1
  514. package/es/src/charts/Donut.js +0 -84
  515. package/es/src/charts/Donut.js.map +0 -1
  516. package/es/src/charts/Geomap.js +0 -766
  517. package/es/src/charts/Geomap.js.map +0 -1
  518. package/es/src/charts/LinePlot.js +0 -83
  519. package/es/src/charts/LinePlot.js.map +0 -1
  520. package/es/src/charts/Matrix.js +0 -341
  521. package/es/src/charts/Matrix.js.map +0 -1
  522. package/es/src/charts/Network.js +0 -796
  523. package/es/src/charts/Network.js.map +0 -1
  524. package/es/src/charts/Pack.js +0 -308
  525. package/es/src/charts/Pack.js.map +0 -1
  526. package/es/src/charts/Pie.js +0 -232
  527. package/es/src/charts/Pie.js.map +0 -1
  528. package/es/src/charts/Plot.js +0 -2114
  529. package/es/src/charts/Plot.js.map +0 -1
  530. package/es/src/charts/Priestley.js +0 -296
  531. package/es/src/charts/Priestley.js.map +0 -1
  532. package/es/src/charts/Radar.js +0 -420
  533. package/es/src/charts/Radar.js.map +0 -1
  534. package/es/src/charts/RadialMatrix.js +0 -383
  535. package/es/src/charts/RadialMatrix.js.map +0 -1
  536. package/es/src/charts/Rings.js +0 -788
  537. package/es/src/charts/Rings.js.map +0 -1
  538. package/es/src/charts/Sankey.js +0 -461
  539. package/es/src/charts/Sankey.js.map +0 -1
  540. package/es/src/charts/StackedArea.js +0 -80
  541. package/es/src/charts/StackedArea.js.map +0 -1
  542. package/es/src/charts/Tree.js +0 -347
  543. package/es/src/charts/Tree.js.map +0 -1
  544. package/es/src/charts/Treemap.js +0 -454
  545. package/es/src/charts/Treemap.js.map +0 -1
  546. package/es/src/charts/Viz.js +0 -1832
  547. package/es/src/charts/Viz.js.map +0 -1
  548. package/es/src/charts/drawSteps/drawAttribution.js +0 -16
  549. package/es/src/charts/drawSteps/drawAttribution.js.map +0 -1
  550. package/es/src/charts/drawSteps/drawBack.js +0 -24
  551. package/es/src/charts/drawSteps/drawBack.js.map +0 -1
  552. package/es/src/charts/drawSteps/drawColorScale.js +0 -75
  553. package/es/src/charts/drawSteps/drawColorScale.js.map +0 -1
  554. package/es/src/charts/drawSteps/drawLegend.js +0 -122
  555. package/es/src/charts/drawSteps/drawLegend.js.map +0 -1
  556. package/es/src/charts/drawSteps/drawSubtitle.js +0 -31
  557. package/es/src/charts/drawSteps/drawSubtitle.js.map +0 -1
  558. package/es/src/charts/drawSteps/drawTimeline.js +0 -85
  559. package/es/src/charts/drawSteps/drawTimeline.js.map +0 -1
  560. package/es/src/charts/drawSteps/drawTitle.js +0 -31
  561. package/es/src/charts/drawSteps/drawTitle.js.map +0 -1
  562. package/es/src/charts/drawSteps/drawTotal.js +0 -32
  563. package/es/src/charts/drawSteps/drawTotal.js.map +0 -1
  564. package/es/src/components/Axis.js +0 -1457
  565. package/es/src/components/Axis.js.map +0 -1
  566. package/es/src/components/AxisBottom.js.map +0 -1
  567. package/es/src/components/AxisLeft.js.map +0 -1
  568. package/es/src/components/AxisRight.js.map +0 -1
  569. package/es/src/components/AxisTop.js.map +0 -1
  570. package/es/src/components/ColorScale.js +0 -843
  571. package/es/src/components/ColorScale.js.map +0 -1
  572. package/es/src/components/Legend.js +0 -622
  573. package/es/src/components/Legend.js.map +0 -1
  574. package/es/src/components/Timeline.js +0 -695
  575. package/es/src/components/Timeline.js.map +0 -1
  576. /package/es/src/components/{AxisBottom.js → Axis/AxisBottom.js} +0 -0
  577. /package/es/src/components/{AxisLeft.js → Axis/AxisLeft.js} +0 -0
  578. /package/es/src/components/{AxisRight.js → Axis/AxisRight.js} +0 -0
  579. /package/es/src/components/{AxisTop.js → Axis/AxisTop.js} +0 -0
@@ -1,4 +1,5 @@
1
- import type Plot from "../Plot.js";
1
+ import type Plot from "../Plot/index.js";
2
+ import type { D3Scale } from "../../utils/index.js";
2
3
  /**
3
4
  @module boxBuffer
4
5
  Adds a buffer to either side of the non-discrete axis.
@@ -8,9 +9,9 @@ import type Plot from "../Plot.js";
8
9
  */
9
10
  export default function (this: Plot, { data, x, y, x2, y2, buffer, }: {
10
11
  data: Record<string, unknown>[];
11
- x: any;
12
- y: any;
13
- x2?: any;
14
- y2?: any;
12
+ x: D3Scale;
13
+ y: D3Scale;
14
+ x2?: D3Scale;
15
+ y2?: D3Scale;
15
16
  buffer?: number;
16
17
  }): [unknown, unknown];
@@ -1,4 +1,5 @@
1
- import type Plot from "../Plot.js";
1
+ import type Plot from "../Plot/index.js";
2
+ import type { D3Scale } from "../../utils/index.js";
2
3
  /**
3
4
  @module circleBuffer
4
5
  Adds a buffer to either side of the non-discrete axis.
@@ -9,10 +10,10 @@ import type Plot from "../Plot.js";
9
10
  */
10
11
  export default function (this: Plot, { data, x, y, x2, y2, yScale, xScale, config, buffer, }: {
11
12
  data: Record<string, unknown>[];
12
- x: any;
13
- y: any;
14
- x2?: any;
15
- y2?: any;
13
+ x: D3Scale;
14
+ y: D3Scale;
15
+ x2?: D3Scale;
16
+ y2?: D3Scale;
16
17
  yScale?: string;
17
18
  xScale?: string;
18
19
  config?: Record<string, (...args: unknown[]) => unknown>;
@@ -1,4 +1,5 @@
1
- import type Plot from "../Plot.js";
1
+ import type Plot from "../Plot/index.js";
2
+ import type { D3Scale } from "../../utils/index.js";
2
3
  /**
3
4
  @module lineBuffer
4
5
  Adds a buffer to either side of the non-discrete axis.
@@ -9,8 +10,8 @@ import type Plot from "../Plot.js";
9
10
  */
10
11
  export default function (this: Plot, { data, x, y, x2, y2, }: {
11
12
  data: Record<string, unknown>[];
12
- x: any;
13
- y: any;
14
- x2?: any;
15
- y2?: any;
13
+ x: D3Scale;
14
+ y: D3Scale;
15
+ x2?: D3Scale;
16
+ y2?: D3Scale;
16
17
  }): [unknown, unknown];
@@ -1,4 +1,5 @@
1
- import type Plot from "../Plot.js";
1
+ import type Plot from "../Plot/index.js";
2
+ import type { D3Scale } from "../../utils/index.js";
2
3
  /**
3
4
  @module rectBuffer
4
5
  Adds a buffer to either side of the non-discrete axis.
@@ -9,10 +10,10 @@ import type Plot from "../Plot.js";
9
10
  */
10
11
  export default function (this: Plot, { data, x, y, x2, y2, yScale, xScale, config, }: {
11
12
  data: Record<string, unknown>[];
12
- x: any;
13
- y: any;
14
- x2?: any;
15
- y2?: any;
13
+ x: D3Scale;
14
+ y: D3Scale;
15
+ x2?: D3Scale;
16
+ y2?: D3Scale;
16
17
  yScale?: string;
17
18
  xScale?: string;
18
19
  config?: Record<string, (...args: unknown[]) => unknown>;
@@ -3,5 +3,6 @@
3
3
  Adds left/right padding to a point or time scale.
4
4
  @private
5
5
  */
6
- declare const discreteBuffer: (scale: any, data: Record<string, unknown>[], discrete: string) => void;
6
+ import type { D3Scale } from "../../utils/index.js";
7
+ declare const discreteBuffer: (scale: D3Scale, data: Record<string, unknown>[], discrete: string) => void;
7
8
  export default discreteBuffer;
@@ -1,5 +1,6 @@
1
+ import type { D3Scale } from "../../utils/index.js";
1
2
  /**
2
3
  @module numericBuffer
3
4
  @private
4
5
  */
5
- export default function (axis: any, scale: string, value: number, size: number, range: number[], domain: number[], index: number, invert: boolean): number[];
6
+ export default function (axis: D3Scale, scale: string, value: number, size: number, range: number[], domain: number[], index: number, invert: boolean): number[];
@@ -0,0 +1,233 @@
1
+ /**
2
+ `plotPaint(viz, pCtx)` — the Plot paint phase as a free function.
3
+
4
+ An architectural seam, sibling to `runVizPipeline(viz)`.
5
+ The paint phase (production axis rendering, shape buffer setup, and
6
+ shape emission with event handlers) runs here; `Plot._paint` is a
7
+ thin shim that concats the returned nodes onto `viz._chartScene`.
8
+
9
+ @param viz The Plot instance (or any subclass: BarChart, LinePlot, …).
10
+ @param pCtx Cross-phase locals produced by `Plot._draw` — see the
11
+ destructure block below for the full schema.
12
+ */
13
+ import type { DataPoint } from "@d3plus/data";
14
+ import type { SceneNode } from "@d3plus/render";
15
+ import type Axis from "../components/Axis.js";
16
+ import type { VizInstance as Viz } from "./vizTypes.js";
17
+ /** An axis position function: maps a domain value to a pixel coordinate. */
18
+ export type PlotAxisFn = (d: unknown, axis?: string) => number;
19
+ /**
20
+ A line-label measurement record produced upstream by
21
+ `measurePlotLineLabels` and consumed here to bump overlapping labels
22
+ apart and draw their connector lines.
23
+ */
24
+ export interface LabelWidth {
25
+ id: string | number;
26
+ xValue: unknown;
27
+ value: unknown;
28
+ fontSize: number;
29
+ padding: number;
30
+ fontColor?: string;
31
+ /** Bumped y position (set when this label collided with a neighbor). */
32
+ newY?: number;
33
+ /** Unbumped y position (the raw axis position of `value`). */
34
+ defaultY?: number;
35
+ }
36
+ /**
37
+ The wrapped datum a compute-mode shape passes to its config accessors:
38
+ the original `data` row plus the layout-assigned coordinate/group slots.
39
+ The index signature covers the dynamic `d[discrete]` / `d[opp]` reads.
40
+ */
41
+ export interface PlotDatum {
42
+ data: DataPoint;
43
+ i: number;
44
+ id: string | number;
45
+ discrete?: string | number;
46
+ group?: string | number;
47
+ x?: number;
48
+ y?: number;
49
+ x2?: number;
50
+ y2?: number;
51
+ lci?: number;
52
+ hci?: number;
53
+ [key: string]: unknown;
54
+ }
55
+ /**
56
+ Cross-phase locals threaded from `Plot._draw` (and its extracted pipeline
57
+ stages) into `plotPaint` — the contract any consumer of `plotPaint` must
58
+ supply.
59
+
60
+ Grouped by what populates them:
61
+ - **Data + domain** (formatPlotData / computePlotInitialDomains):
62
+ `data`, `shapeData`, `axisData`, `domains`, `discreteKeys`,
63
+ `stackData`, `stackKeys`, `xData/yData/x2Data/y2Data`,
64
+ `xDomain/yDomain/x2Domain/y2Domain`.
65
+ - **Accessors + scales** (computePlotScales):
66
+ `x`, `y`, `x2`, `y2`, `xScale`/`yScale`/`x2Scale`/`y2Scale`,
67
+ `xConfigScale`/`yConfigScale`/`x2ConfigScale`/`y2ConfigScale`.
68
+ `x` and `y` are reassigned during paint (`viz._xFunc = x = ...`).
69
+ - **Axis configs + visibility** (preparePlotAxisLayout):
70
+ `defaultConfig`, `defaultX2Config`, `defaultY2Config`,
71
+ `showX`, `showY`, `x2Exists`, `y2Exists`, `xC`, `yC`.
72
+ - **Axis measurements** (preparePlotAxisLayout + measurePlotLineLabels):
73
+ `xTicks`/`yTicks`/`x2Ticks`/`y2Ticks`, `labelWidths`, `largestLabel`,
74
+ `xRangeMax`, `xTest`/`yTest`/`x2Test`/`y2Test` (transient axis
75
+ instances), `xTestRange`/`x2TestRange`.
76
+ - **Layout offsets + viewport** (preparePlotAxisLayout):
77
+ `yBounds`/`yWidth`/`xOffsetLeft`/`y2Bounds`/`y2Width`/`xOffsetRight`
78
+ (REASSIGNED by paint from production axes), `xHeight`, `x2Height`,
79
+ `topOffset`, `height`, `width`, `horizontalMargin`, `verticalMargin`.
80
+ - **Paint plumbing** (Plot._draw): `opp`, `barLabels`,
81
+ `showLineLabels`, `stackGroup`.
82
+ */
83
+ export interface PlotPaintContext {
84
+ data: DataPoint[];
85
+ shapeData: [string, DataPoint[]][];
86
+ axisData: DataPoint[];
87
+ domains: Record<string, number[]>;
88
+ discreteKeys: unknown[];
89
+ stackData: number[][][];
90
+ stackKeys: unknown[];
91
+ xData: unknown[];
92
+ yData: unknown[];
93
+ x2Data: unknown[];
94
+ y2Data: unknown[];
95
+ xDomain: number[];
96
+ yDomain: number[];
97
+ x2Domain: number[];
98
+ y2Domain: number[];
99
+ x: PlotAxisFn;
100
+ y: PlotAxisFn;
101
+ x2: PlotAxisFn;
102
+ y2: PlotAxisFn;
103
+ xScale: string;
104
+ yScale: string;
105
+ xConfigScale: string;
106
+ yConfigScale: string;
107
+ x2ConfigScale: string;
108
+ y2ConfigScale: string;
109
+ defaultConfig: Record<string, unknown>;
110
+ defaultX2Config: Record<string, unknown>;
111
+ defaultY2Config: Record<string, unknown>;
112
+ showX: boolean;
113
+ showY: boolean;
114
+ x2Exists: boolean;
115
+ y2Exists: boolean;
116
+ xC: Record<string, unknown>;
117
+ yC: Record<string, unknown>;
118
+ xTicks: unknown[];
119
+ yTicks: unknown[];
120
+ x2Ticks: unknown[];
121
+ y2Ticks: unknown[];
122
+ labelWidths: LabelWidth[];
123
+ largestLabel: number;
124
+ xRangeMax: number;
125
+ xTest: Axis;
126
+ yTest: Axis;
127
+ x2Test: Axis;
128
+ y2Test: Axis;
129
+ xTestRange: number[];
130
+ x2TestRange: number[];
131
+ yBounds: {
132
+ width: number;
133
+ height: number;
134
+ x: number;
135
+ y: number;
136
+ };
137
+ y2Bounds: {
138
+ width: number;
139
+ height: number;
140
+ x: number;
141
+ y: number;
142
+ };
143
+ yWidth: number | undefined;
144
+ y2Width: number | undefined;
145
+ xOffsetLeft: number;
146
+ xOffsetRight: number;
147
+ xHeight: number;
148
+ x2Height: number;
149
+ topOffset: number;
150
+ height: number;
151
+ width: number;
152
+ horizontalMargin: number;
153
+ verticalMargin: number;
154
+ opp: "x" | "y" | undefined;
155
+ barLabels: string[];
156
+ showLineLabels: boolean;
157
+ stackGroup: unknown;
158
+ }
159
+ /**
160
+ Result of the MEASURE phase of plotPaint. Captures everything the EMIT
161
+ phase needs to know that was computed/reassigned during measure:
162
+ - `x`/`y`: the production-axis accessor closures (reassigned by
163
+ measure onto `viz._xFunc`/`viz._yFunc`).
164
+ - `xRange`/`yRange`: recomputed from the production axes' outer
165
+ bounds.
166
+ - `xOffsetLeft`/`xOffsetRight`/`yWidth`/`y2Width`/`yBounds`/`y2Bounds`:
167
+ production-axis bounds (the pCtx values were throwaway test-axis
168
+ measurements; these are the real ones).
169
+ - `axisSceneQueue`: deferred axis scenes, populated during measure
170
+ and drained at the END of emit (so axes layer above shapes).
171
+ - `yOffset`: half the x-axis bar stroke width — used to nudge
172
+ annotation and shape y0/y1 baselines so shapes don't visually
173
+ overlap the axis stroke.
174
+ - `labelPositions`: map of line-label id → bumped y position
175
+ (computed from `labelWidths`); read by the line-label
176
+ `labelBounds` config in emit.
177
+ */
178
+ export interface PlotMeasureResult {
179
+ x: PlotAxisFn;
180
+ y: PlotAxisFn;
181
+ xRange: number[];
182
+ yRange: number[];
183
+ xOffsetLeft: number;
184
+ xOffsetRight: number;
185
+ yWidth: number | undefined;
186
+ y2Width: number | undefined;
187
+ yBounds: {
188
+ width: number;
189
+ height: number;
190
+ x: number;
191
+ y: number;
192
+ };
193
+ y2Bounds: {
194
+ width: number;
195
+ height: number;
196
+ x: number;
197
+ y: number;
198
+ };
199
+ axisSceneQueue: {
200
+ key: string;
201
+ transform: {
202
+ x: number;
203
+ y: number;
204
+ };
205
+ axis: Axis;
206
+ }[];
207
+ yOffset: number;
208
+ labelPositions: Record<string, number>;
209
+ }
210
+ /**
211
+ EMIT phase of plotPaint. Takes the `PlotMeasureResult` from
212
+ `renderAxes` and produces ALL the scene nodes: background rect,
213
+ connector lines, back/front annotations, the main shape loop, line
214
+ markers, and the deferred axis scenes (drained from the queue).
215
+ Returns the flat `SceneNode[]` array that the caller (`Plot._paint`)
216
+ merges into `_chartScene`.
217
+ */
218
+ export declare function plotEmit(viz: Viz, pCtx: PlotPaintContext, mCtx: PlotMeasureResult): SceneNode[];
219
+ /**
220
+ Plot paint phase as a free function — orchestrates the axis render +
221
+ EMIT.
222
+
223
+ `renderAxes` (in `./axes.js`) renders the production axes, solves the
224
+ final ranges/offsets, and sets `viz._xFunc`/`viz._yFunc`; `plotEmit`
225
+ then produces the scene nodes (background rect → connectors → back
226
+ annotations → shape loop → line markers → front annotations → axis
227
+ scenes). `Plot._paint` is a thin shim that concats the returned nodes
228
+ onto `viz._chartScene`.
229
+
230
+ @param viz The Plot instance (or any subclass: BarChart, LinePlot, …).
231
+ @param pCtx Cross-phase locals produced by `Plot._draw`.
232
+ */
233
+ export declare function plotPaint(viz: Viz, pCtx: PlotPaintContext): SceneNode[];
@@ -0,0 +1,50 @@
1
+ /**
2
+ `ResolvedSpec` + `resolveSpec(viz)` — the boundary between
3
+ "config the user supplied" and "context the pipeline transforms."
4
+
5
+ Today the chart's class instance holds both: every `this._foo` slot is
6
+ either a config the user can set (via accessors) or a derived value the
7
+ pipeline writes back during `_preDraw` / `_draw` / `_paint`. The clean
8
+ split is:
9
+
10
+ ResolvedSpec <- user config (frozen, immutable, serializable)
11
+ ↓
12
+ VizContext <- pipeline-derived state (filteredData, drawDepth,
13
+ legendData, _chartScene, etc.)
14
+
15
+ `resolveSpec(viz)` returns a frozen snapshot of every user-settable
16
+ config key for the given viz instance. The free functions
17
+ `vizPreDraw(viz)` / `vizDraw(viz)` / `runVizPipeline(viz)` /
18
+ `plotPaint(viz, ctx)` all take a live viz instance — the
19
+ contract that's currently shipping. `resolveSpec` is provided as a
20
+ public seam so callers (custom drivers, tests, future refactors)
21
+ can pin a config snapshot independently of any draw cycle. The
22
+ spec type is the contract.
23
+
24
+ The spec is a READONLY view: mutating it is a programming error. The
25
+ type uses `Readonly<>` to discourage in-place writes; runtime
26
+ freezing happens in `resolveSpec()`.
27
+ */
28
+ /**
29
+ All user-settable configuration keys on a chart, frozen.
30
+
31
+ Generated by stripping the `_` prefix from every Viz/Plot/chart-subclass
32
+ instance field that has a matching accessor method. Accessor reflection
33
+ is handled by `BaseClass.config()`; this type is the static shape.
34
+
35
+ Extends `Record<string, unknown>` for incremental migration — chart
36
+ subclasses add their own fields and the existing `installFluent`-
37
+ installed accessors don't yet have static type info. As schemas gain
38
+ types, this can narrow to per-field unions.
39
+ */
40
+ export type ResolvedSpec = Readonly<Record<string, any>>;
41
+ /**
42
+ Snapshot every config key from a viz instance into a frozen spec.
43
+
44
+ Reads the same keys `BaseClass.config()` reflects — strips the `_`
45
+ prefix from every instance field whose name matches a method on the
46
+ prototype (the v3/v4 config-method-is-also-the-storage-slot pattern).
47
+ Returns a frozen object so consumers can't accidentally mutate it
48
+ upstream of the chart.
49
+ */
50
+ export declare function resolveSpec(viz: any): ResolvedSpec;
@@ -0,0 +1,38 @@
1
+ /**
2
+ `runChartDraw(viz, def, stage, transform?)` — collapses the canonical
3
+ chart-subclass `_draw` body into a single call.
4
+
5
+ Every Viz-extending chart subclass (Tree, Pie, Pack, Treemap, Matrix,
6
+ RadialMatrix, Priestley, Network, Rings, Geomap, Radar) has the same
7
+ three-line sequence after `super._draw(callback)`:
8
+
9
+ const {shapeData} = runStages({viz: this}, [layoutStage]);
10
+ this._chartScene = def.emit({viz: this, shapeData});
11
+ this._chartTransform = { ... };
12
+
13
+ This helper inlines that. The chart's `_draw` becomes:
14
+
15
+ _draw(callback) {
16
+ super._draw(callback);
17
+ runChartDraw(this, myDef, applyMyLayout);
18
+ return this;
19
+ }
20
+
21
+ For charts that compute a non-default `_chartTransform` (Pie centers,
22
+ Radar centers, etc.), pass a third arg that returns the transform.
23
+
24
+ Doesn't reach into chart-specific stash patterns (e.g. Pack writes
25
+ `_packOffsetX`/`_packOffsetY` from its stage; the transform fn can
26
+ read those off `viz` if needed).
27
+
28
+ @param viz The chart instance (`this` from `_draw`).
29
+ @param def The chart's `ChartDefinition` (e.g. `treeDef`, `pieDef`).
30
+ @param stage The chart-specific layout `TransformStage`.
31
+ @param transformFn Optional builder for `_chartTransform`. Default:
32
+ margin-origin (`{x: margin.left, y: margin.top}`).
33
+ */
34
+ import type { Transform } from "@d3plus/render";
35
+ import type { ChartDefinition } from "./ChartDefinition.js";
36
+ import type { TransformStage } from "./stages.js";
37
+ import type { VizInstance as Viz } from "./vizTypes.js";
38
+ export declare function runChartDraw(viz: Viz, def: ChartDefinition, stage: TransformStage, transformFn?: (viz: Viz) => Transform | undefined): void;
@@ -0,0 +1,31 @@
1
+ /**
2
+ `runVizPipeline(viz)` — the chart pipeline as a free function.
3
+
4
+ Draws the boundary between "lifecycle/DOM/data-loading" (which lives on
5
+ `Viz.render()`, inherently instance-bound) and
6
+ "transform-the-data-into-a-scene" (callable without the lifecycle). The
7
+ transform side isn't fully pure yet — `_preDraw`/`_draw` still mutate
8
+ `this` rather than threading an explicit context
9
+ (`UserConfig → ResolvedSpec → transform stages → SceneGraph → renderer`).
10
+
11
+ Calling this function on a Viz instance runs the same four steps
12
+ `Viz.render()` previously inlined inside its `Promise.all().then()`
13
+ callback:
14
+
15
+ 1. `viz._preDraw()` — data filtering + legend-data + drawDepth
16
+ 2. `viz._draw()` — chart-specific layout + scene absorption
17
+ 3. `zoomControls(viz)` — zoom HTML overlay (architectural carve-out)
18
+ 4. `attributionFeature.layout(viz)` — bottom-right attribution panel
19
+ 5. `viz._drawSceneToTarget()` — paint scene via SvgRenderer/CanvasRenderer
20
+
21
+ Future work:
22
+ - Extract a `ResolvedSpec` so step 1 takes (config) not (this).
23
+ - Decouple step 2 so it takes (ctx) not (this); stages already follow
24
+ this pattern but `_draw` itself doesn't.
25
+ - Replace step 5's `this._sceneRenderer` slot with a returned handle
26
+ so callers can pick/destroy/diff without instance lookup.
27
+
28
+ @param viz A Viz instance (or any subclass: Plot, Treemap, Pack, …).
29
+ */
30
+ import type { VizInstance as Viz } from "./vizTypes.js";
31
+ export declare function runVizPipeline(viz: Viz): void;
@@ -0,0 +1,61 @@
1
+ /**
2
+ Per-shape emit registry for the Plot paint phase.
3
+
4
+ The Plot paint loop walks the grouped `shapeData` and, for each shape
5
+ key, produces the scene nodes for that shape's data. Most shapes follow
6
+ the same path (instantiate compute-mode → wire events → apply user
7
+ config → render → collect). Bar and Line carry extra geometry — bar
8
+ spacing/grouping, line confidence bands + end-labels + markers — so they
9
+ get dedicated emitters. Everything else (and stacked Area) flows through
10
+ the generic emitter.
11
+
12
+ A chart "uses only some shapes" purely by which keys appear in its
13
+ `shapeData` (driven by the chart's `shape` accessor default). The
14
+ registry stays complete; the dispatch only ever calls the emitters whose
15
+ keys are present.
16
+
17
+ @module
18
+ */
19
+ import type { DataPoint } from "@d3plus/data";
20
+ import type { SceneNode } from "@d3plus/render";
21
+ import type { LabelWidth, PlotAxisFn } from "./plotPaint.js";
22
+ import type { VizInstance as Viz } from "./vizTypes.js";
23
+ /**
24
+ The cross-phase locals a shape emitter reads. Assembled once per draw by
25
+ the Plot paint loop and passed to each emitter alongside the shape key.
26
+ The stack math (`stackData`/`stackKeyIndex`/`discreteKeyIndex`) is
27
+ computed upstream once per draw — emitters consume it, never recompute.
28
+ */
29
+ export interface ShapeEmitContext {
30
+ viz: Viz;
31
+ /** The data rows for this shape group. */
32
+ values: DataPoint[];
33
+ /** The base shape config shared across every shape in the loop. */
34
+ shapeConfig: Record<string, unknown>;
35
+ /** Event names registered on the viz (`Object.keys(viz.schema.on)`). */
36
+ events: string[];
37
+ x: PlotAxisFn;
38
+ y: PlotAxisFn;
39
+ xScale: string;
40
+ yScale: string;
41
+ xDomain: number[];
42
+ yDomain: number[];
43
+ xRange: number[];
44
+ yRange: number[];
45
+ opp: "x" | "y" | undefined;
46
+ domains: Record<string, number[]>;
47
+ stackData: number[][][];
48
+ stackKeyIndex: Map<unknown, number>;
49
+ discreteKeyIndex: Map<unknown, number>;
50
+ showLineLabels: boolean;
51
+ labelWidths: LabelWidth[];
52
+ largestLabel: number;
53
+ labelPositions: Record<string, number>;
54
+ width: number;
55
+ }
56
+ /** An emitter: produces the scene nodes for one shape group. */
57
+ export type ShapeEmitter = (ctx: ShapeEmitContext, key: string) => SceneNode[];
58
+ /** Shape key → dedicated emitter. Keys absent here use `genericEmit`. */
59
+ export declare const shapeEmitters: Record<string, ShapeEmitter>;
60
+ /** Dispatch a shape group to its emitter (falling back to the generic path). */
61
+ export declare function emitShape(ctx: ShapeEmitContext, key: string): SceneNode[];
@@ -0,0 +1,117 @@
1
+ /**
2
+ `runStages` folds a list of `TransformStage`s into a context, plus the
3
+ `VizContext` / `TransformStage` types they share and `discreteNestKeys`,
4
+ the rollup nest-key helper.
5
+
6
+ `runStages` is the engine for the per-chart layout stages
7
+ (`applyTreemapLayout` etc.) that `runChartDraw` and the Plot pipeline
8
+ invoke. Its progressive writeback copies each stage's outputs onto
9
+ `this` so downstream consumers read the values the prior stage produced
10
+ (writeback is progressive, not after all stages, because
11
+ `Treemap._thresholdFunction` reads `this._drawDepth` mid-pipeline).
12
+
13
+ The chart-shell data prep (draw-depth, id accessors, time/user
14
+ filtering, rollup, threshold, large-data adjustment, empty-data
15
+ detection) runs through the imperative `vizPreDrawPure` (see
16
+ `vizPreDrawPure.ts`), which is the single source of truth for it.
17
+ */
18
+ import type { DataPoint } from "@d3plus/data";
19
+ /**
20
+ @interface VizContext
21
+ The value that flows through the chart pipeline. Each stage reads from it
22
+ and returns the fields it derives. The runner (`Viz._preDraw`) folds the
23
+ stages together and writes the result back onto the Viz instance so
24
+ consumers (`_draw`, drawSteps, components) see the same shape.
25
+ */
26
+ export interface VizContext {
27
+ /** The chart instance. Stages read configuration from it. */
28
+ viz: any;
29
+ drawDepth?: number;
30
+ id?: (d: DataPoint, i: number) => unknown;
31
+ ids?: (d: DataPoint, i: number) => string[];
32
+ drawLabel?: (d: DataPoint, i: number, depth?: number) => string;
33
+ timeFilter?: (d: DataPoint, i?: number) => boolean;
34
+ filteredData?: DataPoint[];
35
+ legendData?: DataPoint[];
36
+ /** Adjustments to `viz.schema.shapeConfig` deferred until writeback. */
37
+ shapeConfigOverrides?: {
38
+ hoverOpacity?: number;
39
+ duration?: number;
40
+ };
41
+ /** True when no data passes filters and the noData message should display. */
42
+ displayNoData?: boolean;
43
+ /**
44
+ Chart-specific layout output (e.g. Treemap's d3-hierarchy result). Produced
45
+ by `applyTreemapLayout` and consumed by Treemap's `_draw` to drive the
46
+ Rect emit. Generic on purpose — each chart's layout stage shapes it.
47
+ */
48
+ shapeData?: any[];
49
+ /**
50
+ Plot's chart-specific staged outputs. `formatPlotData` produces them;
51
+ downstream Plot stages (and Plot._draw's paint phase) read them.
52
+ */
53
+ plotFormattedData?: any[];
54
+ plotAxisData?: any[];
55
+ x2Exists?: boolean;
56
+ y2Exists?: boolean;
57
+ /** Closure used by Plot's stacked branch to compute fillerPoint groups. */
58
+ plotStackGroup?: (d: any, i: number) => string;
59
+ /** Per-axis unique values arrays (output of `computePlotAxisValues`). */
60
+ xData?: any[];
61
+ x2Data?: any[];
62
+ yData?: any[];
63
+ y2Data?: any[];
64
+ /** Initial domains from the stacked/non-stacked branch (output of `computePlotInitialDomains`). */
65
+ plotInitialDomains?: Record<string, any[]>;
66
+ /** Stacked-mode bookkeeping (output of `computePlotInitialDomains`). */
67
+ plotDiscreteKeys?: any[];
68
+ plotStackData?: any[];
69
+ plotStackKeys?: any[];
70
+ /** Final domains after log/baseline adjustments (output of `computePlotScales`). */
71
+ plotDomains?: Record<string, any[]>;
72
+ /** Four configured d3 scale instances + their scale-type strings. */
73
+ plotScales?: any;
74
+ plotConfigScales?: any;
75
+ plotOpps?: any;
76
+ /** Pre-measured test axes + label-test shapes for `measurePlotLineLabels`. */
77
+ plotTestAxes?: any;
78
+ plotLineLabelTest?: any;
79
+ /** Outputs of `measurePlotLineLabels`. */
80
+ plotLabelWidths?: any[];
81
+ plotLargestLabel?: number;
82
+ plotXRangeMax?: number;
83
+ /** Outputs of `preparePlotAxisLayout`. */
84
+ plotDefaultConfig?: any;
85
+ plotDefaultX2Config?: any;
86
+ plotDefaultY2Config?: any;
87
+ plotShowX?: boolean;
88
+ plotShowY?: boolean;
89
+ plotYC?: any;
90
+ plotBarLabels?: string[];
91
+ plotXTicks?: any[] | null;
92
+ plotX2Ticks?: any[] | null;
93
+ plotYTicks?: any[] | null;
94
+ plotY2Ticks?: any[] | null;
95
+ plotXDomain?: any[];
96
+ plotX2Domain?: any[];
97
+ plotYDomain?: any[];
98
+ plotY2Domain?: any[];
99
+ }
100
+ /**
101
+ @type TransformStage
102
+ A pipeline stage: pure function from a context to the fields it derives.
103
+ Stages never mutate the input; the runner merges the returned partial.
104
+ */
105
+ export type TransformStage = (ctx: VizContext) => Partial<VizContext>;
106
+ /**
107
+ Discrete-axis nest keys for the rollup. Plot stores its discrete accessor
108
+ on `viz._x`/`viz._y`; fluent-schema charts (Radar/RadialMatrix `metric`)
109
+ store it on `viz.schema.<discrete>`. Resolve from either so the rollup
110
+ nests by the discrete dimension regardless of where the accessor lives —
111
+ without it, per-metric rows collapse into one aggregated row per group.
112
+ */
113
+ export declare function discreteNestKeys(viz: any): ((d: DataPoint, i: number) => DataPoint[keyof DataPoint])[];
114
+ /**
115
+ Run a stage pipeline and accumulate the partial outputs into one context.
116
+ */
117
+ export declare function runStages(initial: VizContext, stages: TransformStage[]): VizContext;