@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,19 +1,20 @@
1
1
  import type { DataPoint } from "@d3plus/data";
2
- import type { AccessorFn } from "../utils/index.js";
2
+ import type { PathConfig } from "./shapeConfig.js";
3
3
  import Shape, { type ShapeAes } from "./Shape.js";
4
4
  /**
5
5
  Creates SVG Paths based on an array of data.
6
6
  */
7
7
  export default class Path extends Shape {
8
- _d: AccessorFn;
9
- _labelBounds: ((d: DataPoint, i: number, aes: ShapeAes) => Record<string, unknown> | null | false) | null;
10
- _name: string;
11
- _labelConfig: Record<string, unknown>;
12
8
  /**
13
9
  Invoked when creating a new class instance, and overrides any default parameters inherited from Shape.
14
10
  @private
15
11
  */
16
12
  constructor();
13
+ /**
14
+ Returns the path geometry for a data point (the raw "d" string).
15
+ @private
16
+ */
17
+ _sceneGeometry(d: DataPoint, i: number): Record<string, unknown>;
17
18
  /**
18
19
  Given a specific data point and index, returns the aesthetic properties of the shape.
19
20
  @param data point*
@@ -21,18 +22,10 @@ export default class Path extends Shape {
21
22
  */
22
23
  _aes(d: DataPoint, i: number): ShapeAes;
23
24
  /**
24
- Draws the paths.
25
- @param callback Optional callback invoked after rendering completes.
26
- */
27
- render(callback?: () => void): this;
28
- /**
29
- The "d" attribute.
30
-
31
- @example
32
- function(d) {
33
- return d.path;
34
- }
35
- */
36
- d(): AccessorFn;
37
- d(_: AccessorFn | string): this;
25
+ Narrowed `.config()` for Path. Inherited surface from
26
+ `BaseClass.config()`; the override exists only to surface per-shape
27
+ keys (e.g. `width`/`height` for Rect) in autocomplete + type checks.
28
+ */
29
+ config(): PathConfig;
30
+ config(_: Partial<PathConfig>): this;
38
31
  }
@@ -1,25 +1,22 @@
1
1
  import type { DataPoint } from "@d3plus/data";
2
2
  import type { D3Selection } from "@d3plus/dom";
3
- import type { AccessorFn } from "../utils/index.js";
3
+ import type { RectConfig } from "./shapeConfig.js";
4
4
  import Shape, { type ShapeAes } from "./Shape.js";
5
5
  /**
6
6
  Creates SVG rectangles based on an array of data. See [this example](https://d3plus.org/examples/d3plus-shape/getting-started/) for help getting started using the rectangle generator.
7
7
  */
8
8
  export default class Rect extends Shape {
9
- _height: AccessorFn;
10
- _labelBounds: ((d: DataPoint, i: number, aes: ShapeAes) => Record<string, unknown> | null | false) | null;
11
- _name: string;
12
- _width: AccessorFn;
13
9
  /**
14
10
  Invoked when creating a new class instance, and overrides any default parameters inherited from Shape.
15
11
  @private
16
12
  */
17
13
  constructor();
18
14
  /**
19
- Draws the rectangles.
20
- @param callback Optional callback invoked after rendering completes.
15
+ Returns the rect geometry for a data point, matching _applyPosition: the
16
+ rect is centered on the transform origin (x/y = -size/2).
17
+ @private
21
18
  */
22
- render(callback?: () => void): this;
19
+ _sceneGeometry(d: DataPoint, i: number): Record<string, unknown>;
23
20
  /**
24
21
  Given a specific data point and index, returns the aesthetic properties of the shape.
25
22
  @param data point*
@@ -32,23 +29,10 @@ export default class Rect extends Shape {
32
29
  */
33
30
  _applyPosition(elem: D3Selection): void;
34
31
  /**
35
- The height accessor for each rectangle.
36
-
37
- @example
38
- function(d) {
39
- return d.height;
40
- }
41
- */
42
- height(): AccessorFn;
43
- height(_: AccessorFn | number): this;
44
- /**
45
- The width accessor for each rectangle.
46
-
47
- @example
48
- function(d) {
49
- return d.width;
50
- }
51
- */
52
- width(): AccessorFn;
53
- width(_: AccessorFn | number): this;
32
+ Narrowed `.config()` for Rect. Inherited surface from
33
+ `BaseClass.config()`; the override exists only to surface per-shape
34
+ keys (e.g. `width`/`height` for Rect) in autocomplete + type checks.
35
+ */
36
+ config(): RectConfig;
37
+ config(_: Partial<RectConfig>): this;
54
38
  }
