@d3plus/core 3.1.6 → 4.0.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 +9922 -78537
  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 +639 -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 +72 -31
  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 +70 -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 +14 -9
  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 +156 -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 +230 -3
  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 +31148 -19484
  501. package/umd/d3plus-core.full.js.map +1 -1
  502. package/umd/d3plus-core.full.min.js +5309 -2944
  503. package/umd/d3plus-core.js +17379 -10578
  504. package/umd/d3plus-core.js.map +1 -1
  505. package/umd/d3plus-core.min.js +3470 -1876
  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
@@ -0,0 +1,250 @@
1
+ /**
2
+ `Viz` — the typed contract for the runtime Viz surface that v4's free
3
+ functions (plotPaint, vizPreDrawPure, vizDrawPure, runVizPipeline,
4
+ apply*Layout stages, FeatureModules) read and write.
5
+
6
+ This replaces `viz: any` across the free-function surface. The
7
+ interface enumerates ~140 fields the audit found across the runtime
8
+ code paths, grouped by category. Each entry is the BEST-EFFORT type
9
+ inferred from usage; fields that are deeply chart-specific or
10
+ loosely-shaped use `any` rather than half-accurate narrowing.
11
+
12
+ Compatibility:
13
+ - The class hierarchy (Viz/Plot/BarChart/.../Pie/Tree) already has
14
+ `[key: string]: any` index signatures. Casting `this as Viz` from
15
+ inside a class method is a widening, not a narrowing — TypeScript
16
+ accepts it.
17
+ - Chart-specific extensions (TreeViz/PieViz/etc.) can extend this
18
+ interface to add stash slots (`_treeCtx`, `_pieData`, …). Today
19
+ the index signature on the chart classes covers those.
20
+
21
+ @module
22
+ */
23
+ import type { ZoomTransform } from "d3-zoom";
24
+ import type { DataPoint } from "@d3plus/data";
25
+ import type { ClipShape, SceneNode, Transform } from "@d3plus/render";
26
+ import type { Axis, ColorScale, Legend, Message, TextBox, Timeline, Tooltip } from "../../components/index.js";
27
+ import type Shape from "../../shapes/Shape.js";
28
+ import type { D3plusConfig, D3Scale } from "../../utils/index.js";
29
+ import type { PlotPaintContext } from "../features/plotPaint.js";
30
+ /** Margin object with all four sides. */
31
+ export interface Margin {
32
+ top: number;
33
+ bottom: number;
34
+ left: number;
35
+ right: number;
36
+ }
37
+ /** Padding object with all four sides. */
38
+ export interface Padding {
39
+ top: number;
40
+ bottom: number;
41
+ left: number;
42
+ right: number;
43
+ }
44
+ /**
45
+ D3-style selection — deliberately loose. d3-selection's element/datum
46
+ generics are invariant, so a single typed alias can't accept every
47
+ `select(...)` result the chart code assigns to `_select`/`_container`/etc.;
48
+ the `any` methods + index signature are the escape hatch (same rationale as
49
+ the per-class fluent-accessor index signatures).
50
+ */
51
+ export type D3Selection = {
52
+ node(): any;
53
+ attr(name: string, ...args: any[]): any;
54
+ style(name: string, ...args: any[]): any;
55
+ selectAll(selector: string): any;
56
+ select(selector: string | any): any;
57
+ on(event: string, handler: any): any;
58
+ call(...args: any[]): any;
59
+ transition(...args: any[]): any;
60
+ [key: string]: any;
61
+ };
62
+ /** A Renderer instance — loose to accept any backend (svg/canvas). */
63
+ export interface VizRenderer {
64
+ kind: "svg" | "canvas";
65
+ target(): {
66
+ container: Element;
67
+ width: number;
68
+ height: number;
69
+ } | undefined;
70
+ destroy(): void;
71
+ drawScene(scene: any, opts?: any): any;
72
+ [key: string]: any;
73
+ }
74
+ /**
75
+ The structural contract free functions read/write on a chart instance.
76
+ Class instances satisfy it via their `[key: string]: any` signature;
77
+ chart-specific extensions (TreeViz, PieViz, etc.) add stash slots.
78
+ */
79
+ export interface VizInstance {
80
+ /**
81
+ Post-coercion fluent storage. `any` is deliberate (see BaseClass.schema):
82
+ accessor/const fields are stored as functions and called as such.
83
+ */
84
+ schema: Record<string, any>;
85
+ /** Chart-internal scratch (d3 layout instances, computed derived state). */
86
+ ctx: Record<string, unknown>;
87
+ _width: number;
88
+ _height: number;
89
+ _margin: Margin;
90
+ _padding: Padding;
91
+ _data: DataPoint[];
92
+ _filteredData: DataPoint[];
93
+ _formattedData?: DataPoint[];
94
+ _legendData: DataPoint[];
95
+ _hidden: (string | number)[];
96
+ _solo: (string | number)[];
97
+ _filter?: (d: DataPoint, i: number) => boolean;
98
+ _timeFilter?: (d: DataPoint, i: number) => boolean;
99
+ _noDataMessage?: false | string | ((config: VizInstance) => string);
100
+ _groupBy: ((d: DataPoint, i: number) => DataPoint[keyof DataPoint])[];
101
+ _depth?: number;
102
+ _drawDepth: number;
103
+ _discrete?: "x" | "y";
104
+ _aggs: Record<string, (leaves: DataPoint[]) => unknown>;
105
+ _id: (d: DataPoint, i: number) => string | number;
106
+ _ids: (d: DataPoint, i: number) => string[];
107
+ _drawLabel: (d: DataPoint, i: number, depth?: number) => string;
108
+ _x?: (d: DataPoint, i: number) => number | Date | string;
109
+ _y?: (d: DataPoint, i: number) => number | Date | string;
110
+ _x2?: (d: DataPoint, i: number) => number | Date | string;
111
+ _y2?: (d: DataPoint, i: number) => number | Date | string;
112
+ _shape: (d: DataPoint, i: number) => string;
113
+ _size?: (d: DataPoint, i?: number) => number;
114
+ _value?: (d: DataPoint, i: number) => number;
115
+ _time?: (d: DataPoint, i: number) => string | number | Date;
116
+ _sort?: ((a: DataPoint, b: DataPoint) => number) | null;
117
+ _label?: (d: DataPoint, i: number) => string;
118
+ _thresholdName?: (d: DataPoint, i: number) => string;
119
+ _sum?: (d: DataPoint, i: number) => number;
120
+ _xConfig?: Record<string, unknown>;
121
+ _yConfig?: Record<string, unknown>;
122
+ _x2Config?: Record<string, unknown>;
123
+ _y2Config?: Record<string, unknown>;
124
+ _backgroundConfig?: Record<string, unknown>;
125
+ _legendConfig?: Record<string, unknown>;
126
+ _colorScaleConfig?: Record<string, unknown>;
127
+ _timelineConfig?: Record<string, unknown>;
128
+ _backConfig?: Record<string, unknown>;
129
+ _titleConfig?: Record<string, unknown>;
130
+ _subtitleConfig?: Record<string, unknown>;
131
+ _axisConfig?: Record<string, unknown>;
132
+ _chartScene?: SceneNode[];
133
+ _chartTransform?: Transform;
134
+ _chartClip?: ClipShape;
135
+ _featurePanels?: SceneNode[];
136
+ _shapes?: Shape[];
137
+ _previousShapes?: string[];
138
+ _previousAnnotations?: Record<string, string[]>;
139
+ _zoomTransform?: Transform;
140
+ _select?: D3Selection;
141
+ _sceneTarget?: Element;
142
+ _sceneRenderer?: VizRenderer;
143
+ _duration: number;
144
+ _renderer?: "svg" | "canvas";
145
+ _renderMode?: "full" | "compute";
146
+ _focus?: string | number | undefined;
147
+ _active?: ((d: DataPoint, i?: number) => boolean) | false;
148
+ _hover?: ((d: DataPoint, i?: number) => boolean) | false;
149
+ /** True while the current hover came from a colorScale bucket swatch. */
150
+ _hoverBucket?: boolean;
151
+ _highlight?: ((d: DataPoint, i?: number) => boolean) | false;
152
+ _ordinalColorScale?: ((value: string) => string) | undefined;
153
+ _hoverDatum?: DataPoint | null;
154
+ _userHover?: number;
155
+ _userDuration?: number;
156
+ _dataCutoff: number;
157
+ _brushing?: boolean;
158
+ /** Timeline brush selection (timeline feature). */
159
+ _timelineSelection?: (Date | number)[] | false;
160
+ /** The last drawn timeline value (ms), to detect multi-period trail jumps. */
161
+ _trailSeq?: number;
162
+ /** The user-set data, retained to detect changes across `.data()` calls. */
163
+ _userData?: DataPoint[] | string;
164
+ /** Drill-down history stack (back button). */
165
+ _history?: DataPoint[];
166
+ _xAxis?: Axis;
167
+ _yAxis?: Axis;
168
+ _x2Axis?: Axis;
169
+ _y2Axis?: Axis;
170
+ _xFunc?: (d: DataPoint, axis?: string) => number;
171
+ _yFunc?: (d: DataPoint, axis?: string) => number;
172
+ /** Internal size scale built in Plot's pipeline; maps `_size` → pixel radius. */
173
+ _sizeScaleD3?: D3Scale;
174
+ /** Per-axis "is this axis time-valued" flags, set by `formatPlotData`. */
175
+ _xTime?: boolean;
176
+ _x2Time?: boolean;
177
+ _yTime?: boolean;
178
+ _y2Time?: boolean;
179
+ _baseline?: number;
180
+ _stacked?: boolean;
181
+ _stackOffset?: (series: number[][][], order: number[]) => void;
182
+ /** d3-stack order: an accessor, or an explicit array of series keys. */
183
+ _stackOrder?: ((series: number[][][]) => number[]) | unknown[];
184
+ _confidence?: [number, number] | false;
185
+ _lineLabels?: ((d: DataPoint, i: number) => boolean) | boolean;
186
+ _lineMarkers?: boolean;
187
+ _barPadding?: number;
188
+ _groupPadding?: number;
189
+ _annotations?: Record<string, unknown>[];
190
+ _axisPersist?: boolean;
191
+ _labelPosition?: (d: DataPoint, i: number) => "auto" | "inside" | "outside";
192
+ _labelConnectorConfig?: Record<string, unknown>;
193
+ _lineMarkerConfig?: Record<string, unknown>;
194
+ _confidenceConfig?: Record<string, unknown>;
195
+ _xCutoff?: number;
196
+ _yCutoff?: number;
197
+ _discreteCutoff?: number;
198
+ _buffer?: Record<string, unknown>;
199
+ _legendClass?: Legend;
200
+ _colorScaleClass?: ColorScale;
201
+ _timelineClass?: Timeline;
202
+ _titleClass?: TextBox;
203
+ _subtitleClass?: TextBox;
204
+ _backClass?: TextBox;
205
+ _messageClass?: Message;
206
+ _tooltipClass?: Tooltip;
207
+ _legendSort?: (a: DataPoint, b: DataPoint) => number;
208
+ _legendPosition?: (config: VizInstance) => string | false;
209
+ _legend?: ((config: VizInstance, data: DataPoint[]) => boolean) | boolean;
210
+ _legendDepth?: number;
211
+ _colorScalePosition?: (config: VizInstance) => string | false;
212
+ _colorScale?: false | string | ((d: DataPoint, i: number) => string);
213
+ _title?: ((data: DataPoint[]) => string | false) | string | false;
214
+ _subtitle?: ((data: DataPoint[]) => string | false) | string | false;
215
+ _attribution?: string | false;
216
+ _attributionStyle?: Record<string, unknown>;
217
+ _timeline?: boolean;
218
+ _total?: boolean | ((d: DataPoint[], i: number) => number);
219
+ _container?: D3Selection;
220
+ /**
221
+ Element d3-zoom binds to. Defaults to `_container` (the compute svg); the
222
+ Canvas backend points it at the <canvas> so pan/zoom and pointer picking
223
+ share one interaction surface.
224
+ */
225
+ _zoomEventTarget?: D3Selection;
226
+ _zoomGroup?: D3Selection;
227
+ _tileGroup?: D3Selection;
228
+ _tileGen?: any;
229
+ _zoomBehavior?: any;
230
+ _zoomBrush?: any;
231
+ _zoomSet?: boolean;
232
+ _zoomToBounds?: (bounds: number[][] | null, duration?: number) => void;
233
+ _renderTiles?: (transform?: ZoomTransform, duration?: number) => void;
234
+ _wirePlotShapeEvents?: (shape: Shape, shapeKey: string, events: string[]) => void;
235
+ _uuid: string;
236
+ _preDraw(): void;
237
+ _draw(callback?: () => void): void;
238
+ /** Plot's paint phase: builds `_chartScene` from the measured context. */
239
+ _paint?(pCtx: PlotPaintContext): VizInstance;
240
+ _drawSceneToTarget(durationOverride?: number): void;
241
+ _scheduleSceneRepaint(): void;
242
+ _sceneRepaintRAF?: number;
243
+ _thresholdFunction?(data: DataPoint[], tree?: unknown): DataPoint[];
244
+ toScene?(): SceneNode;
245
+ config?(_?: D3plusConfig): D3plusConfig | this;
246
+ active?(_?: unknown): unknown;
247
+ hover?(_?: unknown): unknown;
248
+ timeFilter?(_?: ((d: DataPoint, i: number) => boolean) | false): VizInstance;
249
+ render?(callback?: () => void): VizInstance;
250
+ }
@@ -0,0 +1,46 @@
1
+ /**
2
+ `VizContext` — the pipeline-derived state companion to `ResolvedSpec`.
3
+
4
+ This boundary splits a chart's runtime data into two halves:
5
+
6
+ ResolvedSpec <- user config (frozen, immutable; see resolveSpec.ts)
7
+ ↓
8
+ VizContext <- pipeline-derived state (filteredData, drawDepth,
9
+ legendData, _id closures, …)
10
+
11
+ `vizPreDrawPure(spec, prevCtx) → Partial<VizContext>` is the contract:
12
+ given a frozen spec and any prior context, return the keys the stage
13
+ computed. Callers compose this with their `prevCtx` via spread:
14
+
15
+ const next = {...prevCtx, ...vizPreDrawPure(spec, prevCtx)};
16
+
17
+ Same for `vizDrawPure(spec, ctx) → Partial<VizContext>`.
18
+
19
+ The class `Viz._preDraw()` / `Viz._draw()` stay as imperative shims
20
+ that wrap the pure functions + write results back to `this` (for back-
21
+ compat with subclass overrides that read `this._filteredData` etc.).
22
+ Direct callers of the pure functions get the architectural seam.
23
+ */
24
+ import type { DataPoint } from "@d3plus/data";
25
+ /**
26
+ The shape of every field vizPreDraw + vizDraw can populate. Currently
27
+ permissive (any) for the closure-typed helpers (_id, _ids, _drawLabel,
28
+ _thresholdName, _thresholdData). As subclasses formalize their typed
29
+ contexts, this can tighten.
30
+ */
31
+ export interface VizContext extends Record<string, any> {
32
+ /** Effective draw depth (capped to groupBy.length - 1). */
33
+ drawDepth?: number;
34
+ /** Unique-id-per-datum accessor (depth-scoped). */
35
+ id?: (d: DataPoint, i: number) => any;
36
+ /** Array-of-ids-per-datum accessor. */
37
+ ids?: (d: DataPoint, i: number) => string[];
38
+ /** Human-readable label-per-datum accessor (handles aggregation labels). */
39
+ drawLabel?: (d: DataPoint, i: number, depth?: number) => string;
40
+ /** Data after filter + timeFilter + threshold are applied. */
41
+ filteredData?: DataPoint[];
42
+ /** Per-id rank order used by legend + treemap label sorting. */
43
+ legendData?: DataPoint[];
44
+ /** Whether a "no data" message should currently be visible. */
45
+ noDataMessage?: boolean;
46
+ }
@@ -0,0 +1,8 @@
1
+ import type Viz from "./Viz.js";
2
+ /**
3
+ Seeds a fresh Viz instance's schema defaults and installs the identity-coerce
4
+ fluent accessors. Extracted from the constructor so the seeding logic stays
5
+ readable and the constructor stays under the per-function line budget.
6
+ @private
7
+ */
8
+ export declare function initVizDefaults(viz: Viz): void;
@@ -0,0 +1,25 @@
1
+ /**
2
+ `vizDraw(viz)` — the imperative shim wrapping `vizDrawPure`.
3
+
4
+ The pure function (`vizDrawPure(viz, prevCtx) → Partial<VizDrawCtx>`)
5
+ computes the chart-shell layout — margin deltas + reset signals +
6
+ feature panels — at the outer level. Inner FeatureModule.layout()
7
+ calls still write through to `viz` directly (component mounts,
8
+ intra-feature accessor writes); that's intentional — `vizUpdate` is
9
+ the cross-feature publishing channel, but a feature's OWN intra-body
10
+ state lives on viz directly because the feature's component instance
11
+ (`Legend`, `Timeline`) is a stateful object whose configuration calls
12
+ happen inline.
13
+
14
+ `vizDrawPure` threads its margin accumulator locally and returns the
15
+ per-side deltas in `marginDelta`; it no longer writes `viz._margin`.
16
+ This shim applies those deltas to the instance once, so the
17
+ post-layout consumers (axes, chartGeometry, plotPaint, ensureZoomDom,
18
+ attribution) read the final margin off `viz._margin`.
19
+
20
+ Note: Plot (and other Viz subclasses) OVERRIDE `_draw` and call
21
+ `super._draw(callback)` — that still works through this shim, which
22
+ in turn invokes `vizDraw(this)` with `this` bound to the subclass.
23
+ */
24
+ import type { VizInstance as Viz } from "./vizTypes.js";
25
+ export declare function vizDraw(viz: Viz): void;
@@ -0,0 +1,17 @@
1
+ import type { VizContext } from "./vizContext.js";
2
+ import type { VizInstance as Viz } from "./vizTypes.js";
3
+ export interface VizDrawCtx extends VizContext {
4
+ marginDelta?: {
5
+ top: number;
6
+ bottom: number;
7
+ left: number;
8
+ right: number;
9
+ };
10
+ featurePanels?: any[];
11
+ legendPosition?: string | false;
12
+ colorScalePosition?: string | false;
13
+ resetChartScene?: boolean;
14
+ resetChartTransform?: boolean;
15
+ resetShapes?: boolean;
16
+ }
17
+ export declare function vizDrawPure(viz: Viz, _prevCtx?: Partial<VizContext>): Partial<VizDrawCtx>;
@@ -0,0 +1,22 @@
1
+ /**
2
+ `vizPreDraw(viz)` — the imperative shim wrapping `vizPreDrawPure`.
3
+
4
+ The pure function (`vizPreDrawPure(viz, prevCtx) → Partial<VizContext>`)
5
+ computes the data-prep results without mutating viz. This shim:
6
+ 1. calls the pure function;
7
+ 2. writes the returned ctx fields back to viz (so subclass methods
8
+ that read `this._drawDepth` / `this._filteredData` see them);
9
+ 3. invokes `viz._thresholdFunction(filteredData, tree)` — this is
10
+ an instance method that needs `this`-bound state populated by
11
+ step 2;
12
+ 4. recomputes hover-cutoff overrides + no-data flag against the
13
+ threshold-applied data (via `vizPostThresholdCtx`);
14
+ 5. applies the deferred DOM side effects (no-data message mount,
15
+ opacity fade).
16
+
17
+ `Viz._preDraw()` calls this shim so subclass overrides + the existing
18
+ test surface remain unchanged. Direct consumers of the architectural
19
+ seam should use `vizPreDrawPure` (exported from the package index).
20
+ */
21
+ import type { VizInstance as Viz } from "./vizTypes.js";
22
+ export declare function vizPreDraw(viz: Viz): void;
@@ -0,0 +1,40 @@
1
+ import type { DataPoint } from "@d3plus/data";
2
+ import type { VizContext } from "./vizContext.js";
3
+ import type { VizInstance as Viz } from "./vizTypes.js";
4
+ /**
5
+ The shape `vizPreDrawPure` returns: a `Partial<VizContext>` plus the
6
+ two pure-function carve-outs.
7
+
8
+ - `_thresholdTree` is the d3-array `rollup` result that
9
+ `viz._thresholdFunction(filteredData, tree)` needs to walk. The
10
+ threshold function is a subclass instance method (Treemap.ts has
11
+ the override) that reads from `this`; calling it pure would require
12
+ moving subclass logic out of the class, which is out of scope.
13
+ Returning the tree lets the shim apply threshold after writing
14
+ `drawDepth` back.
15
+ - `computedTimeFilter` is the time-filter function the pure version
16
+ synthesized (when `_time` is set but `_timeFilter` isn't). The
17
+ shim feeds it to `filteredData` but does NOT write it onto
18
+ `viz.schema.timeFilter` — pinning the synthesized filter (which
19
+ captures `latestTime` at synthesis) would make a later render
20
+ with newer data skip re-synthesis.
21
+ */
22
+ type ThresholdTree = any;
23
+ type TimeFilterFn = ((d: DataPoint, i: number) => boolean) | (() => boolean);
24
+ export interface VizPreDrawResult extends Partial<VizContext> {
25
+ /** Internal: d3-array rollup tree, consumed by the shim's threshold step. */
26
+ _thresholdTree?: ThresholdTree;
27
+ /** Internal: synthesized time-filter for the shim to back-assign. */
28
+ computedTimeFilter?: TimeFilterFn;
29
+ }
30
+ export declare function vizPreDrawPure(viz: Viz, _prevCtx?: Partial<VizContext>): VizPreDrawResult;
31
+ export declare function vizPostThresholdCtx(viz: Viz, filteredData: DataPoint[], id: (d: DataPoint, i: number) => any): {
32
+ hoverOverride?: {
33
+ hoverOpacity: number;
34
+ duration: number;
35
+ stashOriginals?: boolean;
36
+ restoreOriginals?: boolean;
37
+ };
38
+ noDataMessage: boolean;
39
+ };
40
+ export {};
@@ -0,0 +1,8 @@
1
+ import type Viz from "./Viz.js";
2
+ /**
3
+ Draws the visualization given the specified configuration.
4
+ @param viz The Viz instance to render.
5
+ @param callback Optional callback invoked after rendering completes.
6
+ @private
7
+ */
8
+ export declare function vizRender(viz: Viz, callback?: () => void): Viz;
@@ -0,0 +1,202 @@
1
+ /**
2
+ `Viz` — the typed contract for the runtime Viz surface that v4's free
3
+ functions (plotPaint, vizPreDrawPure, vizDrawPure, runVizPipeline,
4
+ apply*Layout stages, FeatureModules) read and write.
5
+
6
+ This replaces `viz: any` across the free-function surface. The
7
+ interface enumerates ~140 fields the audit found across the runtime
8
+ code paths, grouped by category. Each entry is the BEST-EFFORT type
9
+ inferred from usage; fields that are deeply chart-specific or
10
+ loosely-shaped use `any` rather than half-accurate narrowing.
11
+
12
+ Compatibility:
13
+ - The class hierarchy (Viz/Plot/BarChart/.../Pie/Tree) already has
14
+ `[key: string]: any` index signatures. Casting `this as Viz` from
15
+ inside a class method is a widening, not a narrowing — TypeScript
16
+ accepts it.
17
+ - Chart-specific extensions (TreeViz/PieViz/etc.) can extend this
18
+ interface to add stash slots (`_treeCtx`, `_pieData`, …). Today
19
+ the index signature on the chart classes covers those.
20
+
21
+ @module
22
+ */
23
+ import type { DataPoint } from "@d3plus/data";
24
+ import type { SceneNode, Transform } from "@d3plus/render";
25
+ /** Margin object with all four sides. */
26
+ export interface Margin {
27
+ top: number;
28
+ bottom: number;
29
+ left: number;
30
+ right: number;
31
+ }
32
+ /** Padding object with all four sides. */
33
+ export interface Padding {
34
+ top: number;
35
+ bottom: number;
36
+ left: number;
37
+ right: number;
38
+ }
39
+ /** D3-style selection (loose — d3-selection's types are too generic to repeat here). */
40
+ export type D3Selection = {
41
+ node(): any;
42
+ attr(name: string, ...args: any[]): any;
43
+ style(name: string, ...args: any[]): any;
44
+ selectAll(selector: string): any;
45
+ select(selector: string | any): any;
46
+ on(event: string, handler: any): any;
47
+ call(...args: any[]): any;
48
+ transition(...args: any[]): any;
49
+ [key: string]: any;
50
+ };
51
+ /** A Renderer instance — see @d3plus/render. */
52
+ export interface VizRenderer {
53
+ kind: "svg" | "canvas";
54
+ target(): {
55
+ container: Element;
56
+ width: number;
57
+ height: number;
58
+ } | undefined;
59
+ destroy(): void;
60
+ drawScene(scene: any, opts?: any): any;
61
+ [key: string]: any;
62
+ }
63
+ /**
64
+ The structural contract free functions read/write on a chart instance.
65
+ Class instances satisfy it via their `[key: string]: any` signature;
66
+ chart-specific extensions (TreeViz, PieViz, etc.) add stash slots.
67
+ */
68
+ export interface VizInstance {
69
+ /** User-set config from fluent accessors (`.sum(...)`, `.x(...)`, …). */
70
+ schema: Record<string, any>;
71
+ /** Chart-internal scratch (d3 layout instances, computed derived state). */
72
+ ctx: Record<string, unknown>;
73
+ _width: number;
74
+ _height: number;
75
+ _margin: Margin;
76
+ _padding: Padding;
77
+ _data: DataPoint[];
78
+ _filteredData: DataPoint[];
79
+ _formattedData?: DataPoint[];
80
+ _legendData: DataPoint[];
81
+ _hidden: (string | number)[];
82
+ _solo: (string | number)[];
83
+ _filter?: (d: DataPoint, i: number) => boolean;
84
+ _timeFilter?: (d: DataPoint, i: number) => boolean;
85
+ _noDataMessage?: false | string | ((config: any) => string);
86
+ _groupBy: ((d: DataPoint, i: number) => DataPoint[keyof DataPoint])[];
87
+ _depth?: number;
88
+ _drawDepth: number;
89
+ _discrete?: "x" | "y";
90
+ _aggs: Record<string, (leaves: DataPoint[]) => unknown>;
91
+ _id: (d: DataPoint, i: number) => string | number;
92
+ _ids: (d: DataPoint, i: number) => string[];
93
+ _drawLabel: (d: DataPoint, i: number, depth?: number) => string;
94
+ _x?: (d: DataPoint, i: number) => number | Date | string;
95
+ _y?: (d: DataPoint, i: number) => number | Date | string;
96
+ _x2?: (d: DataPoint, i: number) => number | Date | string;
97
+ _y2?: (d: DataPoint, i: number) => number | Date | string;
98
+ _shape: (d: DataPoint, i: number) => string;
99
+ _size?: (d: DataPoint, i: number) => number;
100
+ _value?: (d: DataPoint, i: number) => number;
101
+ _time?: (d: DataPoint, i: number) => string | number | Date;
102
+ _sort?: ((a: any, b: any) => number) | null;
103
+ _label?: (d: DataPoint, i: number) => string;
104
+ _thresholdName?: (d: DataPoint, i: number) => string;
105
+ _sum?: (d: DataPoint, i: number) => number;
106
+ _xConfig?: Record<string, any>;
107
+ _yConfig?: Record<string, any>;
108
+ _x2Config?: Record<string, any>;
109
+ _y2Config?: Record<string, any>;
110
+ _backgroundConfig?: Record<string, any>;
111
+ _legendConfig?: Record<string, any>;
112
+ _colorScaleConfig?: Record<string, any>;
113
+ _timelineConfig?: Record<string, any>;
114
+ _backConfig?: Record<string, any>;
115
+ _titleConfig?: Record<string, any>;
116
+ _subtitleConfig?: Record<string, any>;
117
+ _axisConfig?: Record<string, any>;
118
+ _chartScene?: SceneNode[];
119
+ _chartTransform?: Transform;
120
+ _featurePanels?: SceneNode[];
121
+ _shapes?: any[];
122
+ _previousShapes?: string[];
123
+ _previousAnnotations?: Record<string, string[]>;
124
+ _zoomTransform?: Transform;
125
+ _select?: D3Selection;
126
+ _sceneTarget?: Element;
127
+ _sceneRenderer?: VizRenderer;
128
+ _duration: number;
129
+ _renderer?: "svg" | "canvas";
130
+ _renderMode?: "full" | "compute";
131
+ _focus?: string | number | undefined;
132
+ _active?: ((d: DataPoint, i?: number) => boolean) | false;
133
+ _hover?: ((d: DataPoint, i?: number) => boolean) | false;
134
+ _userHover?: number;
135
+ _userDuration?: number;
136
+ _dataCutoff: number;
137
+ _brushing?: boolean;
138
+ _xAxis?: any;
139
+ _yAxis?: any;
140
+ _x2Axis?: any;
141
+ _y2Axis?: any;
142
+ _xFunc?: (d: any, axis?: string) => number;
143
+ _yFunc?: (d: any, axis?: string) => number;
144
+ _baseline?: number;
145
+ _stacked?: boolean;
146
+ _stackOffset?: (series: any[], order: any) => void;
147
+ _stackOrder?: (series: any[]) => number[];
148
+ _confidence?: [number, number] | false;
149
+ _lineLabels?: ((d: DataPoint, i: number) => boolean) | boolean;
150
+ _lineMarkers?: boolean;
151
+ _barPadding?: number;
152
+ _groupPadding?: number;
153
+ _annotations?: any[];
154
+ _axisPersist?: boolean;
155
+ _labelPosition?: (d: DataPoint, i: number) => "auto" | "inside" | "outside";
156
+ _labelConnectorConfig?: Record<string, any>;
157
+ _lineMarkerConfig?: Record<string, any>;
158
+ _confidenceConfig?: Record<string, any>;
159
+ _xCutoff?: number;
160
+ _yCutoff?: number;
161
+ _discreteCutoff?: number;
162
+ _buffer?: Record<string, any>;
163
+ _legendClass?: any;
164
+ _colorScaleClass?: any;
165
+ _timelineClass?: any;
166
+ _titleClass?: any;
167
+ _subtitleClass?: any;
168
+ _backClass?: any;
169
+ _messageClass?: any;
170
+ _tooltipClass?: any;
171
+ _legendSort?: (a: DataPoint, b: DataPoint) => number;
172
+ _legendPosition?: (config: any) => string | false;
173
+ _legend?: ((config: any, data: DataPoint[]) => boolean) | boolean;
174
+ _legendDepth?: number;
175
+ _colorScalePosition?: (config: any) => string | false;
176
+ _colorScale?: false | string | ((d: DataPoint, i: number) => string);
177
+ _title?: ((data: DataPoint[]) => string | false) | string | false;
178
+ _subtitle?: ((data: DataPoint[]) => string | false) | string | false;
179
+ _attribution?: string | false;
180
+ _attributionStyle?: Record<string, any>;
181
+ _timeline?: boolean;
182
+ _total?: boolean | ((d: DataPoint[], i: number) => number);
183
+ _container?: D3Selection;
184
+ _zoomGroup?: D3Selection;
185
+ _tileGroup?: D3Selection;
186
+ _tileGen?: any;
187
+ _zoomBehavior?: any;
188
+ _zoomBrush?: any;
189
+ _zoomSet?: boolean;
190
+ _zoomToBounds?: (bounds: number[][] | null, duration?: number) => void;
191
+ _renderTiles?: (transform?: any, duration?: number) => void;
192
+ _wirePlotShapeEvents?: (shape: any, shapeKey: string, events: string[]) => void;
193
+ _uuid: string;
194
+ _preDraw(): void;
195
+ _draw(callback?: () => void): void;
196
+ _drawSceneToTarget(durationOverride?: number): void;
197
+ _thresholdFunction?(data: DataPoint[], tree?: any): DataPoint[];
198
+ toScene?(): any;
199
+ config?(_?: any): any;
200
+ active?(_?: any): any;
201
+ hover?(_?: any): any;
202
+ }