@mathstack/viz 1.1.5 → 2.0.3

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 (701) hide show
  1. package/CHANGELOG.md +0 -0
  2. package/LICENSE +21 -21
  3. package/README.md +11 -11
  4. package/cypress/fixtures/example.json +5 -0
  5. package/cypress/fixtures/usMap.json +13511 -0
  6. package/cypress/support/commands.ts +104 -0
  7. package/cypress/support/component-index.html +12 -0
  8. package/cypress/support/component.ts +33 -0
  9. package/cypress.config.ts +9 -0
  10. package/karma.conf.js +62 -0
  11. package/ng-package.json +8 -0
  12. package/package.json +10 -19
  13. package/project.json +97 -0
  14. package/src/.eslintrc.json +35 -0
  15. package/src/.prettierrc +31 -0
  16. package/src/lib/axes/base/config/xy-axis-builder.ts +68 -0
  17. package/src/lib/axes/base/config/xy-axis-config.ts +35 -0
  18. package/{lib/axes/base/config/xy-axis-options.d.ts → src/lib/axes/base/config/xy-axis-options.ts} +11 -10
  19. package/src/lib/axes/base/xy-axis-base.spec.ts +114 -0
  20. package/src/lib/axes/base/xy-axis-base.ts +300 -0
  21. package/src/lib/axes/base/xy-axis-domain-lines.cy.ts +511 -0
  22. package/src/lib/axes/baseline/axis-baseline-builder.ts +77 -0
  23. package/src/lib/axes/baseline/axis-baseline-options.ts +4 -0
  24. package/src/lib/axes/baseline/axis-baseline.ts +11 -0
  25. package/src/lib/axes/grid/grid-builder.ts +74 -0
  26. package/src/lib/axes/grid/grid-config.ts +13 -0
  27. package/src/lib/axes/grid/grid-options.ts +7 -0
  28. package/src/lib/axes/index.ts +40 -0
  29. package/src/lib/axes/label/axis-label-builder.ts +140 -0
  30. package/src/lib/axes/label/axis-label-options.ts +12 -0
  31. package/src/lib/axes/label/axis-label.ts +18 -0
  32. package/src/lib/axes/label/axis-labels.cy.ts +303 -0
  33. package/src/lib/axes/ordinal/ordinal-axis-config.ts +31 -0
  34. package/src/lib/axes/ordinal/ordinal-axis.spec.ts +30 -0
  35. package/src/lib/axes/ordinal/ordinal-axis.ts +26 -0
  36. package/src/lib/axes/quantitative/quantitative-axis-config.ts +39 -0
  37. package/src/lib/axes/quantitative/quantitative-axis-ticks.cy.ts +748 -0
  38. package/src/lib/axes/quantitative/quantitative-axis.spec.ts +537 -0
  39. package/src/lib/axes/quantitative/quantitative-axis.ts +191 -0
  40. package/src/lib/axes/ticks/tick-wrap/tick-wrap-builder.ts +141 -0
  41. package/src/lib/axes/ticks/tick-wrap/tick-wrap-options.ts +11 -0
  42. package/src/lib/axes/ticks/tick-wrap/tick-wrap.cy.ts +360 -0
  43. package/src/lib/axes/ticks/tick-wrap/tick-wrap.ts +21 -0
  44. package/src/lib/axes/ticks/ticks-builder.ts +370 -0
  45. package/src/lib/axes/ticks/ticks-options.ts +24 -0
  46. package/src/lib/axes/ticks/ticks.ts +33 -0
  47. package/src/lib/axes/x/x-axis-config.ts +48 -0
  48. package/src/lib/axes/x/x-axis.spec.ts +90 -0
  49. package/src/lib/axes/x/x-axis.ts +109 -0
  50. package/src/lib/axes/x-ordinal/x-ordinal-axis-builder.ts +75 -0
  51. package/src/lib/axes/x-ordinal/x-ordinal-axis-config.ts +27 -0
  52. package/src/lib/axes/x-ordinal/x-ordinal-axis.component.ts +33 -0
  53. package/src/lib/axes/x-quantitative/x-quantitative-axis-builder.ts +74 -0
  54. package/src/lib/axes/x-quantitative/x-quantitative-axis-config.ts +32 -0
  55. package/src/lib/axes/x-quantitative/x-quantitative-axis.component.ts +40 -0
  56. package/src/lib/axes/xy-axis.module.ts +20 -0
  57. package/src/lib/axes/y/y-axis-config.ts +47 -0
  58. package/src/lib/axes/y/y-axis.spec.ts +92 -0
  59. package/src/lib/axes/y/y-axis.ts +161 -0
  60. package/src/lib/axes/y-ordinal/y-ordinal-axis-builder.ts +76 -0
  61. package/src/lib/axes/y-ordinal/y-ordinal-axis-config.ts +29 -0
  62. package/src/lib/axes/y-ordinal/y-ordinal-axis.component.ts +33 -0
  63. package/src/lib/axes/y-quantitative-axis/y-quantitative-axis-builder.ts +74 -0
  64. package/src/lib/axes/y-quantitative-axis/y-quantitative-axis-config.ts +34 -0
  65. package/src/lib/axes/y-quantitative-axis/y-quantitative-axis.component.ts +40 -0
  66. package/src/lib/bars/bars.component.scss +0 -0
  67. package/src/lib/bars/bars.component.spec.ts +1470 -0
  68. package/src/lib/bars/bars.component.ts +717 -0
  69. package/src/lib/bars/bars.cy.ts +829 -0
  70. package/src/lib/bars/bars.module.ts +9 -0
  71. package/src/lib/bars/config/backgrounds/bars-backgrounds-builder.ts +51 -0
  72. package/{lib/bars/config/backgrounds/bars-backgrounds-options.d.ts → src/lib/bars/config/backgrounds/bars-backgrounds-options.ts} +4 -4
  73. package/src/lib/bars/config/backgrounds/bars-backgrounds.ts +11 -0
  74. package/src/lib/bars/config/bars-builder.ts +340 -0
  75. package/src/lib/bars/config/bars-config.spec.ts +132 -0
  76. package/src/lib/bars/config/bars-config.ts +70 -0
  77. package/src/lib/bars/config/bars-dimensions.ts +29 -0
  78. package/{lib/bars/config/bars-options.d.ts → src/lib/bars/config/bars-options.ts} +20 -16
  79. package/src/lib/bars/config/labels/bars-labels-builder.ts +89 -0
  80. package/src/lib/bars/config/labels/bars-labels-options.ts +6 -0
  81. package/src/lib/bars/config/labels/bars-labels.cy.ts +781 -0
  82. package/src/lib/bars/config/labels/bars-labels.ts +13 -0
  83. package/src/lib/bars/events/actions/bars-click-actions.ts +23 -0
  84. package/src/lib/bars/events/actions/bars-hover-actions.ts +43 -0
  85. package/src/lib/bars/events/actions/bars-hover-move-actions.ts +21 -0
  86. package/src/lib/bars/events/bars-events.directive.spec.ts +186 -0
  87. package/src/lib/bars/events/bars-events.directive.ts +235 -0
  88. package/src/lib/bars/events/bars-interaction-output.ts +17 -0
  89. package/src/lib/bars/events/bars-tooltip-positioner.ts +24 -0
  90. package/{lib/bars/index.d.ts → src/lib/bars/index.ts} +18 -12
  91. package/src/lib/charts/chart/chart-scaling.cy.ts +323 -0
  92. package/src/lib/charts/chart/chart.component.html +45 -0
  93. package/src/lib/charts/chart/chart.component.scss +37 -0
  94. package/src/lib/charts/chart/chart.component.ts +243 -0
  95. package/{lib/charts/chart/chart.token.d.ts → src/lib/charts/chart/chart.token.ts} +4 -3
  96. package/src/lib/charts/chart/chart.ts +5 -0
  97. package/src/lib/charts/chart/config/chart-builder.ts +194 -0
  98. package/src/lib/charts/chart/config/chart-config.ts +21 -0
  99. package/src/lib/charts/chart/config/chart-options.ts +11 -0
  100. package/src/lib/charts/chart.module.ts +10 -0
  101. package/{lib/charts/index.d.ts → src/lib/charts/index.ts} +9 -8
  102. package/src/lib/charts/map-chart/map-chart.component.scss +0 -0
  103. package/src/lib/charts/map-chart/map-chart.component.spec.ts +35 -0
  104. package/src/lib/charts/map-chart/map-chart.component.ts +61 -0
  105. package/src/lib/charts/xy-chart/xy-chart.component.spec.ts +34 -0
  106. package/src/lib/charts/xy-chart/xy-chart.component.ts +65 -0
  107. package/src/lib/core/common-behaviors/constructor.ts +7 -0
  108. package/src/lib/core/index.ts +11 -0
  109. package/src/lib/core/pipes/resize-chart-height.pipe.spec.ts +23 -0
  110. package/src/lib/core/pipes/resize-chart-height.pipe.ts +20 -0
  111. package/src/lib/core/styles/_spacing.scss +4 -0
  112. package/src/lib/core/types/layout.ts +28 -0
  113. package/src/lib/core/types/scale.ts +6 -0
  114. package/src/lib/core/types/utility.ts +11 -0
  115. package/{lib/core/types/values.d.ts → src/lib/core/types/values.ts} +10 -7
  116. package/src/lib/core/utilities/colors.spec.ts +57 -0
  117. package/src/lib/core/utilities/colors.ts +42 -0
  118. package/src/lib/core/utilities/fill-utilities.spec.ts +25 -0
  119. package/src/lib/core/utilities/fill-utilities.ts +21 -0
  120. package/src/lib/core/utilities/type-guards.spec.ts +55 -0
  121. package/src/lib/core/utilities/type-guards.ts +33 -0
  122. package/src/lib/core/utilities/value-format.ts +21 -0
  123. package/src/lib/core/utilities/values.spec.ts +954 -0
  124. package/src/lib/core/utilities/values.ts +189 -0
  125. package/src/lib/data-dimensions/continuous-quantitative/date-chart-position/date-chart-position-builder.ts +105 -0
  126. package/src/lib/data-dimensions/continuous-quantitative/date-chart-position/date-chart-position-options.ts +24 -0
  127. package/src/lib/data-dimensions/continuous-quantitative/date-chart-position/date-chart-position.spec.ts +66 -0
  128. package/src/lib/data-dimensions/continuous-quantitative/date-chart-position/date-chart-position.ts +72 -0
  129. package/{lib/data-dimensions/continuous-quantitative/number-chart-position/domain-padding/concrete-domain-padding.d.ts → src/lib/data-dimensions/continuous-quantitative/number-chart-position/domain-padding/concrete-domain-padding.ts} +10 -5
  130. package/src/lib/data-dimensions/continuous-quantitative/number-chart-position/domain-padding/domain-padding.ts +76 -0
  131. package/src/lib/data-dimensions/continuous-quantitative/number-chart-position/domain-padding/domain-test-utility.ts +130 -0
  132. package/{lib/data-dimensions/continuous-quantitative/number-chart-position/domain-padding/percent-over/percent-over-options.d.ts → src/lib/data-dimensions/continuous-quantitative/number-chart-position/domain-padding/percent-over/percent-over-options.ts} +3 -3
  133. package/src/lib/data-dimensions/continuous-quantitative/number-chart-position/domain-padding/percent-over/percent-over.ts +37 -0
  134. package/{lib/data-dimensions/continuous-quantitative/number-chart-position/domain-padding/pixel/pixel-options.d.ts → src/lib/data-dimensions/continuous-quantitative/number-chart-position/domain-padding/pixel/pixel-options.ts} +3 -3
  135. package/src/lib/data-dimensions/continuous-quantitative/number-chart-position/domain-padding/pixel/pixel.ts +73 -0
  136. package/src/lib/data-dimensions/continuous-quantitative/number-chart-position/domain-padding/quantitative-domain-padding.cy.ts +978 -0
  137. package/{lib/data-dimensions/continuous-quantitative/number-chart-position/domain-padding/round-to-interval/round-to-interval-options.d.ts → src/lib/data-dimensions/continuous-quantitative/number-chart-position/domain-padding/round-to-interval/round-to-interval-options.ts} +3 -3
  138. package/src/lib/data-dimensions/continuous-quantitative/number-chart-position/domain-padding/round-to-interval/round-to-interval.ts +27 -0
  139. package/{lib/data-dimensions/continuous-quantitative/number-chart-position/domain-padding/round-to-sig-fig/round-to-sig-fig-options.d.ts → src/lib/data-dimensions/continuous-quantitative/number-chart-position/domain-padding/round-to-sig-fig/round-to-sig-fig-options.ts} +3 -3
  140. package/src/lib/data-dimensions/continuous-quantitative/number-chart-position/domain-padding/round-to-sig-fig/round-to-sig-fig.ts +30 -0
  141. package/src/lib/data-dimensions/continuous-quantitative/number-chart-position/number-chart-position-builder.ts +183 -0
  142. package/{lib/data-dimensions/continuous-quantitative/number-chart-position/number-chart-position-options.d.ts → src/lib/data-dimensions/continuous-quantitative/number-chart-position/number-chart-position-options.ts} +8 -5
  143. package/src/lib/data-dimensions/continuous-quantitative/number-chart-position/number-chart-position.spec.ts +28 -0
  144. package/{lib/data-dimensions/continuous-quantitative/number-chart-position/number-chart-position.d.ts → src/lib/data-dimensions/continuous-quantitative/number-chart-position/number-chart-position.ts} +62 -30
  145. package/src/lib/data-dimensions/continuous-quantitative/number-dimension/number-dimension-options.ts +15 -0
  146. package/src/lib/data-dimensions/continuous-quantitative/number-dimension/number-dimension.spec.ts +155 -0
  147. package/src/lib/data-dimensions/continuous-quantitative/number-dimension/number-dimension.ts +57 -0
  148. package/src/lib/data-dimensions/continuous-quantitative/number-visual-value/number-visual-value-builder.ts +166 -0
  149. package/src/lib/data-dimensions/continuous-quantitative/number-visual-value/number-visual-value-options.ts +10 -0
  150. package/src/lib/data-dimensions/continuous-quantitative/number-visual-value/number-visual-value.spec.ts +34 -0
  151. package/{lib/data-dimensions/continuous-quantitative/number-visual-value/number-visual-value.d.ts → src/lib/data-dimensions/continuous-quantitative/number-visual-value/number-visual-value.ts} +57 -29
  152. package/src/lib/data-dimensions/dimension-builder.ts +45 -0
  153. package/src/lib/data-dimensions/dimension-options.ts +12 -0
  154. package/src/lib/data-dimensions/dimension.ts +30 -0
  155. package/src/lib/data-dimensions/index.ts +31 -0
  156. package/src/lib/data-dimensions/ordinal/ordinal-chart-position/ordinal-chart-position-builder.ts +122 -0
  157. package/src/lib/data-dimensions/ordinal/ordinal-chart-position/ordinal-chart-position-options.ts +12 -0
  158. package/src/lib/data-dimensions/ordinal/ordinal-chart-position/ordinal-chart-position.spec.ts +83 -0
  159. package/src/lib/data-dimensions/ordinal/ordinal-chart-position/ordinal-chart-position.ts +101 -0
  160. package/src/lib/data-dimensions/ordinal/ordinal-visual-value/ordinal-visual-value-builder.ts +108 -0
  161. package/src/lib/data-dimensions/ordinal/ordinal-visual-value/ordinal-visual-value-options.ts +12 -0
  162. package/src/lib/data-dimensions/ordinal/ordinal-visual-value/ordinal-visual-value.cy.ts +384 -0
  163. package/src/lib/data-dimensions/ordinal/ordinal-visual-value/ordinal-visual-value.spec.ts +63 -0
  164. package/src/lib/data-dimensions/ordinal/ordinal-visual-value/ordinal-visual-value.ts +79 -0
  165. package/src/lib/data-export/data-export-config.ts +98 -0
  166. package/src/lib/data-export/data-export.spec.ts +33 -0
  167. package/src/lib/data-export/data-export.ts +87 -0
  168. package/{lib/data-export/index.d.ts → src/lib/data-export/index.ts} +2 -2
  169. package/src/lib/dots/config/dots-builder.ts +442 -0
  170. package/src/lib/dots/config/dots-config.spec.ts +123 -0
  171. package/src/lib/dots/config/dots-config.ts +81 -0
  172. package/{lib/dots/config/dots-options.d.ts → src/lib/dots/config/dots-options.ts} +32 -17
  173. package/src/lib/dots/dots.component.scss +0 -0
  174. package/src/lib/dots/dots.component.spec.ts +143 -0
  175. package/src/lib/dots/dots.component.ts +291 -0
  176. package/src/lib/dots/dots.cy.ts +594 -0
  177. package/src/lib/dots/dots.module.ts +9 -0
  178. package/src/lib/dots/events/actions/dots-hover-actions.ts +19 -0
  179. package/src/lib/dots/events/actions/dots-hover-move-actions.ts +38 -0
  180. package/src/lib/dots/events/dots-events.directive.ts +214 -0
  181. package/src/lib/dots/events/dots-interaction-output.ts +15 -0
  182. package/src/lib/dots/events/dots-tooltip-positioner.ts +24 -0
  183. package/{lib/dots/index.d.ts → src/lib/dots/index.ts} +10 -9
  184. package/src/lib/events/events.directive.ts +184 -0
  185. package/src/lib/events/events.types.ts +57 -0
  186. package/{lib/events/index.d.ts → src/lib/events/index.ts} +4 -4
  187. package/src/lib/events/interaction-output.ts +34 -0
  188. package/src/lib/events/tooltip-positioner.ts +15 -0
  189. package/src/lib/fill-definitions/fill-definitions.ts +4 -0
  190. package/{lib/fill-definitions/index.d.ts → src/lib/fill-definitions/index.ts} +1 -1
  191. package/src/lib/geographies/config/geographies-builder.ts +224 -0
  192. package/src/lib/geographies/config/geographies-config.spec.ts +100 -0
  193. package/src/lib/geographies/config/geographies-config.ts +81 -0
  194. package/src/lib/geographies/config/geographies-options.ts +37 -0
  195. package/src/lib/geographies/config/layers/attribute-data-layer/attribute-data-layer-builder.ts +212 -0
  196. package/{lib/geographies/config/layers/attribute-data-layer/attribute-data-layer-options.d.ts → src/lib/geographies/config/layers/attribute-data-layer/attribute-data-layer-options.ts} +26 -16
  197. package/src/lib/geographies/config/layers/attribute-data-layer/attribute-data-layer.spec.ts +119 -0
  198. package/src/lib/geographies/config/layers/attribute-data-layer/attribute-data-layer.ts +148 -0
  199. package/src/lib/geographies/config/layers/attribute-data-layer/dimensions/attribute-data/attribute-data-dimension-builder.ts +65 -0
  200. package/src/lib/geographies/config/layers/attribute-data-layer/dimensions/attribute-data/attribute-data-dimension-options.ts +15 -0
  201. package/src/lib/geographies/config/layers/attribute-data-layer/dimensions/attribute-data/attribute-data-dimension.ts +32 -0
  202. package/src/lib/geographies/config/layers/attribute-data-layer/dimensions/attribute-data-bin-enums.ts +10 -0
  203. package/{lib/geographies/config/layers/attribute-data-layer/dimensions/attribute-data-bin-types.d.ts → src/lib/geographies/config/layers/attribute-data-layer/dimensions/attribute-data-bin-types.ts} +15 -8
  204. package/src/lib/geographies/config/layers/attribute-data-layer/dimensions/calculated-bins/calculated-bins-builder.ts +18 -0
  205. package/src/lib/geographies/config/layers/attribute-data-layer/dimensions/calculated-bins/calculated-bins-options.ts +8 -0
  206. package/src/lib/geographies/config/layers/attribute-data-layer/dimensions/calculated-bins/calculated-bins.spec.ts +60 -0
  207. package/src/lib/geographies/config/layers/attribute-data-layer/dimensions/calculated-bins/calculated-bins.ts +34 -0
  208. package/src/lib/geographies/config/layers/attribute-data-layer/dimensions/categorical-bins/categorical-bins-builder.ts +46 -0
  209. package/src/lib/geographies/config/layers/attribute-data-layer/dimensions/categorical-bins/categorical-bins-options.ts +8 -0
  210. package/src/lib/geographies/config/layers/attribute-data-layer/dimensions/categorical-bins/categorical-bins.cy.ts +437 -0
  211. package/src/lib/geographies/config/layers/attribute-data-layer/dimensions/categorical-bins/categorical-bins.spec.ts +105 -0
  212. package/src/lib/geographies/config/layers/attribute-data-layer/dimensions/categorical-bins/categorical-bins.ts +54 -0
  213. package/src/lib/geographies/config/layers/attribute-data-layer/dimensions/custom-breaks/custom-breaks-bins-builder.ts +65 -0
  214. package/src/lib/geographies/config/layers/attribute-data-layer/dimensions/custom-breaks/custom-breaks-bins-options.ts +9 -0
  215. package/src/lib/geographies/config/layers/attribute-data-layer/dimensions/custom-breaks/custom-breaks-bins.spec.ts +82 -0
  216. package/src/lib/geographies/config/layers/attribute-data-layer/dimensions/custom-breaks/custom-breaks-bins.ts +81 -0
  217. package/src/lib/geographies/config/layers/attribute-data-layer/dimensions/custom-breaks/custom-breaks.cy.ts +378 -0
  218. package/src/lib/geographies/config/layers/attribute-data-layer/dimensions/equal-frequencies-bins/equal-frequencies-bins-builder.ts +50 -0
  219. package/src/lib/geographies/config/layers/attribute-data-layer/dimensions/equal-frequencies-bins/equal-frequencies-bins-options.ts +8 -0
  220. package/src/lib/geographies/config/layers/attribute-data-layer/dimensions/equal-frequencies-bins/equal-frequencies-bins.cy.ts +362 -0
  221. package/src/lib/geographies/config/layers/attribute-data-layer/dimensions/equal-frequencies-bins/equal-frequencies-bins.spec.ts +72 -0
  222. package/src/lib/geographies/config/layers/attribute-data-layer/dimensions/equal-frequencies-bins/equal-frequencies-bins.ts +56 -0
  223. package/src/lib/geographies/config/layers/attribute-data-layer/dimensions/equal-value-ranges-bins/equal-value-ranges-bins-builder.ts +60 -0
  224. package/src/lib/geographies/config/layers/attribute-data-layer/dimensions/equal-value-ranges-bins/equal-value-ranges-bins-options.ts +9 -0
  225. package/src/lib/geographies/config/layers/attribute-data-layer/dimensions/equal-value-ranges-bins/equal-value-ranges-bins.cy.ts +307 -0
  226. package/src/lib/geographies/config/layers/attribute-data-layer/dimensions/equal-value-ranges-bins/equal-value-ranges-bins.spec.ts +104 -0
  227. package/src/lib/geographies/config/layers/attribute-data-layer/dimensions/equal-value-ranges-bins/equal-value-ranges-bins.ts +89 -0
  228. package/src/lib/geographies/config/layers/attribute-data-layer/dimensions/no-bins/no-bins-builder.ts +62 -0
  229. package/src/lib/geographies/config/layers/attribute-data-layer/dimensions/no-bins/no-bins-options.ts +8 -0
  230. package/src/lib/geographies/config/layers/attribute-data-layer/dimensions/no-bins/no-bins.cy.ts +265 -0
  231. package/src/lib/geographies/config/layers/attribute-data-layer/dimensions/no-bins/no-bins.spec.ts +42 -0
  232. package/src/lib/geographies/config/layers/attribute-data-layer/dimensions/no-bins/no-bins.ts +42 -0
  233. package/src/lib/geographies/config/layers/geographies-layer/geographies-layer-builder.ts +116 -0
  234. package/{lib/geographies/config/layers/geographies-layer/geographies-layer-options.d.ts → src/lib/geographies/config/layers/geographies-layer/geographies-layer-options.ts} +20 -16
  235. package/src/lib/geographies/config/layers/geographies-layer/geographies-layer.ts +104 -0
  236. package/src/lib/geographies/config/layers/geojson-properties-layer/geojson-properties-layer-builder.ts +111 -0
  237. package/src/lib/geographies/config/layers/geojson-properties-layer/geojson-properties-layer-options.ts +19 -0
  238. package/src/lib/geographies/config/layers/geojson-properties-layer/geojson-properties-layer.spec.ts +41 -0
  239. package/src/lib/geographies/config/layers/geojson-properties-layer/geojson-properties-layer.ts +67 -0
  240. package/src/lib/geographies/config/layers/labels/geographies-labels-builder.ts +269 -0
  241. package/src/lib/geographies/config/layers/labels/geographies-labels-options.ts +45 -0
  242. package/src/lib/geographies/config/layers/labels/geographies-labels.ts +38 -0
  243. package/src/lib/geographies/events/actions/geographies-click-actions.ts +21 -0
  244. package/src/lib/geographies/events/actions/geographies-hover-actions.ts +17 -0
  245. package/src/lib/geographies/events/actions/geographies-hover-move-actions.ts +19 -0
  246. package/src/lib/geographies/events/geographies-events.directive.spec.ts +225 -0
  247. package/src/lib/geographies/events/geographies-events.directive.ts +235 -0
  248. package/src/lib/geographies/events/geographies-interaction-output.ts +17 -0
  249. package/src/lib/geographies/events/geographies-tooltip-positioner.ts +23 -0
  250. package/src/lib/geographies/geographies-feature.ts +16 -0
  251. package/src/lib/geographies/geographies.component.html +1 -0
  252. package/src/lib/geographies/geographies.component.scss +0 -0
  253. package/src/lib/geographies/geographies.component.spec.ts +148 -0
  254. package/src/lib/geographies/geographies.component.ts +318 -0
  255. package/src/lib/geographies/geographies.cy.ts +640 -0
  256. package/src/lib/geographies/geographies.module.ts +9 -0
  257. package/{lib/geographies/index.d.ts → src/lib/geographies/index.ts} +32 -32
  258. package/src/lib/grouped-bars/config/grouped-bars-builder.ts +66 -0
  259. package/src/lib/grouped-bars/config/grouped-bars-config.ts +41 -0
  260. package/src/lib/grouped-bars/config/grouped-bars-options.ts +9 -0
  261. package/src/lib/grouped-bars/events/grouped-bars-events.directive.ts +221 -0
  262. package/src/lib/grouped-bars/grouped-bars.component.scss +0 -0
  263. package/src/lib/grouped-bars/grouped-bars.component.spec.ts +25 -0
  264. package/src/lib/grouped-bars/grouped-bars.component.ts +94 -0
  265. package/src/lib/grouped-bars/grouped-bars.module.ts +9 -0
  266. package/{lib/grouped-bars/index.d.ts → src/lib/grouped-bars/index.ts} +10 -7
  267. package/src/lib/image-download/image-download-config.ts +57 -0
  268. package/src/lib/image-download/image-download-enums.ts +7 -0
  269. package/src/lib/image-download/image-download-options.ts +14 -0
  270. package/src/lib/image-download/image-download.service.ts +70 -0
  271. package/{lib/image-download/index.d.ts → src/lib/image-download/index.ts} +4 -4
  272. package/src/lib/lines/config/area-fills/area-fills-builder.ts +87 -0
  273. package/src/lib/lines/config/area-fills/area-fills-options.ts +8 -0
  274. package/src/lib/lines/config/area-fills/area-fills.ts +14 -0
  275. package/src/lib/lines/config/lines-builder.ts +242 -0
  276. package/src/lib/lines/config/lines-config.spec.ts +52 -0
  277. package/src/lib/lines/config/lines-config.ts +96 -0
  278. package/{lib/lines/config/lines-options.d.ts → src/lib/lines/config/lines-options.ts} +19 -18
  279. package/src/lib/lines/config/stroke/lines-stroke-builder.ts +135 -0
  280. package/{lib/lines/config/stroke/lines-stroke-options.d.ts → src/lib/lines/config/stroke/lines-stroke-options.ts} +6 -5
  281. package/src/lib/lines/config/stroke/lines-stroke.ts +15 -0
  282. package/src/lib/lines/events/actions/lines-click-actions.ts +17 -0
  283. package/src/lib/lines/events/actions/lines-hover-move-actions.ts +113 -0
  284. package/src/lib/lines/events/actions/lines-marker-click-actions.ts +29 -0
  285. package/src/lib/lines/events/lines-events.directive.spec.ts +152 -0
  286. package/src/lib/lines/events/lines-events.directive.ts +310 -0
  287. package/src/lib/lines/events/lines-interaction-output.ts +17 -0
  288. package/src/lib/lines/events/lines-tooltip-positioner.ts +24 -0
  289. package/{lib/lines/index.d.ts → src/lib/lines/index.ts} +17 -11
  290. package/src/lib/lines/lines.component.scss +0 -0
  291. package/src/lib/lines/lines.component.spec.ts +95 -0
  292. package/src/lib/lines/lines.component.ts +425 -0
  293. package/src/lib/lines/lines.cy.ts +738 -0
  294. package/src/lib/lines/lines.module.ts +9 -0
  295. package/src/lib/map-legend/continuous-legend/continuous-legend.component.html +28 -0
  296. package/src/lib/map-legend/continuous-legend/continuous-legend.component.scss +76 -0
  297. package/src/lib/map-legend/continuous-legend/continuous-legend.component.spec.ts +61 -0
  298. package/src/lib/map-legend/continuous-legend/continuous-legend.component.ts +82 -0
  299. package/src/lib/map-legend/discontinuous-legend/discontinuous-legend.component.html +40 -0
  300. package/src/lib/map-legend/discontinuous-legend/discontinuous-legend.component.scss +141 -0
  301. package/src/lib/map-legend/discontinuous-legend/discontinuous-legend.component.spec.ts +75 -0
  302. package/src/lib/map-legend/discontinuous-legend/discontinuous-legend.component.ts +57 -0
  303. package/{lib/map-legend/index.d.ts → src/lib/map-legend/index.ts} +2 -2
  304. package/src/lib/map-legend/map-legend-base.spec.ts +190 -0
  305. package/src/lib/map-legend/map-legend-base.ts +99 -0
  306. package/src/lib/map-legend/map-legend.component.html +24 -0
  307. package/src/lib/map-legend/map-legend.component.scss +0 -0
  308. package/src/lib/map-legend/map-legend.component.spec.ts +125 -0
  309. package/src/lib/map-legend/map-legend.component.ts +80 -0
  310. package/src/lib/map-legend/map-legend.module.ts +8 -0
  311. package/src/lib/marks/aux-marks/aux-marks.ts +18 -0
  312. package/src/lib/marks/aux-marks/config/aux-marks-builder.ts +25 -0
  313. package/{lib/marks/aux-marks/config/aux-marks-config.d.ts → src/lib/marks/aux-marks/config/aux-marks-config.ts} +6 -4
  314. package/src/lib/marks/config/marks-config.ts +14 -0
  315. package/src/lib/marks/config/marks-options.ts +9 -0
  316. package/{lib/marks/index.d.ts → src/lib/marks/index.ts} +15 -15
  317. package/src/lib/marks/map-marks/map-aux-marks/map-aux-marks.spec.ts +74 -0
  318. package/src/lib/marks/map-marks/map-aux-marks/map-aux-marks.ts +40 -0
  319. package/src/lib/marks/map-marks/map-primary-marks/map-primary-marks.spec.ts +79 -0
  320. package/src/lib/marks/map-marks/map-primary-marks/map-primary-marks.ts +63 -0
  321. package/src/lib/marks/marks.ts +39 -0
  322. package/src/lib/marks/primary-marks/config/primary-marks-builder.ts +75 -0
  323. package/src/lib/marks/primary-marks/config/primary-marks-config.ts +9 -0
  324. package/src/lib/marks/primary-marks/primary-marks-base.spec.ts +58 -0
  325. package/src/lib/marks/primary-marks/primary-marks.ts +43 -0
  326. package/src/lib/marks/xy-marks/xy-aux-marks/xy-aux-marks.ts +40 -0
  327. package/src/lib/marks/xy-marks/xy-marks-config.ts +5 -0
  328. package/src/lib/marks/xy-marks/xy-marks.ts +10 -0
  329. package/src/lib/marks/xy-marks/xy-primary-marks/xy-primary-marks-config.ts +7 -0
  330. package/src/lib/marks/xy-marks/xy-primary-marks/xy-primary-marks.spec.ts +186 -0
  331. package/src/lib/marks/xy-marks/xy-primary-marks/xy-primary-marks.ts +72 -0
  332. package/{lib/point-markers/index.d.ts → src/lib/point-markers/index.ts} +3 -2
  333. package/src/lib/point-markers/point-markers-builder.ts +93 -0
  334. package/src/lib/point-markers/point-markers-options.ts +6 -0
  335. package/src/lib/point-markers/point-markers.ts +13 -0
  336. package/src/lib/quantitative-rules/config/labels/quantitative-rules-labels-builder.ts +162 -0
  337. package/src/lib/quantitative-rules/config/labels/quantitative-rules-labels-options.ts +17 -0
  338. package/src/lib/quantitative-rules/config/labels/quantitative-rules-labels.ts +26 -0
  339. package/src/lib/quantitative-rules/config/quantitative-rules-builder.ts +134 -0
  340. package/src/lib/quantitative-rules/config/quantitative-rules-config.ts +21 -0
  341. package/src/lib/quantitative-rules/config/quantitative-rules-dimensions.ts +20 -0
  342. package/{lib/quantitative-rules/config/quantitative-rules-options.d.ts → src/lib/quantitative-rules/config/quantitative-rules-options.ts} +13 -10
  343. package/{lib/quantitative-rules/index.d.ts → src/lib/quantitative-rules/index.ts} +6 -6
  344. package/src/lib/quantitative-rules/quantitative-rules.component.scss +3 -0
  345. package/src/lib/quantitative-rules/quantitative-rules.component.spec.ts +50 -0
  346. package/src/lib/quantitative-rules/quantitative-rules.component.ts +224 -0
  347. package/src/lib/quantitative-rules/quantitative-rules.cy.ts +549 -0
  348. package/src/lib/quantitative-rules/quantitative-rules.module.ts +8 -0
  349. package/src/lib/stacked-area/config/stacked-area-builder.ts +264 -0
  350. package/src/lib/stacked-area/config/stacked-area-config.spec.ts +107 -0
  351. package/src/lib/stacked-area/config/stacked-area-config.ts +109 -0
  352. package/src/lib/stacked-area/config/stacked-area-options.ts +28 -0
  353. package/src/lib/stacked-area/events/actions/stacked-area-hover-move-actions.ts +17 -0
  354. package/src/lib/stacked-area/events/stacked-area-events.directive.spec.ts +168 -0
  355. package/src/lib/stacked-area/events/stacked-area-events.directive.ts +272 -0
  356. package/src/lib/stacked-area/events/stacked-area-interaction-output.ts +33 -0
  357. package/src/lib/stacked-area/events/stacked-area-tooltip-positioner.ts +37 -0
  358. package/{lib/stacked-area/index.d.ts → src/lib/stacked-area/index.ts} +7 -7
  359. package/src/lib/stacked-area/stacked-area.component.scss +0 -0
  360. package/src/lib/stacked-area/stacked-area.component.spec.ts +41 -0
  361. package/src/lib/stacked-area/stacked-area.component.ts +241 -0
  362. package/src/lib/stacked-area/stacked-area.module.ts +9 -0
  363. package/src/lib/stacked-bars/config/stacked-bars-builder.ts +109 -0
  364. package/src/lib/stacked-bars/config/stacked-bars-config.spec.ts +122 -0
  365. package/src/lib/stacked-bars/config/stacked-bars-config.ts +79 -0
  366. package/src/lib/stacked-bars/config/stacked-bars-options.ts +16 -0
  367. package/src/lib/stacked-bars/events/actions/stacked-bars-click-actions.ts +23 -0
  368. package/src/lib/stacked-bars/events/actions/stacked-bars-hover-actions.ts +22 -0
  369. package/src/lib/stacked-bars/events/actions/stacked-bars-hover-move-actions.ts +21 -0
  370. package/src/lib/stacked-bars/events/stacked-bars-events.directive.spec.ts +266 -0
  371. package/src/lib/stacked-bars/events/stacked-bars-events.directive.ts +240 -0
  372. package/{lib/stacked-bars/index.d.ts → src/lib/stacked-bars/index.ts} +10 -10
  373. package/src/lib/stacked-bars/stacked-bars.component.scss +0 -0
  374. package/src/lib/stacked-bars/stacked-bars.component.spec.ts +25 -0
  375. package/src/lib/stacked-bars/stacked-bars.component.ts +158 -0
  376. package/src/lib/stacked-bars/stacked-bars.module.ts +9 -0
  377. package/src/lib/stroke/base/stroke-base-options.ts +7 -0
  378. package/src/lib/stroke/base/stroke-base.ts +9 -0
  379. package/src/lib/stroke/index.ts +5 -0
  380. package/src/lib/stroke/stroke-builder.ts +103 -0
  381. package/{lib/stroke/stroke-options.d.ts → src/lib/stroke/stroke-options.ts} +5 -4
  382. package/src/lib/stroke/stroke.ts +12 -0
  383. package/{lib/svg-text-wrap/index.d.ts → src/lib/svg-text-wrap/index.ts} +3 -2
  384. package/src/lib/svg-text-wrap/svg-text-wrap-builder.ts +105 -0
  385. package/src/lib/svg-text-wrap/svg-text-wrap-options.ts +8 -0
  386. package/src/lib/svg-text-wrap/svg-text-wrap.ts +137 -0
  387. package/src/lib/testing/data/continent-population-year-data.ts +126 -0
  388. package/src/lib/testing/data/country-area-continent.ts +59 -0
  389. package/src/lib/testing/data/state-population-income-year-data.ts +123 -0
  390. package/src/lib/testing/stubs/bars.component.stub.ts +12 -0
  391. package/src/lib/testing/stubs/chart.component.stub.ts +6 -0
  392. package/src/lib/testing/stubs/click.directive.stub.ts +15 -0
  393. package/src/lib/testing/stubs/core/destroy-ref.stub.ts +9 -0
  394. package/src/lib/testing/stubs/core/overlay-ref.stub.ts +13 -0
  395. package/src/lib/testing/stubs/core/overlay.stub.ts +8 -0
  396. package/src/lib/testing/stubs/event.directive.stub.ts +10 -0
  397. package/src/lib/testing/stubs/hover-move.directive.stub.ts +17 -0
  398. package/src/lib/testing/stubs/hover.directive.stub.ts +14 -0
  399. package/src/lib/testing/stubs/input-event.directive.stub.ts +9 -0
  400. package/src/lib/testing/stubs/lines.component.stub.ts +13 -0
  401. package/src/lib/testing/stubs/map-aux-marks.stub.ts +10 -0
  402. package/src/lib/testing/stubs/map-chart.component.stub.ts +3 -0
  403. package/src/lib/testing/stubs/map-legend-content.stub.ts +16 -0
  404. package/src/lib/testing/stubs/map-legend.component.stub.ts +10 -0
  405. package/src/lib/testing/stubs/map-primary-marks.stub.ts +16 -0
  406. package/src/lib/testing/stubs/ordinal-axis.stub.ts +18 -0
  407. package/src/lib/testing/stubs/primary-marks.stub.ts +18 -0
  408. package/src/lib/testing/stubs/quantitative-axis.stub.ts +18 -0
  409. package/src/lib/testing/stubs/services/main.service.stub.ts +5 -0
  410. package/src/lib/testing/stubs/services/utilities.service.stub.ts +7 -0
  411. package/src/lib/testing/stubs/stacked-area.component.stub.ts +13 -0
  412. package/src/lib/testing/stubs/x-axis.stub.ts +10 -0
  413. package/src/lib/testing/stubs/xy-axis.class.stub.ts +20 -0
  414. package/src/lib/testing/stubs/xy-axis.stub.ts +44 -0
  415. package/src/lib/testing/stubs/xy-chart.component.stub.ts +5 -0
  416. package/src/lib/testing/stubs/xy-data-marks.stub.ts +15 -0
  417. package/src/lib/testing/stubs/y-axis.stub.ts +15 -0
  418. package/src/lib/tooltips/config/tooltip.ts +11 -0
  419. package/src/lib/tooltips/html-tooltip/config/html-tooltip-builder.ts +134 -0
  420. package/src/lib/tooltips/html-tooltip/config/html-tooltip-config.ts +21 -0
  421. package/{lib/tooltips/html-tooltip/config/html-tooltip-options.d.ts → src/lib/tooltips/html-tooltip/config/html-tooltip-options.ts} +12 -11
  422. package/src/lib/tooltips/html-tooltip/config/position/tooltip-position-builder.ts +191 -0
  423. package/src/lib/tooltips/html-tooltip/config/position/tooltip-position.ts +42 -0
  424. package/src/lib/tooltips/html-tooltip/config/size/tooltip-size-builder.ts +75 -0
  425. package/src/lib/tooltips/html-tooltip/config/size/tooltip-size-options.ts +8 -0
  426. package/src/lib/tooltips/html-tooltip/config/size/tooltip-size.ts +15 -0
  427. package/src/lib/tooltips/html-tooltip/html-tooltip.directive.spec.ts +537 -0
  428. package/src/lib/tooltips/html-tooltip/html-tooltip.directive.ts +210 -0
  429. package/src/lib/tooltips/html-tooltip/html-tooltip.module.ts +16 -0
  430. package/src/lib/tooltips/html-tooltip/tooltip-triangle/tooltip-triangle.component.html +41 -0
  431. package/src/lib/tooltips/html-tooltip/tooltip-triangle/tooltip-triangle.component.scss +63 -0
  432. package/src/lib/tooltips/html-tooltip/tooltip-triangle/tooltip-triangle.component.ts +19 -0
  433. package/{lib/tooltips/index.d.ts → src/lib/tooltips/index.ts} +11 -11
  434. package/src/lib/tooltips/svg-tooltip/config/svg-tooltip.ts +5 -0
  435. package/{lib/xy-background/index.d.ts → src/lib/xy-background/index.ts} +2 -2
  436. package/src/lib/xy-background/xy-background.component.html +10 -0
  437. package/src/lib/xy-background/xy-background.component.scss +0 -0
  438. package/src/lib/xy-background/xy-background.component.spec.ts +24 -0
  439. package/src/lib/xy-background/xy-background.component.ts +19 -0
  440. package/src/lib/xy-background/xy-background.module.ts +8 -0
  441. package/{public-api.d.ts → src/public-api.ts} +26 -23
  442. package/src/test.ts +15 -0
  443. package/tsconfig.doc.json +4 -0
  444. package/tsconfig.json +20 -0
  445. package/tsconfig.lib.json +23 -0
  446. package/tsconfig.lib.prod.json +10 -0
  447. package/tsconfig.spec.json +10 -0
  448. package/fesm2022/mathstack-viz.mjs +0 -11058
  449. package/fesm2022/mathstack-viz.mjs.map +0 -1
  450. package/index.d.ts +0 -5
  451. package/lib/axes/base/config/xy-axis-builder.d.ts +0 -38
  452. package/lib/axes/base/config/xy-axis-config.d.ts +0 -18
  453. package/lib/axes/base/xy-axis-base.d.ts +0 -49
  454. package/lib/axes/baseline/axis-baseline-builder.d.ts +0 -31
  455. package/lib/axes/baseline/axis-baseline-options.d.ts +0 -7
  456. package/lib/axes/baseline/axis-baseline.d.ts +0 -9
  457. package/lib/axes/grid/grid-builder.d.ts +0 -29
  458. package/lib/axes/grid/grid-config.d.ts +0 -8
  459. package/lib/axes/grid/grid-options.d.ts +0 -6
  460. package/lib/axes/index.d.ts +0 -13
  461. package/lib/axes/label/axis-label-builder.d.ts +0 -63
  462. package/lib/axes/label/axis-label-options.d.ts +0 -11
  463. package/lib/axes/label/axis-label.d.ts +0 -13
  464. package/lib/axes/ordinal/ordinal-axis-config.d.ts +0 -38
  465. package/lib/axes/ordinal/ordinal-axis.d.ts +0 -43
  466. package/lib/axes/quantitative/quantitative-axis-config.d.ts +0 -38
  467. package/lib/axes/quantitative/quantitative-axis.d.ts +0 -51
  468. package/lib/axes/ticks/tick-wrap/tick-wrap-builder.d.ts +0 -64
  469. package/lib/axes/ticks/tick-wrap/tick-wrap-options.d.ts +0 -8
  470. package/lib/axes/ticks/tick-wrap/tick-wrap.d.ts +0 -13
  471. package/lib/axes/ticks/ticks-builder.d.ts +0 -172
  472. package/lib/axes/ticks/ticks-options.d.ts +0 -22
  473. package/lib/axes/ticks/ticks.d.ts +0 -24
  474. package/lib/axes/x/x-axis-config.d.ts +0 -42
  475. package/lib/axes/x/x-axis.d.ts +0 -47
  476. package/lib/axes/x-ordinal/x-ordinal-axis-builder.d.ts +0 -29
  477. package/lib/axes/x-ordinal/x-ordinal-axis-config.d.ts +0 -25
  478. package/lib/axes/x-ordinal/x-ordinal-axis.component.d.ts +0 -88
  479. package/lib/axes/x-quantitative/x-quantitative-axis-builder.d.ts +0 -29
  480. package/lib/axes/x-quantitative/x-quantitative-axis-config.d.ts +0 -25
  481. package/lib/axes/x-quantitative/x-quantitative-axis.component.d.ts +0 -53
  482. package/lib/axes/xy-axis.module.d.ts +0 -10
  483. package/lib/axes/y/y-axis-config.d.ts +0 -42
  484. package/lib/axes/y/y-axis.d.ts +0 -53
  485. package/lib/axes/y-ordinal/y-ordinal-axis-builder.d.ts +0 -29
  486. package/lib/axes/y-ordinal/y-ordinal-axis-config.d.ts +0 -25
  487. package/lib/axes/y-ordinal/y-ordinal-axis.component.d.ts +0 -89
  488. package/lib/axes/y-quantitative-axis/y-quantitative-axis-builder.d.ts +0 -29
  489. package/lib/axes/y-quantitative-axis/y-quantitative-axis-config.d.ts +0 -25
  490. package/lib/axes/y-quantitative-axis/y-quantitative-axis.component.d.ts +0 -54
  491. package/lib/bars/bars.component.d.ts +0 -91
  492. package/lib/bars/bars.module.d.ts +0 -8
  493. package/lib/bars/config/backgrounds/bars-backgrounds-builder.d.ts +0 -27
  494. package/lib/bars/config/backgrounds/bars-backgrounds.d.ts +0 -6
  495. package/lib/bars/config/bars-builder.d.ts +0 -132
  496. package/lib/bars/config/bars-config.d.ts +0 -27
  497. package/lib/bars/config/bars-dimensions.d.ts +0 -11
  498. package/lib/bars/config/labels/bars-labels-builder.d.ts +0 -48
  499. package/lib/bars/config/labels/bars-labels-options.d.ts +0 -9
  500. package/lib/bars/config/labels/bars-labels.d.ts +0 -11
  501. package/lib/bars/events/actions/bars-click-actions.d.ts +0 -8
  502. package/lib/bars/events/actions/bars-hover-actions.d.ts +0 -12
  503. package/lib/bars/events/actions/bars-hover-move-actions.d.ts +0 -8
  504. package/lib/bars/events/bars-events.directive.d.ts +0 -38
  505. package/lib/bars/events/bars-interaction-output.d.ts +0 -16
  506. package/lib/bars/events/bars-tooltip-positioner.d.ts +0 -13
  507. package/lib/charts/chart/chart.component.d.ts +0 -73
  508. package/lib/charts/chart/chart.d.ts +0 -4
  509. package/lib/charts/chart/config/chart-builder.d.ts +0 -94
  510. package/lib/charts/chart/config/chart-config.d.ts +0 -16
  511. package/lib/charts/chart/config/chart-options.d.ts +0 -10
  512. package/lib/charts/chart.module.d.ts +0 -9
  513. package/lib/charts/map-chart/map-chart.component.d.ts +0 -40
  514. package/lib/charts/xy-chart/xy-chart.component.d.ts +0 -40
  515. package/lib/core/common-behaviors/constructor.d.ts +0 -2
  516. package/lib/core/index.d.ts +0 -5
  517. package/lib/core/types/layout.d.ts +0 -24
  518. package/lib/core/types/scale.d.ts +0 -5
  519. package/lib/core/utilities/colors.d.ts +0 -13
  520. package/lib/core/utilities/fill-utilities.d.ts +0 -7
  521. package/lib/core/utilities/type-guards.d.ts +0 -6
  522. package/lib/core/utilities/value-format.d.ts +0 -11
  523. package/lib/core/utilities/values.d.ts +0 -16
  524. package/lib/data-dimensions/continuous-quantitative/date-chart-position/date-chart-position-builder.d.ts +0 -39
  525. package/lib/data-dimensions/continuous-quantitative/date-chart-position/date-chart-position-options.d.ts +0 -18
  526. package/lib/data-dimensions/continuous-quantitative/date-chart-position/date-chart-position.d.ts +0 -38
  527. package/lib/data-dimensions/continuous-quantitative/number-chart-position/domain-padding/domain-padding.d.ts +0 -20
  528. package/lib/data-dimensions/continuous-quantitative/number-chart-position/domain-padding/percent-over/percent-over.d.ts +0 -9
  529. package/lib/data-dimensions/continuous-quantitative/number-chart-position/domain-padding/pixel/pixel.d.ts +0 -10
  530. package/lib/data-dimensions/continuous-quantitative/number-chart-position/domain-padding/round-to-interval/round-to-interval.d.ts +0 -8
  531. package/lib/data-dimensions/continuous-quantitative/number-chart-position/domain-padding/round-to-sig-fig/round-to-sig-fig.d.ts +0 -8
  532. package/lib/data-dimensions/continuous-quantitative/number-chart-position/number-chart-position-builder.d.ts +0 -71
  533. package/lib/data-dimensions/continuous-quantitative/number-dimension/number-dimension-options.d.ts +0 -8
  534. package/lib/data-dimensions/continuous-quantitative/number-dimension/number-dimension.d.ts +0 -28
  535. package/lib/data-dimensions/continuous-quantitative/number-visual-value/number-visual-value-builder.d.ts +0 -69
  536. package/lib/data-dimensions/continuous-quantitative/number-visual-value/number-visual-value-options.d.ts +0 -6
  537. package/lib/data-dimensions/dimension-builder.d.ts +0 -21
  538. package/lib/data-dimensions/dimension-options.d.ts +0 -11
  539. package/lib/data-dimensions/dimension.d.ts +0 -16
  540. package/lib/data-dimensions/index.d.ts +0 -9
  541. package/lib/data-dimensions/ordinal/ordinal-chart-position/ordinal-chart-position-builder.d.ts +0 -53
  542. package/lib/data-dimensions/ordinal/ordinal-chart-position/ordinal-chart-position-options.d.ts +0 -8
  543. package/lib/data-dimensions/ordinal/ordinal-chart-position/ordinal-chart-position.d.ts +0 -44
  544. package/lib/data-dimensions/ordinal/ordinal-visual-value/ordinal-visual-value-builder.d.ts +0 -45
  545. package/lib/data-dimensions/ordinal/ordinal-visual-value/ordinal-visual-value-options.d.ts +0 -7
  546. package/lib/data-dimensions/ordinal/ordinal-visual-value/ordinal-visual-value.d.ts +0 -38
  547. package/lib/data-export/data-export-config.d.ts +0 -50
  548. package/lib/data-export/data-export.d.ts +0 -7
  549. package/lib/dots/config/dots-builder.d.ts +0 -110
  550. package/lib/dots/config/dots-config.d.ts +0 -26
  551. package/lib/dots/dots.component.d.ts +0 -55
  552. package/lib/dots/dots.module.d.ts +0 -8
  553. package/lib/dots/events/actions/dots-hover-actions.d.ts +0 -6
  554. package/lib/dots/events/actions/dots-hover-move-actions.d.ts +0 -10
  555. package/lib/dots/events/dots-events.directive.d.ts +0 -37
  556. package/lib/dots/events/dots-interaction-output.d.ts +0 -14
  557. package/lib/dots/events/dots-tooltip-positioner.d.ts +0 -13
  558. package/lib/events/events.directive.d.ts +0 -43
  559. package/lib/events/events.types.d.ts +0 -34
  560. package/lib/events/interaction-output.d.ts +0 -33
  561. package/lib/events/tooltip-positioner.d.ts +0 -6
  562. package/lib/fill-definitions/fill-definitions.d.ts +0 -4
  563. package/lib/geographies/config/geographies-builder.d.ts +0 -80
  564. package/lib/geographies/config/geographies-config.d.ts +0 -19
  565. package/lib/geographies/config/geographies-options.d.ts +0 -13
  566. package/lib/geographies/config/layers/attribute-data-layer/attribute-data-layer-builder.d.ts +0 -63
  567. package/lib/geographies/config/layers/attribute-data-layer/attribute-data-layer.d.ts +0 -30
  568. package/lib/geographies/config/layers/attribute-data-layer/dimensions/attribute-data/attribute-data-dimension-builder.d.ts +0 -40
  569. package/lib/geographies/config/layers/attribute-data-layer/dimensions/attribute-data/attribute-data-dimension-options.d.ts +0 -8
  570. package/lib/geographies/config/layers/attribute-data-layer/dimensions/attribute-data/attribute-data-dimension.d.ts +0 -18
  571. package/lib/geographies/config/layers/attribute-data-layer/dimensions/attribute-data-bin-enums.d.ts +0 -10
  572. package/lib/geographies/config/layers/attribute-data-layer/dimensions/calculated-bins/calculated-bins-builder.d.ts +0 -10
  573. package/lib/geographies/config/layers/attribute-data-layer/dimensions/calculated-bins/calculated-bins-options.d.ts +0 -4
  574. package/lib/geographies/config/layers/attribute-data-layer/dimensions/calculated-bins/calculated-bins.d.ts +0 -8
  575. package/lib/geographies/config/layers/attribute-data-layer/dimensions/categorical-bins/categorical-bins-builder.d.ts +0 -14
  576. package/lib/geographies/config/layers/attribute-data-layer/dimensions/categorical-bins/categorical-bins-options.d.ts +0 -4
  577. package/lib/geographies/config/layers/attribute-data-layer/dimensions/categorical-bins/categorical-bins.d.ts +0 -20
  578. package/lib/geographies/config/layers/attribute-data-layer/dimensions/custom-breaks/custom-breaks-bins-builder.d.ts +0 -29
  579. package/lib/geographies/config/layers/attribute-data-layer/dimensions/custom-breaks/custom-breaks-bins-options.d.ts +0 -5
  580. package/lib/geographies/config/layers/attribute-data-layer/dimensions/custom-breaks/custom-breaks-bins.d.ts +0 -23
  581. package/lib/geographies/config/layers/attribute-data-layer/dimensions/equal-frequencies-bins/equal-frequencies-bins-builder.d.ts +0 -16
  582. package/lib/geographies/config/layers/attribute-data-layer/dimensions/equal-frequencies-bins/equal-frequencies-bins-options.d.ts +0 -4
  583. package/lib/geographies/config/layers/attribute-data-layer/dimensions/equal-frequencies-bins/equal-frequencies-bins.d.ts +0 -18
  584. package/lib/geographies/config/layers/attribute-data-layer/dimensions/equal-value-ranges-bins/equal-value-ranges-bins-builder.d.ts +0 -21
  585. package/lib/geographies/config/layers/attribute-data-layer/dimensions/equal-value-ranges-bins/equal-value-ranges-bins-options.d.ts +0 -5
  586. package/lib/geographies/config/layers/attribute-data-layer/dimensions/equal-value-ranges-bins/equal-value-ranges-bins.d.ts +0 -24
  587. package/lib/geographies/config/layers/attribute-data-layer/dimensions/no-bins/no-bins-builder.d.ts +0 -26
  588. package/lib/geographies/config/layers/attribute-data-layer/dimensions/no-bins/no-bins-options.d.ts +0 -5
  589. package/lib/geographies/config/layers/attribute-data-layer/dimensions/no-bins/no-bins.d.ts +0 -12
  590. package/lib/geographies/config/layers/geographies-layer/geographies-layer-builder.d.ts +0 -52
  591. package/lib/geographies/config/layers/geographies-layer/geographies-layer.d.ts +0 -29
  592. package/lib/geographies/config/layers/geojson-properties-layer/geojson-properties-layer-builder.d.ts +0 -25
  593. package/lib/geographies/config/layers/geojson-properties-layer/geojson-properties-layer-options.d.ts +0 -11
  594. package/lib/geographies/config/layers/geojson-properties-layer/geojson-properties-layer.d.ts +0 -16
  595. package/lib/geographies/config/layers/labels/geographies-labels-builder.d.ts +0 -97
  596. package/lib/geographies/config/layers/labels/geographies-labels-options.d.ts +0 -33
  597. package/lib/geographies/config/layers/labels/geographies-labels.d.ts +0 -20
  598. package/lib/geographies/events/actions/geographies-click-actions.d.ts +0 -7
  599. package/lib/geographies/events/actions/geographies-hover-actions.d.ts +0 -7
  600. package/lib/geographies/events/actions/geographies-hover-move-actions.d.ts +0 -7
  601. package/lib/geographies/events/geographies-events.directive.d.ts +0 -38
  602. package/lib/geographies/events/geographies-interaction-output.d.ts +0 -16
  603. package/lib/geographies/events/geographies-tooltip-positioner.d.ts +0 -13
  604. package/lib/geographies/geographies-feature.d.ts +0 -5
  605. package/lib/geographies/geographies.component.d.ts +0 -36
  606. package/lib/geographies/geographies.module.d.ts +0 -8
  607. package/lib/grouped-bars/config/grouped-bars-builder.d.ts +0 -29
  608. package/lib/grouped-bars/config/grouped-bars-config.d.ts +0 -10
  609. package/lib/grouped-bars/config/grouped-bars-options.d.ts +0 -5
  610. package/lib/grouped-bars/events/grouped-bars-events.directive.d.ts +0 -35
  611. package/lib/grouped-bars/grouped-bars.component.d.ts +0 -19
  612. package/lib/grouped-bars/grouped-bars.module.d.ts +0 -8
  613. package/lib/image-download/image-download-config.d.ts +0 -31
  614. package/lib/image-download/image-download-enums.d.ts +0 -6
  615. package/lib/image-download/image-download-options.d.ts +0 -14
  616. package/lib/image-download/image-download.service.d.ts +0 -16
  617. package/lib/lines/config/area-fills/area-fills-builder.d.ts +0 -45
  618. package/lib/lines/config/area-fills/area-fills-options.d.ts +0 -7
  619. package/lib/lines/config/area-fills/area-fills.d.ts +0 -9
  620. package/lib/lines/config/lines-builder.d.ts +0 -101
  621. package/lib/lines/config/lines-config.d.ts +0 -37
  622. package/lib/lines/config/stroke/lines-stroke-builder.d.ts +0 -59
  623. package/lib/lines/config/stroke/lines-stroke.d.ts +0 -7
  624. package/lib/lines/events/actions/lines-click-actions.d.ts +0 -6
  625. package/lib/lines/events/actions/lines-hover-move-actions.d.ts +0 -41
  626. package/lib/lines/events/actions/lines-marker-click-actions.d.ts +0 -6
  627. package/lib/lines/events/lines-events.directive.d.ts +0 -49
  628. package/lib/lines/events/lines-interaction-output.d.ts +0 -16
  629. package/lib/lines/events/lines-tooltip-positioner.d.ts +0 -13
  630. package/lib/lines/lines.component.d.ts +0 -53
  631. package/lib/lines/lines.module.d.ts +0 -8
  632. package/lib/map-legend/continuous-legend/continuous-legend.component.d.ts +0 -18
  633. package/lib/map-legend/discontinuous-legend/discontinuous-legend.component.d.ts +0 -12
  634. package/lib/map-legend/map-legend-base.d.ts +0 -33
  635. package/lib/map-legend/map-legend.component.d.ts +0 -27
  636. package/lib/map-legend/map-legend.module.d.ts +0 -7
  637. package/lib/marks/aux-marks/aux-marks.d.ts +0 -10
  638. package/lib/marks/aux-marks/config/aux-marks-builder.d.ts +0 -11
  639. package/lib/marks/config/marks-config.d.ts +0 -9
  640. package/lib/marks/config/marks-options.d.ts +0 -8
  641. package/lib/marks/map-marks/map-aux-marks/map-aux-marks.d.ts +0 -17
  642. package/lib/marks/map-marks/map-primary-marks/map-primary-marks.d.ts +0 -20
  643. package/lib/marks/marks.d.ts +0 -31
  644. package/lib/marks/primary-marks/config/primary-marks-builder.d.ts +0 -32
  645. package/lib/marks/primary-marks/config/primary-marks-config.d.ts +0 -5
  646. package/lib/marks/primary-marks/primary-marks.d.ts +0 -23
  647. package/lib/marks/xy-marks/xy-aux-marks/xy-aux-marks.d.ts +0 -16
  648. package/lib/marks/xy-marks/xy-marks-config.d.ts +0 -4
  649. package/lib/marks/xy-marks/xy-marks.d.ts +0 -6
  650. package/lib/marks/xy-marks/xy-primary-marks/xy-primary-marks-config.d.ts +0 -4
  651. package/lib/marks/xy-marks/xy-primary-marks/xy-primary-marks.d.ts +0 -20
  652. package/lib/point-markers/point-markers-builder.d.ts +0 -47
  653. package/lib/point-markers/point-markers-options.d.ts +0 -6
  654. package/lib/point-markers/point-markers.d.ts +0 -8
  655. package/lib/quantitative-rules/config/labels/quantitative-rules-labels-builder.d.ts +0 -60
  656. package/lib/quantitative-rules/config/labels/quantitative-rules-labels-options.d.ts +0 -9
  657. package/lib/quantitative-rules/config/labels/quantitative-rules-labels.d.ts +0 -11
  658. package/lib/quantitative-rules/config/quantitative-rules-builder.d.ts +0 -52
  659. package/lib/quantitative-rules/config/quantitative-rules-config.d.ts +0 -12
  660. package/lib/quantitative-rules/config/quantitative-rules-dimensions.d.ts +0 -8
  661. package/lib/quantitative-rules/quantitative-rules.component.d.ts +0 -27
  662. package/lib/quantitative-rules/quantitative-rules.module.d.ts +0 -7
  663. package/lib/stacked-area/config/stacked-area-builder.d.ts +0 -85
  664. package/lib/stacked-area/config/stacked-area-config.d.ts +0 -36
  665. package/lib/stacked-area/config/stacked-area-options.d.ts +0 -21
  666. package/lib/stacked-area/events/actions/stacked-area-hover-move-actions.d.ts +0 -7
  667. package/lib/stacked-area/events/stacked-area-events.directive.d.ts +0 -38
  668. package/lib/stacked-area/events/stacked-area-interaction-output.d.ts +0 -28
  669. package/lib/stacked-area/events/stacked-area-tooltip-positioner.d.ts +0 -16
  670. package/lib/stacked-area/stacked-area.component.d.ts +0 -51
  671. package/lib/stacked-area/stacked-area.module.d.ts +0 -8
  672. package/lib/stacked-bars/config/stacked-bars-builder.d.ts +0 -26
  673. package/lib/stacked-bars/config/stacked-bars-config.d.ts +0 -16
  674. package/lib/stacked-bars/config/stacked-bars-options.d.ts +0 -7
  675. package/lib/stacked-bars/events/actions/stacked-bars-click-actions.d.ts +0 -8
  676. package/lib/stacked-bars/events/actions/stacked-bars-hover-actions.d.ts +0 -8
  677. package/lib/stacked-bars/events/actions/stacked-bars-hover-move-actions.d.ts +0 -8
  678. package/lib/stacked-bars/events/stacked-bars-events.directive.d.ts +0 -39
  679. package/lib/stacked-bars/stacked-bars.component.d.ts +0 -26
  680. package/lib/stacked-bars/stacked-bars.module.d.ts +0 -8
  681. package/lib/stroke/base/stroke-base-options.d.ts +0 -7
  682. package/lib/stroke/base/stroke-base.d.ts +0 -8
  683. package/lib/stroke/index.d.ts +0 -2
  684. package/lib/stroke/stroke-builder.d.ts +0 -56
  685. package/lib/stroke/stroke.d.ts +0 -6
  686. package/lib/svg-text-wrap/svg-text-wrap-builder.d.ts +0 -58
  687. package/lib/svg-text-wrap/svg-text-wrap-options.d.ts +0 -8
  688. package/lib/svg-text-wrap/svg-text-wrap.d.ts +0 -13
  689. package/lib/tooltips/config/tooltip.d.ts +0 -5
  690. package/lib/tooltips/html-tooltip/config/html-tooltip-builder.d.ts +0 -57
  691. package/lib/tooltips/html-tooltip/config/html-tooltip-config.d.ts +0 -15
  692. package/lib/tooltips/html-tooltip/config/position/tooltip-position-builder.d.ts +0 -34
  693. package/lib/tooltips/html-tooltip/config/position/tooltip-position.d.ts +0 -23
  694. package/lib/tooltips/html-tooltip/config/size/tooltip-size-builder.d.ts +0 -16
  695. package/lib/tooltips/html-tooltip/config/size/tooltip-size-options.d.ts +0 -8
  696. package/lib/tooltips/html-tooltip/config/size/tooltip-size.d.ts +0 -10
  697. package/lib/tooltips/html-tooltip/html-tooltip.directive.d.ts +0 -43
  698. package/lib/tooltips/html-tooltip/html-tooltip.module.d.ts +0 -10
  699. package/lib/tooltips/html-tooltip/tooltip-triangle/tooltip-triangle.component.d.ts +0 -7
  700. package/lib/xy-background/xy-background.component.d.ts +0 -9
  701. package/lib/xy-background/xy-background.module.d.ts +0 -7