@@ -1,9 +1,18 @@
1
1
  import { transition } from "d3-transition";
2
2
  import type { DataPoint } from "@d3plus/data";
3
3
  import type { D3Selection } from "@d3plus/dom";
4
+ import { SvgRenderer } from "@d3plus/render";
5
+ import type { GroupNode, Paint, Transform } from "@d3plus/render";
4
6
  import { TextBox } from "../components/index.js";
5
7
  import { BaseClass } from "../utils/index.js";
6
8
  import type { AccessorFn } from "../utils/index.js";
9
+ import type { BaseShapeConfig } from "./shapeConfig.js";
10
+ /** Coerces a value to a finite number, or undefined. @private */
11
+ export declare function numOrUndef(v: unknown): number | undefined;
12
+ /** Returns a non-empty string, or undefined. @private */
13
+ export declare function strOrUndef(v: unknown): string | undefined;
14
+ /** Parses an SVG stroke-dasharray value into an array of numbers. @private */
15
+ export declare function parseDash(v: unknown): number[] | undefined;
7
16
  export interface ShapeAes {
8
17
  width?: number;
9
18
  height?: number;
@@ -17,63 +26,26 @@ import Image from "./Image.js";
17
26
  An abstracted class for generating shapes.
18
27
  */
19
28
  export default class Shape extends BaseClass {
20
- _activeOpacity: number;
21
- _activeStyle: Record<string, unknown>;
22
- _ariaLabel: AccessorFn;
23
- _backgroundImage: AccessorFn;
29
+ [key: string]: any;
24
30
  _backgroundImageClass: Image;
25
31
  _data: DataPoint[];
26
- _duration: number;
27
- _fill: AccessorFn;
28
- _fillOpacity: AccessorFn;
29
- _hoverOpacity: number;
30
- _hoverStyle: Record<string, unknown>;
31
- _id: AccessorFn;
32
- _label: AccessorFn;
33
32
  _labelClass: TextBox;
34
- _labelConfig: Record<string, unknown>;
35
- _labelBounds: ((d: DataPoint, i: number, aes: ShapeAes) => Record<string, unknown> | null | false) | null;
36
33
  _name: string;
37
- _opacity: AccessorFn;
38
- _pointerEvents: AccessorFn;
39
- _role: AccessorFn;
40
- _rotate: AccessorFn;
41
- _rx: AccessorFn;
42
- _ry: AccessorFn;
43
- _scale: AccessorFn;
44
- _shapeRendering: AccessorFn;
45
- _stroke: AccessorFn;
46
- _strokeDasharray: AccessorFn;
47
- _strokeLinecap: AccessorFn;
48
- _strokeOpacity: AccessorFn;
49
- _strokeWidth: AccessorFn;
50
34
  _tagName: string;
51
- _textAnchor: AccessorFn;
52
- _texture: AccessorFn;
53
- _textureDefault: Record<string, unknown>;
54
35
  _textureDefs: Record<string, Record<string, unknown>>;
55
- _vectorEffect: AccessorFn;
56
- _verticalAlign: AccessorFn;
57
- _x: AccessorFn;
58
- _y: AccessorFn;
59
36
  _select: D3Selection;
60
37
  _transition: ReturnType<typeof transition>;
61
38
  /** @param data The raw data array to filter. */
62
39
  _dataFilter?(data: DataPoint[]): DataPoint[];
63
- _sort: ((a: DataPoint, b: DataPoint) => number) | null;
64
40
  _group: D3Selection;
65
41
  _update: D3Selection;
66
42
  _enter: D3Selection;
67
43
  _exit: D3Selection;
68
44
  _hoverGroup: D3Selection;
69
45
  _activeGroup: D3Selection;
70
- _hitArea: ((d: DataPoint, i: number, aes: ShapeAes) => Record<string, unknown>) | null;
71
- _active: ((d: DataPoint, i: number) => boolean) | null;
72
- _hover: ((d: DataPoint, i: number) => boolean) | null;
73
- _discrete: string | undefined;
74
46
  _path: Record<string, unknown>;
75
- _defined: AccessorFn;
76
- _curve: AccessorFn;
47
+ /** SvgRenderer mounted by the standalone `render()` path; reused across redraws. */
48
+ _sceneRenderer?: SvgRenderer;
77
49
  /**
78
50
  Invoked when creating a new class instance, and sets any default parameters.
79
51
  @private
@@ -86,112 +58,75 @@ export default class Shape extends BaseClass {
86
58
  */
87
59
  _aes(_d?: DataPoint, _i?: number): ShapeAes;
88
60
  /**
89
- Adds event listeners to each shape group or hit area.
90
- @private
91
- */
92
- _applyEvents(handler: D3Selection): void;
93
- /**
94
- Provides the updated styling to the given shape elements.
61
+ Returns a full JSON string of the texture config for a given data point.
95
62
 
96
63
  @private
97
64
  */
98
- _updateStyle(elem: D3Selection, style: Record<string, unknown>): void;
99
- /**
100
- Provides the default styling to the shape elements.
101
- @param elem @private
102
- */
103
- _applyStyle(elem: D3Selection): void;
65
+ _getTextureKey(d: DataPoint, i: number): string | false;
104
66
  /**
105
- Calculates the transform for the group elements.
67
+ Checks for nested data and uses the appropriate variables for accessor functions.
106
68
  @param elem @private
107
69
  */
108
- _applyTransform(elem: D3Selection): void;
70
+ _nestWrapper(method: AccessorFn): (d: DataPoint, i: number) => DataPoint[keyof DataPoint];
109
71
  /**
110
- Returns a full JSON string of the texture config for a given data point.
111
-
72
+ Adds labels to each shape group.
112
73
  @private
113
74
  */
114
- _getTextureKey(d: DataPoint, i: number): string | false;
75
+ _buildLabelData(): DataPoint[];
115
76
  /**
116
- Checks for nested data and uses the appropriate variables for accessor functions.
117
- @param elem @private
77
+ Renders the current Shape to the page. If a *callback* is specified, it will be called once the shapes are done drawing.
78
+ @param callback Optional callback invoked after rendering completes.
118
79
  */
119
- _nestWrapper(method: AccessorFn): (d: DataPoint, i: number) => DataPoint[keyof DataPoint];
120
80
  /**
121
- Modifies existing shapes to show active status.
81
+ Resolves a style accessor for a data point, mirroring the nested-data logic
82
+ of _applyStyle so scene output matches DOM rendering.
122
83
  @private
123
84
  */
124
- _renderActive(): void;
85
+ _styleVal(fn: unknown, d: DataPoint, i: number): unknown;
125
86
  /**
126
- Modifies existing shapes to show hover status.
87
+ Builds the resolved Transform for a data point, mirroring _applyTransform.
127
88
  @private
128
89
  */
129
- _renderHover(): void;
90
+ _sceneTransform(d: DataPoint, i: number): Transform;
130
91
  /**
131
- Adds background image to each shape group.
92
+ Builds the resolved Paint for a data point, mirroring _applyStyle.
93
+ Texture fills are encoded as a stable "pattern:<key>" token at this
94
+ layer; the backend renderers (`SvgRenderer._resolveFill`,
95
+ `CanvasRenderer._resolveFill`) materialize them into a real SVG
96
+ pattern or a Canvas image pattern. The two-stage resolve is
97
+ intentional — Shapes stay backend-free, and texture
98
+ materialization happens once per renderer instead of per-shape.
132
99
  @private
133
100
  */
134
- _renderImage(): void;
101
+ _scenePaint(d: DataPoint, i: number): Paint;
135
102
  /**
136
- Adds labels to each shape group.
103
+ Returns the geometry-specific scene fields for a data point. Overridden by
104
+ each shape subclass; the base provides none.
137
105
  @private
138
106
  */
139
- _renderLabels(): void;
107
+ _sceneGeometry(_d: DataPoint, _i: number): Record<string, unknown> | null;
140
108
  /**
141
- Renders the current Shape to the page. If a *callback* is specified, it will be called once the shapes are done drawing.
142
- @param callback Optional callback invoked after rendering completes.
109
+ Produces a backend-agnostic scene graph for this shape's data, reusing the
110
+ same accessors render() applies to the DOM. This is the migration seam toward
111
+ the @d3plus/render pluggable backends; it has no effect on render().
143
112
  */
113
+ toScene(): GroupNode;
144
114
  render(callback?: () => void): this;
145
115
  /**
146
116
  The active callback function for highlighting shapes.
147
117
  */
148
118
  active(): ((d: DataPoint, i: number) => boolean) | null;
149
119
  active(_: ((d: DataPoint, i: number) => boolean) | null): this;
150
- /**
151
- When shapes are active, this is the opacity of any shape that is not active.
152
- */
153
- activeOpacity(): number;
154
- activeOpacity(_: number): this;
155
120
  /**
156
121
  The style to apply to active shapes.
157
122
  */
158
123
  activeStyle(): Record<string, unknown>;
159
124
  activeStyle(_: Record<string, unknown>): this;
160
- /**
161
- The aria-label attribute for each shape.
162
- */
163
- ariaLabel(): AccessorFn;
164
- ariaLabel(_: AccessorFn | string): this;
165
- /**
166
- The background-image accessor for each shape.
167
- */
168
- backgroundImage(): AccessorFn;
169
- backgroundImage(_: AccessorFn | string): this;
170
125
  /**
171
126
  The data array used to create shapes. A shape will be drawn for each object in the array.
172
127
  */
173
128
  data(): DataPoint[];
174
129
  data(_: DataPoint[]): this;
175
- /**
176
- Determines if either the X or Y position is discrete along a Line, which helps in determining the nearest data point on a line for a hit area event.
177
- */
178
- discrete(): string | undefined;
179
- discrete(_: string): this;
180
- /**
181
- The animation duration in milliseconds.
182
- */
183
- duration(): number;
184
- duration(_: number): this;
185
- /**
186
- The fill color accessor for each shape.
187
- */
188
- fill(): AccessorFn;
189
- fill(_: AccessorFn | string): this;
190
- /**
191
- Defines the "fill-opacity" attribute for the shapes.
192
- */
193
- fillOpacity(): AccessorFn;
194
- fillOpacity(_: AccessorFn | number): this;
195
130
  /**
196
131
  The hover callback function for highlighting shapes on mouseover.
197
132
  */
@@ -202,177 +137,31 @@ export default class Shape extends BaseClass {
202
137
  */
203
138
  hoverStyle(): Record<string, unknown>;
204
139
  hoverStyle(_: Record<string, unknown>): this;
205
- /**
206
- The opacity of non-hovered shapes when any shape is hovered.
207
- */
208
- hoverOpacity(): number;
209
- hoverOpacity(_: number): this;
210
- /**
211
- The mouse hit area accessor function.
212
- @example
213
- function(d, i, shape) {
214
- return {
215
- "width": shape.width,
216
- "height": shape.height,
217
- "x": -shape.width / 2,
218
- "y": -shape.height / 2
219
- };
220
- }
221
- */
222
- hitArea(): ((d: DataPoint, i: number, aes: Record<string, unknown>) => Record<string, unknown>) | null;
223
- hitArea(_: ((d: DataPoint, i: number, aes: Record<string, unknown>) => Record<string, unknown>) | Record<string, unknown>): this;
224
- /**
225
- The unique id accessor for each shape.
226
- */
227
- id(): AccessorFn;
228
- id(_: AccessorFn): this;
229
- /**
230
- The text label accessor for each shape.
231
- */
232
- label(): AccessorFn;
233
- label(_: AccessorFn | string | string[]): this;
234
- /**
235
- The label bounds accessor function.
236
- @example
237
- function(d, i, shape) {
238
- return {
239
- "width": shape.width,
240
- "height": shape.height,
241
- "x": -shape.width / 2,
242
- "y": -shape.height / 2
243
- };
244
- }
245
- */
246
- labelBounds(): ((d: DataPoint, i: number, aes: Record<string, unknown>) => Record<string, unknown> | null | false) | null;
247
- labelBounds(_: ((d: DataPoint, i: number, aes: Record<string, unknown>) => Record<string, unknown> | null | false) | Record<string, unknown>): this;
248
140
  /**
249
141
  A pass-through to the config method of the TextBox class used to create a shape's labels.
250
142
  */
251
143
  labelConfig(): Record<string, unknown>;
252
144
  labelConfig(_: Record<string, unknown>): this;
253
- /**
254
- The opacity accessor for each shape.
255
- */
256
- opacity(): AccessorFn;
257
- opacity(_: AccessorFn | number): this;
258
- /**
259
- The pointer-events CSS property for each shape.
260
- */
261
- pointerEvents(): AccessorFn;
262
- pointerEvents(_: AccessorFn | string): this;
263
- /**
264
- The role attribute.
265
- */
266
- role(): AccessorFn;
267
- role(_: AccessorFn | string): this;
268
- /**
269
- The rotation angle in degrees for each shape.
270
- */
271
- rotate(): AccessorFn;
272
- rotate(_: AccessorFn | number): this;
273
- /**
274
- Defines the "rx" attribute for the shapes.
275
- */
276
- rx(): AccessorFn;
277
- rx(_: AccessorFn | number): this;
278
- /**
279
- Defines the "rx" attribute for the shapes.
280
- */
281
- ry(): AccessorFn;
282
- ry(_: AccessorFn | number): this;
283
- /**
284
- The scale transform accessor for each shape.
285
- */
286
- scale(): AccessorFn;
287
- scale(_: AccessorFn | number): this;
288
145
  /**
289
146
  The SVG container element as a d3 selector or DOM element.
290
147
  */
291
148
  select(): D3Selection;
292
149
  select(_: string | HTMLElement | SVGElement | null): this;
293
- /**
294
- The shape-rendering.
295
-
296
- @example
297
- function(d) {
298
- return d.x;
299
- }
300
- */
301
- shapeRendering(): AccessorFn;
302
- shapeRendering(_: AccessorFn | string): this;
303
150
  /**
304
151
  A comparator function used to sort shapes for layering order.
305
152
  */
306
153
  sort(): ((a: DataPoint, b: DataPoint) => number) | null;
307
154
  sort(_: ((a: DataPoint, b: DataPoint) => number) | null): this;
308
- /**
309
- The stroke color accessor for each shape.
310
- */
311
- stroke(): AccessorFn;
312
- stroke(_: AccessorFn | string): this;
313
- /**
314
- Defines the "stroke-dasharray" attribute for the shapes.
315
- */
316
- strokeDasharray(): AccessorFn;
317
- strokeDasharray(_: AccessorFn | string): this;
318
- /**
319
- Defines the "stroke-linecap" attribute for the shapes. Accepted values are `"butt"`, `"round"`, and `"square"`.
320
- */
321
- strokeLinecap(): AccessorFn;
322
- strokeLinecap(_: AccessorFn | string): this;
323
- /**
324
- Defines the "stroke-opacity" attribute for the shapes.
325
- */
326
- strokeOpacity(): AccessorFn;
327
- strokeOpacity(_: AccessorFn | number): this;
328
- /**
329
- The stroke-width.
330
- */
331
- strokeWidth(): AccessorFn;
332
- strokeWidth(_: AccessorFn | number): this;
333
- /**
334
- The text-anchor.
335
- */
336
- textAnchor(): AccessorFn;
337
- textAnchor(_: AccessorFn | string): this;
338
- /**
339
- Defines the texture used inside of each shape. This uses the [textures.js](https://riccardoscalco.it/textures/) package, and expects either a simple string (`"lines"` or `"circles"`) or a more complex Object containing the various properties of the texture (ie. `{texture: "lines", orientation: "3/8", stroke: "darkorange"}`). If multiple textures are necessary, provide an accsesor Function that returns the correct String/Object for each given data point and index.
340
- */
341
- texture(): AccessorFn;
342
- texture(_: AccessorFn | string | Record<string, unknown>): this;
343
155
  /**
344
156
  A series of global texture methods to be used for all textures (ie. `{stroke: "darkorange", strokeWidth: 2}`).
345
157
  */
346
158
  textureDefault(): Record<string, unknown>;
347
159
  textureDefault(_: Record<string, unknown>): this;
348
160
  /**
349
- The vector-effect.
350
- */
351
- vectorEffect(): AccessorFn;
352
- vectorEffect(_: AccessorFn | string): this;
353
- /**
354
- The vertical alignment.
355
- */
356
- verticalAlign(): AccessorFn;
357
- verticalAlign(_: AccessorFn | string): this;
358
- /**
359
- The x position accessor for each shape.
360
-
361
- @example
362
- function(d) {
363
- return d.x;
364
- }
365
- */
366
- x(): AccessorFn;
367
- x(_: AccessorFn | number): this;
368
- /**
369
- The y position accessor for each shape.
370
-
371
- @example
372
- function(d) {
373
- return d.y;
374
- }
375
- */
376
- y(): AccessorFn;
377
- y(_: AccessorFn | number): this;
161
+ Narrowed `.config()` for Shape. Inherited surface from
162
+ `BaseClass.config()`; the override exists only to surface per-shape
163
+ keys (e.g. `width`/`height` for Rect) in autocomplete + type checks.
164
+ */
165
+ config(): BaseShapeConfig;
166
+ config(_: Partial<BaseShapeConfig>): this;
378
167
  }
@@ -1,21 +1,16 @@
1
1
  import type { DataPoint } from "@d3plus/data";
2
2
  import type { D3Selection } from "@d3plus/dom";
3
+ import type { GroupNode } from "@d3plus/render";
3
4
  import { BaseClass } from "../utils/index.js";
4
- import type { AccessorFn } from "../utils/index.js";
5
5
  import Circle from "./Circle.js";
6
6
  import Line from "./Line.js";
7
7
  import Rect from "./Rect.js";
8
+ import type { WhiskerConfig } from "./shapeConfig.js";
8
9
  /**
9
10
  Creates SVG whisker based on an array of data.
10
11
  */
11
12
  export default class Whisker extends BaseClass {
12
- _endpoint: AccessorFn;
13
- _endpointConfig: Record<string, unknown>;
14
- _length: AccessorFn;
15
- _lineConfig: Record<string, unknown>;
16
- _orient: AccessorFn;
17
- _x: AccessorFn;
18
- _y: AccessorFn;
13
+ [key: string]: any;
19
14
  _data: DataPoint[];
20
15
  _select: D3Selection;
21
16
  _line: Line;
@@ -30,6 +25,12 @@ export default class Whisker extends BaseClass {
30
25
  @param callback Optional callback invoked after rendering completes.
31
26
  */
32
27
  render(callback?: () => void): this;
28
+ /**
29
+ Compute-mode scene aggregation, mirroring Box.toScene(). Returns a
30
+ GroupNode containing the inner Line's scene children plus each
31
+ endpoint shape's scene children.
32
+ */
33
+ toScene(): GroupNode;
33
34
  /**
34
35
  The active highlight state for all sub-shapes in this Whisker.
35
36
  */
@@ -39,11 +40,6 @@ export default class Whisker extends BaseClass {
39
40
  */
40
41
  data(): DataPoint[];
41
42
  data(_: DataPoint[]): this;
42
- /**
43
- The endpoint shape type for each whisker.
44
- */
45
- endpoint(): AccessorFn;
46
- endpoint(_: AccessorFn | string): this;
47
43
  /**
48
44
  Configuration object for each endpoint.
49
45
  */
@@ -53,44 +49,21 @@ export default class Whisker extends BaseClass {
53
49
  The hover highlight state for all sub-shapes in this Whisker.
54
50
  */
55
51
  hover(_: ((d: DataPoint, i: number) => boolean) | null): void;
56
- /**
57
- Length accessor for whisker.
58
- */
59
- length(): AccessorFn;
60
- length(_: AccessorFn | number): this;
61
52
  /**
62
53
  Configuration object for the line shape.
63
54
  */
64
55
  lineConfig(): Record<string, unknown>;
65
56
  lineConfig(_: Record<string, unknown>): this;
66
- /**
67
- The orientation of the whisker shape.
68
- */
69
- orient(): AccessorFn;
70
- orient(_: AccessorFn | string): this;
71
57
  /**
72
58
  The SVG container element for this visualization. 3 selector or DOM element.
73
59
  */
74
60
  select(): D3Selection;
75
61
  select(_: string | HTMLElement | SVGElement | null): this;
76
62
  /**
77
- The x position accessor for each whisker.
78
-
79
- @example
80
- function(d) {
81
- return d.x;
82
- }
83
- */
84
- x(): AccessorFn;
85
- x(_: AccessorFn | number): this;
86
- /**
87
- The y position accessor for each whisker.
88
-
89
- @example
90
- function(d) {
91
- return d.y;
92
- }
93
- */
94
- y(): AccessorFn;
95
- y(_: AccessorFn | number): this;
63
+ Narrowed `.config()` for Whisker. Inherited surface from
64
+ `BaseClass.config()`; the override exists only to surface per-shape
65
+ keys (e.g. `width`/`height` for Rect) in autocomplete + type checks.
66
+ */
67
+ config(): WhiskerConfig;
68
+ config(_: Partial<WhiskerConfig>): this;
96
69
  }
@@ -0,0 +1,50 @@
1
+ /**
2
+ `buildLabelData(opts)` — pure label-layout function extracted from
3
+ `Shape._buildLabelData()`.
4
+
5
+ Given the inputs that a Shape would otherwise hold as `this._label`/
6
+ `this._labelBounds`/`this._x`/`this._y`/`this._aes`/`this._rotate`/
7
+ `this._id`/`this._data`, produces the array of label-record DataPoints
8
+ that a TextBox can render. No Shape instance required.
9
+
10
+ Emit functions that would otherwise instantiate
11
+ `new Rect().renderMode("compute").render()` only to read back the label
12
+ compute via `_labelClass` can call this directly + emit their own text
13
+ nodes — no Shape class needed for labels-only data flows. The Shape
14
+ classes themselves reach it through `this._buildLabelData()`.
15
+ */
16
+ import type { DataPoint } from "@d3plus/data";
17
+ type Accessor<T = unknown> = (d: DataPoint, i: number) => T;
18
+ type AesFn = (d: DataPoint, i: number) => unknown;
19
+ type BoundsFn = (d: DataPoint, i: number, aesValue: unknown) => Record<string, unknown> | Record<string, unknown>[] | false | null | undefined;
20
+ export interface BuildLabelDataOpts {
21
+ /** Source data array. */
22
+ data: DataPoint[];
23
+ /** Optional filter applied to `data` before iterating. */
24
+ dataFilter?: (data: DataPoint[]) => DataPoint[];
25
+ /** Returns the label text (or array of texts) for a datum. False/undefined skips. */
26
+ label: Accessor;
27
+ /** Returns the label bounds (or array of bounds per label) for a datum. Required for labels to surface. */
28
+ labelBounds?: BoundsFn;
29
+ /** Returns the x position for a datum. */
30
+ x: Accessor<number>;
31
+ /** Returns the y position for a datum. */
32
+ y: Accessor<number>;
33
+ /** Returns the aesthetic record for a datum (passed to `labelBounds`). */
34
+ aes: AesFn;
35
+ /** Returns the rotation angle (degrees) for a datum. */
36
+ rotate: Accessor<number>;
37
+ /** Returns the unique id for a datum. */
38
+ id: Accessor<string | number>;
39
+ /**
40
+ Resolves the source row stored as each label record's `.data`. Defaults to
41
+ the iterated datum itself. Charts whose `data` array is a layout/hierarchy
42
+ node (e.g. Pack's d3-hierarchy nodes) pass `d => d.data` so the label
43
+ resolves to the same source row its shape node carries — without it, the
44
+ shape and its label unwrap to different objects and hover treats them
45
+ separately (the shape highlights/raises while the label dims behind it).
46
+ */
47
+ datum?: (d: DataPoint, i: number) => DataPoint;
48
+ }
49
+ export declare function buildLabelData(opts: BuildLabelDataOpts): DataPoint[];
50
+ export {};