@@ -0,0 +1,224 @@
1
+ import { Injectable } from '@angular/core';
2
+ import { safeAssign } from '@mathstack/app-kit';
3
+ import {
4
+ ExtendedFeature,
5
+ ExtendedFeatureCollection,
6
+ ExtendedGeometryCollection,
7
+ geoAlbersUsa,
8
+ GeoGeometryObjects,
9
+ GeoProjection,
10
+ } from 'd3';
11
+ import { GeoJsonProperties, Geometry, MultiPolygon, Polygon } from 'geojson';
12
+ import { GeographiesFeature } from '../geographies-feature';
13
+ import { GeographiesConfig } from './geographies-config';
14
+ import { GeographiesAttributeDataLayerBuilder } from './layers/attribute-data-layer/attribute-data-layer-builder';
15
+ import { GeographiesGeojsonPropertiesLayerBuilder } from './layers/geojson-properties-layer/geojson-properties-layer-builder';
16
+
17
+ const DEFAULT = {
18
+ _class: () => '',
19
+ _projection: geoAlbersUsa(),
20
+ _mixBlendMode: 'normal',
21
+ };
22
+
23
+ /** Builds a configuration object for a GeographiesComponent.
24
+ *
25
+ * Must be added to a providers array in or above the component that consumes it if it is injected via the constructor. (e.g. `providers: [VicGeographiesBuilder]` in the component decorator)
26
+ *
27
+ * The first generic parameter, Datum, is the type of the attribute data that will be used to shade the map areas.
28
+ *
29
+ * The second generic parameter, TProperties, is the type of the properties object that is associated with the GeoJson.
30
+ *
31
+ * The optional third generic parameter, TGeometry, is the type of the geometry object that is associated with the GeoJson. It defaults to MultiPolygon | Polygon if not provided.
32
+ */
33
+ @Injectable()
34
+ export class VicGeographiesConfigBuilder<
35
+ Datum,
36
+ TProperties extends GeoJsonProperties,
37
+ TGeometry extends Geometry = MultiPolygon | Polygon,
38
+ > {
39
+ private _boundary:
40
+ | ExtendedFeature
41
+ | ExtendedFeatureCollection
42
+ | GeoGeometryObjects
43
+ | ExtendedGeometryCollection;
44
+ protected _class: (d: Datum) => string;
45
+ private _featureIndexAccessor: (
46
+ d: GeographiesFeature<TProperties, TGeometry>
47
+ ) => string;
48
+ private _mixBlendMode: string;
49
+ private _projection: GeoProjection;
50
+ private attributeDataBuilder: GeographiesAttributeDataLayerBuilder<
51
+ Datum,
52
+ TProperties,
53
+ TGeometry
54
+ >;
55
+ public geojsonBuilders: GeographiesGeojsonPropertiesLayerBuilder<
56
+ TProperties,
57
+ TGeometry
58
+ >[] = [];
59
+
60
+ constructor() {
61
+ safeAssign(this, DEFAULT);
62
+ }
63
+
64
+ /**
65
+ * REQUIRED. Sets a feature or geometry object or collection that defines the extents of the map to be drawn.
66
+ *
67
+ * Used for scaling the map.
68
+ */
69
+ boundary(
70
+ boundary:
71
+ | ExtendedFeature
72
+ | ExtendedFeatureCollection
73
+ | GeoGeometryObjects
74
+ | ExtendedGeometryCollection
75
+ ): this {
76
+ this._boundary = boundary;
77
+ return this;
78
+ }
79
+
80
+ /**
81
+ * REQUIRED. Sets a function that derives an identifying string from the GeoJson feature.
82
+ */
83
+ featureIndexAccessor(
84
+ accessor: (d: GeographiesFeature<TProperties, TGeometry>) => string
85
+ ): this {
86
+ this._featureIndexAccessor = accessor;
87
+ return this;
88
+ }
89
+
90
+ /**
91
+ * OPTIONAL. Creates a configuration object for a layer that will be drawn and styled using solely the properties on a geojson feature.
92
+ *
93
+ * This might be used for to draw the outline of a country, for example. It could also shade the area of a country based on a property of the geojson feature.
94
+ *
95
+ * If events are enabled, the geojson properties will be used to populate the tooltip.
96
+ *
97
+ * This method can be called multiple times to create multiple layers. If this method is called with null, all layers will be removed. (Though subsequent calls can be made to add new layers.)
98
+ *
99
+ * The order in which layers are created will determine the order in which they are drawn.
100
+ *
101
+ * Multiple layers can be used to draw different parts of the map with different styles.
102
+ */
103
+ geojsonPropertiesLayer(geojson: null): this;
104
+ geojsonPropertiesLayer(
105
+ geojson: (
106
+ geojson: GeographiesGeojsonPropertiesLayerBuilder<TProperties, TGeometry>
107
+ ) => void
108
+ ): this;
109
+ geojsonPropertiesLayer(
110
+ geojson:
111
+ | ((
112
+ geojson: GeographiesGeojsonPropertiesLayerBuilder<
113
+ TProperties,
114
+ TGeometry
115
+ >
116
+ ) => void)
117
+ | null
118
+ ): this {
119
+ if (geojson === null) {
120
+ this.geojsonBuilders = [];
121
+ return this;
122
+ }
123
+ const builder = new GeographiesGeojsonPropertiesLayerBuilder<
124
+ TProperties,
125
+ TGeometry
126
+ >();
127
+ geojson(builder);
128
+ this.geojsonBuilders.push(builder);
129
+ return this;
130
+ }
131
+
132
+ /**
133
+ * OPTIONAL. Creates a configuration object for a layer that will be drawn from geojson and styled using attribute data.
134
+ *
135
+ * This object provides various methods for transforming data values into colors / color bins.
136
+ *
137
+ * This method can be called only once.
138
+ */
139
+ attributeDataLayer(attributeData: null): this;
140
+ attributeDataLayer(
141
+ attributeData: (
142
+ attributeData: GeographiesAttributeDataLayerBuilder<
143
+ Datum,
144
+ TProperties,
145
+ TGeometry
146
+ >
147
+ ) => void
148
+ ): this;
149
+ attributeDataLayer(
150
+ attributeData:
151
+ | ((
152
+ attributeData: GeographiesAttributeDataLayerBuilder<
153
+ Datum,
154
+ TProperties,
155
+ TGeometry
156
+ >
157
+ ) => void)
158
+ | null
159
+ ): this {
160
+ if (attributeData === null) {
161
+ this.attributeDataBuilder = undefined;
162
+ return this;
163
+ }
164
+ this.attributeDataBuilder = new GeographiesAttributeDataLayerBuilder<
165
+ Datum,
166
+ TProperties,
167
+ TGeometry
168
+ >();
169
+ attributeData(this.attributeDataBuilder);
170
+ return this;
171
+ }
172
+
173
+ /**
174
+ * OPTIONAL. Sets the mix-blend-mode of the marks.
175
+ *
176
+ * @default 'normal'
177
+ */
178
+ mixBlendMode(mixBlendMode: string): this {
179
+ this._mixBlendMode = mixBlendMode;
180
+ return this;
181
+ }
182
+
183
+ /**
184
+ * OPTIONAL. Sets a projection function that maps a point in the map's coordinate space to a point in the SVG's coordinate space.
185
+ *
186
+ * @default d3.geoAlbersUsa()
187
+ */
188
+ projection(projection: GeoProjection): this {
189
+ this._projection = projection;
190
+ return this;
191
+ }
192
+
193
+ /**
194
+ * REQUIRED. Builds the GeographiesConfig object.
195
+ */
196
+ getConfig(): GeographiesConfig<Datum, TProperties, TGeometry> {
197
+ this.validateBuilder();
198
+ const config = new GeographiesConfig<Datum, TProperties, TGeometry>({
199
+ marksClass: 'vic-geographies',
200
+ attributeDataLayer: this.attributeDataBuilder?._build(),
201
+ boundary: this._boundary,
202
+ mixBlendMode: this._mixBlendMode,
203
+ featureIndexAccessor: this._featureIndexAccessor,
204
+ geojsonPropertiesLayers: this.geojsonBuilders.length
205
+ ? this.geojsonBuilders.map((builder) => builder._build())
206
+ : undefined,
207
+ projection: this._projection,
208
+ });
209
+ this.geojsonBuilders = [];
210
+ return config;
211
+ }
212
+
213
+ private validateBuilder(): void {
214
+ if (!this._boundary) {
215
+ throw new Error('Boundary is required');
216
+ }
217
+ if (!this._featureIndexAccessor) {
218
+ throw new Error('Feature index accessor is required');
219
+ }
220
+ if (!this.attributeDataBuilder && !this.geojsonBuilders.length) {
221
+ throw new Error('At least one layer is required');
222
+ }
223
+ }
224
+ }
@@ -0,0 +1,100 @@
1
+ /* eslint-disable @typescript-eslint/no-explicit-any */
2
+ import { VicGeographiesConfigBuilder } from './geographies-builder';
3
+ import { GeographiesConfig } from './geographies-config';
4
+ import { GeographiesAttributeDataLayer } from './layers/attribute-data-layer/attribute-data-layer';
5
+ import { GeographiesLayer } from './layers/geographies-layer/geographies-layer';
6
+
7
+ type Datum = { value: number; state: string };
8
+ const data = [
9
+ { value: 1, state: 'AL' },
10
+ { value: 2, state: 'AK' },
11
+ { value: 3, state: 'AZ' },
12
+ { value: 4, state: 'CA' },
13
+ { value: 5, state: 'CO' },
14
+ { value: 6, state: 'CO' },
15
+ ];
16
+ const features = [
17
+ { name: 'Alabama' },
18
+ { name: 'Alaska' },
19
+ { name: 'Arizona' },
20
+ { name: 'California' },
21
+ { name: 'Colorado' },
22
+ ];
23
+ function createConfig(): GeographiesConfig<Datum, { name: string }, any> {
24
+ return new VicGeographiesConfigBuilder<Datum, { name: string }>()
25
+ .boundary('boundary' as any)
26
+ .featureIndexAccessor((d) => d.properties.name)
27
+ .attributeDataLayer((layer) =>
28
+ layer
29
+ .equalValueRangesBins((dimension) =>
30
+ dimension.valueAccessor((d) => d.value).numBins(5)
31
+ )
32
+ .geographyIndexAccessor((d) => d.state)
33
+ .data(data)
34
+ )
35
+ .geojsonPropertiesLayer((layer) =>
36
+ layer
37
+ .geographies(features as any)
38
+ .fill((dimension) => dimension.range(['lime']))
39
+ )
40
+ .getConfig();
41
+ }
42
+
43
+ describe('GeographiesConfig', () => {
44
+ let config: GeographiesConfig<Datum, { name: string }, any>;
45
+
46
+ beforeEach(() => {
47
+ config = undefined;
48
+ });
49
+
50
+ describe('init()', () => {
51
+ beforeEach(() => {
52
+ spyOn(
53
+ GeographiesAttributeDataLayer.prototype as any,
54
+ 'initPropertiesFromData'
55
+ );
56
+ spyOn(GeographiesConfig.prototype as any, 'setLayers');
57
+ spyOn(
58
+ GeographiesConfig.prototype as any,
59
+ 'setLayerFeatureIndexAccessors'
60
+ );
61
+ config = createConfig();
62
+ });
63
+ it('calls initPropertiesFromData once', () => {
64
+ expect(
65
+ (config as any).attributeDataLayer.initPropertiesFromData
66
+ ).toHaveBeenCalledTimes(1);
67
+ });
68
+ it('calls setLayers once', () => {
69
+ expect((config as any).setLayers).toHaveBeenCalledTimes(1);
70
+ });
71
+ it('calls setLayerFeatureIndexAccessors once', () => {
72
+ expect(
73
+ (config as any).setLayerFeatureIndexAccessors
74
+ ).toHaveBeenCalledTimes(1);
75
+ });
76
+ });
77
+
78
+ describe('setLayers()', () => {
79
+ beforeEach(() => {
80
+ config = createConfig();
81
+ });
82
+ it('sets layers to an array with attributeDataLayer and geojsonPropertiesLayers', () => {
83
+ expect(config.layers.length).toBe(2);
84
+ });
85
+ });
86
+
87
+ describe('setLayerFeatureIndexAccessors()', () => {
88
+ let featureAccessorSpy: jasmine.Spy;
89
+ beforeEach(() => {
90
+ featureAccessorSpy = spyOn(
91
+ GeographiesLayer.prototype as any,
92
+ 'setFeatureIndexAccessor'
93
+ );
94
+ config = createConfig();
95
+ });
96
+ it('calls setFeatureValueAccessor once per layer', () => {
97
+ expect(featureAccessorSpy).toHaveBeenCalledTimes(2);
98
+ });
99
+ });
100
+ });
@@ -0,0 +1,81 @@
1
+ import { safeAssign } from '@mathstack/app-kit';
2
+ import {
3
+ ExtendedFeature,
4
+ ExtendedFeatureCollection,
5
+ ExtendedGeometryCollection,
6
+ GeoGeometryObjects,
7
+ GeoProjection,
8
+ } from 'd3';
9
+ import {
10
+ GeoJsonProperties,
11
+ GeometryObject as Geometry,
12
+ MultiPolygon,
13
+ Polygon,
14
+ } from 'geojson';
15
+ import { MarksConfig } from '../../marks';
16
+ import { GeographiesFeature } from '../geographies-feature';
17
+ import { GeographiesOptions } from './geographies-options';
18
+ import { GeographiesAttributeDataLayer } from './layers/attribute-data-layer/attribute-data-layer';
19
+ import { GeographiesGeojsonPropertiesLayer } from './layers/geojson-properties-layer/geojson-properties-layer';
20
+
21
+ export class GeographiesConfig<
22
+ Datum,
23
+ TProperties extends GeoJsonProperties,
24
+ TGeometry extends Geometry = MultiPolygon | Polygon,
25
+ >
26
+ extends MarksConfig
27
+ implements GeographiesOptions<Datum, TProperties, TGeometry>
28
+ {
29
+ readonly boundary:
30
+ | ExtendedFeature
31
+ | ExtendedFeatureCollection
32
+ | GeoGeometryObjects
33
+ | ExtendedGeometryCollection;
34
+ readonly attributeDataLayer: GeographiesAttributeDataLayer<
35
+ Datum,
36
+ TProperties,
37
+ TGeometry
38
+ >;
39
+ featureIndexAccessor: (
40
+ d: GeographiesFeature<TProperties, TGeometry>
41
+ ) => string;
42
+ layers: (
43
+ | GeographiesAttributeDataLayer<Datum, TProperties, TGeometry>
44
+ | GeographiesGeojsonPropertiesLayer<TProperties, TGeometry>
45
+ )[];
46
+ readonly geojsonPropertiesLayers: GeographiesGeojsonPropertiesLayer<
47
+ TProperties,
48
+ TGeometry
49
+ >[];
50
+ readonly projection: GeoProjection;
51
+
52
+ constructor(options: GeographiesOptions<Datum, TProperties, TGeometry>) {
53
+ super();
54
+ safeAssign(this, options);
55
+ this.initPropertiesFromData();
56
+ }
57
+
58
+ protected initPropertiesFromData(): void {
59
+ this.setLayers();
60
+ this.setLayerFeatureIndexAccessors();
61
+ }
62
+
63
+ private setLayers(): void {
64
+ this.layers = [];
65
+ if (this.attributeDataLayer) {
66
+ this.layers.push(this.attributeDataLayer);
67
+ }
68
+ if (this.geojsonPropertiesLayers) {
69
+ this.layers.push(...this.geojsonPropertiesLayers);
70
+ }
71
+ this.layers.forEach((layer, i) => {
72
+ layer.id = i;
73
+ });
74
+ }
75
+
76
+ private setLayerFeatureIndexAccessors(): void {
77
+ this.layers.forEach((layer) =>
78
+ layer.setFeatureIndexAccessor(this.featureIndexAccessor)
79
+ );
80
+ }
81
+ }
@@ -0,0 +1,37 @@
1
+ import {
2
+ ExtendedFeature,
3
+ ExtendedFeatureCollection,
4
+ ExtendedGeometryCollection,
5
+ GeoGeometryObjects,
6
+ GeoProjection,
7
+ } from 'd3';
8
+ import { GeoJsonProperties, Geometry, MultiPolygon, Polygon } from 'geojson';
9
+ import { MarksOptions } from '../../marks/config/marks-options';
10
+ import { GeographiesFeature } from '../geographies-feature';
11
+ import { GeographiesAttributeDataLayer } from './layers/attribute-data-layer/attribute-data-layer';
12
+ import { GeographiesGeojsonPropertiesLayer } from './layers/geojson-properties-layer/geojson-properties-layer';
13
+
14
+ export interface GeographiesOptions<
15
+ Datum,
16
+ TProperties extends GeoJsonProperties,
17
+ TGeometry extends Geometry = MultiPolygon | Polygon,
18
+ > extends MarksOptions {
19
+ boundary:
20
+ | ExtendedFeature
21
+ | ExtendedFeatureCollection
22
+ | GeoGeometryObjects
23
+ | ExtendedGeometryCollection;
24
+ attributeDataLayer: GeographiesAttributeDataLayer<
25
+ Datum,
26
+ TProperties,
27
+ TGeometry
28
+ >;
29
+ featureIndexAccessor: (
30
+ d: GeographiesFeature<TProperties, TGeometry>
31
+ ) => string;
32
+ geojsonPropertiesLayers: GeographiesGeojsonPropertiesLayer<
33
+ TProperties,
34
+ TGeometry
35
+ >[];
36
+ projection: GeoProjection;
37
+ }
@@ -0,0 +1,212 @@
1
+ import { safeAssign } from '@mathstack/app-kit';
2
+ import { Geometry, MultiPolygon, Polygon } from 'geojson';
3
+ import { FillDefinition } from '../../../../fill-definitions/fill-definitions';
4
+ import { GeographiesLayerBuilder } from '../geographies-layer/geographies-layer-builder';
5
+ import { GeographiesAttributeDataLayer } from './attribute-data-layer';
6
+ import { CategoricalBinsBuilder } from './dimensions/categorical-bins/categorical-bins-builder';
7
+ import { CustomBreaksBinsAttributeDataDimensionBuilder } from './dimensions/custom-breaks/custom-breaks-bins-builder';
8
+ import { EqualFrequenciesAttributeDataDimensionBuilder } from './dimensions/equal-frequencies-bins/equal-frequencies-bins-builder';
9
+ import { EqualValueRangesBinsBuilder } from './dimensions/equal-value-ranges-bins/equal-value-ranges-bins-builder';
10
+ import { NoBinsAttributeDataDimensionBuilder } from './dimensions/no-bins/no-bins-builder';
11
+
12
+ const DEFAULT = {
13
+ _class: () => '',
14
+ _enableEventActions: true,
15
+ };
16
+
17
+ export class GeographiesAttributeDataLayerBuilder<
18
+ Datum,
19
+ TProperties,
20
+ TGeometry extends Geometry = MultiPolygon | Polygon,
21
+ > extends GeographiesLayerBuilder<TProperties, TGeometry> {
22
+ private _customFills: FillDefinition<Datum>[];
23
+ private _data: Datum[];
24
+ private _geographyIndexAccessor: (d: Datum) => string;
25
+
26
+ private binsBuilder:
27
+ | CategoricalBinsBuilder<Datum>
28
+ | CustomBreaksBinsAttributeDataDimensionBuilder<Datum>
29
+ | EqualFrequenciesAttributeDataDimensionBuilder<Datum>
30
+ | EqualValueRangesBinsBuilder<Datum>
31
+ | NoBinsAttributeDataDimensionBuilder<Datum>;
32
+
33
+ private categoricalBinsBuilder: CategoricalBinsBuilder<Datum>;
34
+ private customBreaksBinsBuilder: CustomBreaksBinsAttributeDataDimensionBuilder<Datum>;
35
+ private equalFrequenciesBinsBuilder: EqualFrequenciesAttributeDataDimensionBuilder<Datum>;
36
+ private equalValueRangesBinsBuilder: EqualValueRangesBinsBuilder<Datum>;
37
+ private noBinsBuilder: NoBinsAttributeDataDimensionBuilder<Datum>;
38
+
39
+ constructor() {
40
+ super();
41
+ safeAssign(this, DEFAULT);
42
+ }
43
+
44
+ /**
45
+ * OPTIONAL. Creates a configuration object that maps data to colors by categorical values.
46
+ *
47
+ * For example, if the data for a set of U.S. states had a string property, 'region', this could be used to color the states by region.
48
+ */
49
+ categoricalBins(bins: null): this;
50
+ categoricalBins(bins: (bins: CategoricalBinsBuilder<Datum>) => void): this;
51
+ categoricalBins(
52
+ bins: ((bins: CategoricalBinsBuilder<Datum>) => void) | null
53
+ ): this {
54
+ if (bins === null) {
55
+ this.categoricalBinsBuilder = undefined;
56
+ return this;
57
+ }
58
+ this.categoricalBinsBuilder = new CategoricalBinsBuilder<Datum, string>();
59
+ bins(this.categoricalBinsBuilder);
60
+ return this;
61
+ }
62
+
63
+ /**
64
+ * OPTIONAL. Creates a configuration object that maps data to colors by custom breaks values for bins.
65
+ */
66
+ customBreaksBins(bins: null): this;
67
+ customBreaksBins(
68
+ bins: (bins: CustomBreaksBinsAttributeDataDimensionBuilder<Datum>) => void
69
+ ): this;
70
+ customBreaksBins(
71
+ bins:
72
+ | ((bins: CustomBreaksBinsAttributeDataDimensionBuilder<Datum>) => void)
73
+ | null
74
+ ): this {
75
+ if (bins === null) {
76
+ this.customBreaksBinsBuilder = undefined;
77
+ return this;
78
+ }
79
+ this.customBreaksBinsBuilder =
80
+ new CustomBreaksBinsAttributeDataDimensionBuilder();
81
+ bins(this.customBreaksBinsBuilder);
82
+ return this;
83
+ }
84
+
85
+ /**
86
+ * REQUIRED. The data that will be used to color the geographies.
87
+ */
88
+ data(data: Datum[]): this {
89
+ this._data = data;
90
+ return this;
91
+ }
92
+
93
+ /**
94
+ * OPTIONAL. Creates a configuration object that for creating a map without binning values.
95
+ */
96
+ noBins(bins: null): this;
97
+ noBins(
98
+ bins: (bins: NoBinsAttributeDataDimensionBuilder<Datum>) => void
99
+ ): this;
100
+ noBins(
101
+ bins: ((bins: NoBinsAttributeDataDimensionBuilder<Datum>) => void) | null
102
+ ): this {
103
+ if (bins === null) {
104
+ this.noBinsBuilder = undefined;
105
+ return this;
106
+ }
107
+ this.noBinsBuilder = new NoBinsAttributeDataDimensionBuilder();
108
+ bins(this.noBinsBuilder);
109
+ return this;
110
+ }
111
+
112
+ /**
113
+ * OPTIONAL. Creates a configuration object that maps data to bins that each have the same size range.
114
+ *
115
+ * For example, bins may be, 0-10, 10-20, 20-30, etc.
116
+ */
117
+ equalValueRangesBins(bins: null): this;
118
+ equalValueRangesBins(
119
+ bins: (bins: EqualValueRangesBinsBuilder<Datum>) => void
120
+ ): this;
121
+ equalValueRangesBins(
122
+ bins: ((bins: EqualValueRangesBinsBuilder<Datum>) => void) | null
123
+ ): this {
124
+ if (bins === null) {
125
+ this.equalValueRangesBinsBuilder = undefined;
126
+ return this;
127
+ }
128
+ this.equalValueRangesBinsBuilder = new EqualValueRangesBinsBuilder();
129
+ bins(this.equalValueRangesBinsBuilder);
130
+ return this;
131
+ }
132
+
133
+ /**
134
+ * OPTIONAL. Creates a configuration object that maps data to bins that contain an equal number of data observations.
135
+ *
136
+ * This is useful for creating quartiles, deciles, etc.
137
+ */
138
+ equalFrequenciesBins(bins: null): this;
139
+ equalFrequenciesBins(
140
+ bins: (bins: EqualFrequenciesAttributeDataDimensionBuilder<Datum>) => void
141
+ ): this;
142
+ equalFrequenciesBins(
143
+ bins:
144
+ | ((bins: EqualFrequenciesAttributeDataDimensionBuilder<Datum>) => void)
145
+ | null
146
+ ): this {
147
+ if (bins === null) {
148
+ this.equalFrequenciesBinsBuilder = undefined;
149
+ return this;
150
+ }
151
+ this.equalFrequenciesBinsBuilder =
152
+ new EqualFrequenciesAttributeDataDimensionBuilder();
153
+ bins(this.equalFrequenciesBinsBuilder);
154
+ return this;
155
+ }
156
+
157
+ customFills(customFills: FillDefinition<Datum>[]): this {
158
+ this._customFills = customFills;
159
+ return this;
160
+ }
161
+
162
+ /**
163
+ * REQUIRED. The accessor function that returns a value from a Datum that must match the value returned by featureIndexAccessor.
164
+ */
165
+ geographyIndexAccessor(accessor: (d: Datum) => string): this {
166
+ this._geographyIndexAccessor = accessor;
167
+ return this;
168
+ }
169
+
170
+ _build(): GeographiesAttributeDataLayer<Datum, TProperties, TGeometry> {
171
+ this.validateBuilder();
172
+ return new GeographiesAttributeDataLayer({
173
+ marksClass: 'vic-geographies-attribute-data-layer',
174
+ attributeDimension: this.binsBuilder._build(),
175
+ customFills: this._customFills,
176
+ data: this._data,
177
+ featureClass: this._class,
178
+ enableEventActions: this._enableEventActions,
179
+ geographies: this._geographies,
180
+ geographyIndexAccessor: this._geographyIndexAccessor,
181
+ labels: this.labelsBuilder?._build(),
182
+ mixBlendMode: this._mixBlendMode,
183
+ stroke: this.strokeBuilder?._build(),
184
+ });
185
+ }
186
+
187
+ private validateBuilder(): void {
188
+ const binsBuilders = [
189
+ this.categoricalBinsBuilder,
190
+ this.customBreaksBinsBuilder,
191
+ this.equalFrequenciesBinsBuilder,
192
+ this.equalValueRangesBinsBuilder,
193
+ this.noBinsBuilder,
194
+ ];
195
+ if (!this._data) {
196
+ throw new Error('Data must be provided');
197
+ }
198
+ if (!this._geographyIndexAccessor) {
199
+ throw new Error('Geography index accessor must be provided');
200
+ }
201
+ const numBinsBuilders = binsBuilders.filter((builder) => builder).length;
202
+ if (numBinsBuilders !== 1) {
203
+ throw new Error(
204
+ `Exactly one bin strategy must be provided. Currently, ${numBinsBuilders} are provided.`
205
+ );
206
+ }
207
+ this.binsBuilder = binsBuilders.find((builder) => builder);
208
+ if (!this.strokeBuilder) {
209
+ this.initStrokeBuilder();
210
+ }
211
+ }
212
+ }
@@ -1,16 +1,26 @@
1
- import { Geometry, MultiPolygon, Polygon } from 'geojson';
2
- import { FillDefinition } from '../../../../fill-definitions/fill-definitions';
3
- import { GeographiesLayerOptions } from '../geographies-layer/geographies-layer-options';
4
- import { CategoricalBinsAttributeDataDimension } from './dimensions/categorical-bins/categorical-bins';
5
- import { CustomBreaksBinsAttributeDataDimension } from './dimensions/custom-breaks/custom-breaks-bins';
6
- import { EqualFrequenciesAttributeDataDimension } from './dimensions/equal-frequencies-bins/equal-frequencies-bins';
7
- import { EqualValueRangesAttributeDataDimension } from './dimensions/equal-value-ranges-bins/equal-value-ranges-bins';
8
- import { NoBinsAttributeDataDimension } from './dimensions/no-bins/no-bins';
9
- export interface GeographiesAttributeDataLayerOptions<Datum, TProperties, TGeometry extends Geometry = MultiPolygon | Polygon> extends GeographiesLayerOptions<TProperties, TGeometry> {
10
- attributeDimension: CategoricalBinsAttributeDataDimension<Datum> | NoBinsAttributeDataDimension<Datum> | EqualValueRangesAttributeDataDimension<Datum> | EqualFrequenciesAttributeDataDimension<Datum> | CustomBreaksBinsAttributeDataDimension<Datum>;
11
- customFills: FillDefinition<Datum>[];
12
- data: Datum[];
13
- geographyIndexAccessor: (d: Datum) => string;
14
- marksClass: string;
15
- mixBlendMode: string;
16
- }
1
+ import { Geometry, MultiPolygon, Polygon } from 'geojson';
2
+ import { FillDefinition } from '../../../../fill-definitions/fill-definitions';
3
+ import { GeographiesLayerOptions } from '../geographies-layer/geographies-layer-options';
4
+ import { CategoricalBinsAttributeDataDimension } from './dimensions/categorical-bins/categorical-bins';
5
+ import { CustomBreaksBinsAttributeDataDimension } from './dimensions/custom-breaks/custom-breaks-bins';
6
+ import { EqualFrequenciesAttributeDataDimension } from './dimensions/equal-frequencies-bins/equal-frequencies-bins';
7
+ import { EqualValueRangesAttributeDataDimension } from './dimensions/equal-value-ranges-bins/equal-value-ranges-bins';
8
+ import { NoBinsAttributeDataDimension } from './dimensions/no-bins/no-bins';
9
+
10
+ export interface GeographiesAttributeDataLayerOptions<
11
+ Datum,
12
+ TProperties,
13
+ TGeometry extends Geometry = MultiPolygon | Polygon,
14
+ > extends GeographiesLayerOptions<TProperties, TGeometry> {
15
+ attributeDimension:
16
+ | CategoricalBinsAttributeDataDimension<Datum>
17
+ | NoBinsAttributeDataDimension<Datum>
18
+ | EqualValueRangesAttributeDataDimension<Datum>
19
+ | EqualFrequenciesAttributeDataDimension<Datum>
20
+ | CustomBreaksBinsAttributeDataDimension<Datum>;
21
+ customFills: FillDefinition<Datum>[];
22
+ data: Datum[];
23
+ geographyIndexAccessor: (d: Datum) => string;
24
+ marksClass: string;
25
+ mixBlendMode: string;
26
+ }