@amcharts/amcharts5-mcp 1.9.5 → 1.9.6

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 (1213) hide show
  1. package/README.md +5 -5
  2. package/content/SKILL.md +143 -246
  3. package/content/flow.md +6 -6
  4. package/content/gantt.md +4 -4
  5. package/content/hierarchy.md +7 -7
  6. package/content/json.md +20 -20
  7. package/content/map.md +35 -37
  8. package/content/pie.md +8 -8
  9. package/content/radar.md +4 -4
  10. package/content/stock.md +14 -24
  11. package/content/timeline.md +2 -2
  12. package/content/ui-elements.md +4 -4
  13. package/content/venn.md +2 -2
  14. package/content/wordcloud.md +15 -15
  15. package/content/xy.md +32 -45
  16. package/extended/ai.md +9 -9
  17. package/extended/charts/flow-charts/arc-diagram.md +162 -128
  18. package/extended/charts/flow-charts/chord-diagram.md +256 -120
  19. package/extended/charts/flow-charts/flow-chart-bullets.md +64 -6
  20. package/extended/charts/flow-charts/sankey-diagram.md +273 -142
  21. package/extended/charts/flow-charts.md +134 -72
  22. package/extended/charts/gantt/cgantt-appearance.md +7 -5
  23. package/extended/charts/gantt/serializing-gantt-data.md +47 -5
  24. package/extended/charts/gantt.md +1 -167
  25. package/extended/charts/hierarchy/breadcrumbs.md +26 -2
  26. package/extended/charts/hierarchy/force-directed.md +216 -91
  27. package/extended/charts/hierarchy/hierarchy-api.md +65 -6
  28. package/extended/charts/hierarchy/hierarchy-drill-down.md +6 -1605
  29. package/extended/charts/hierarchy/hierarchy-link-bullets.md +64 -4
  30. package/extended/charts/hierarchy/hierarchy-node-colors.md +71 -49
  31. package/extended/charts/hierarchy/legend-hierarchy-series.md +40 -28
  32. package/extended/charts/hierarchy/pack.md +49 -9
  33. package/extended/charts/hierarchy/partition.md +78 -13
  34. package/extended/charts/hierarchy/sunburst.md +87 -20
  35. package/extended/charts/hierarchy/tree.md +178 -63
  36. package/extended/charts/hierarchy/treemap.md +2 -387
  37. package/extended/charts/hierarchy/voronoi-treemap.md +95 -37
  38. package/extended/charts/hierarchy.md +2 -696
  39. package/extended/charts/map-chart/clustered-point-series.md +76 -3
  40. package/extended/charts/map-chart/country-data.md +39 -19
  41. package/extended/charts/map-chart/graticule-series.md +24 -7
  42. package/extended/charts/map-chart/map-api.md +1 -74
  43. package/extended/charts/map-chart/map-drill-down.md +71 -28
  44. package/extended/charts/map-chart/map-line-series.md +190 -219
  45. package/extended/charts/map-chart/map-pan-zoom.md +250 -120
  46. package/extended/charts/map-chart/map-point-series.md +245 -200
  47. package/extended/charts/map-chart/map-polygon-series.md +3 -242
  48. package/extended/charts/map-chart/map-raster-series.md +89 -80
  49. package/extended/charts/map-chart/map-sankey-series.md +213 -284
  50. package/extended/charts/map-chart/map-translations.md +108 -499
  51. package/extended/charts/map-chart/night-series.md +92 -43
  52. package/extended/charts/map-chart/pixel-map-series.md +144 -84
  53. package/extended/charts/map-chart.md +3 -308
  54. package/extended/charts/percent-charts/grouping-slices.md +74 -65
  55. package/extended/charts/percent-charts/legend-percent-series.md +41 -29
  56. package/extended/charts/percent-charts/pie-chart/pie-series.md +4 -372
  57. package/extended/charts/percent-charts/pie-chart.md +127 -37
  58. package/extended/charts/percent-charts/sliced-chart/funnel-series.md +160 -35
  59. package/extended/charts/percent-charts/sliced-chart/pictorial-stacked-series.md +135 -21
  60. package/extended/charts/percent-charts/sliced-chart/pyramid-series.md +151 -39
  61. package/extended/charts/percent-charts/sliced-chart.md +108 -44
  62. package/extended/charts/percent-charts.md +7 -7
  63. package/extended/charts/radar-chart/gauge-charts.md +203 -39
  64. package/extended/charts/radar-chart/radar-axes.md +42 -7
  65. package/extended/charts/radar-chart/radar-series.md +12 -4
  66. package/extended/charts/radar-chart.md +179 -129
  67. package/extended/charts/stock/indicators.md +53 -190
  68. package/extended/charts/stock/panels.md +1 -254
  69. package/extended/charts/stock/percent-mode.md +45 -17
  70. package/extended/charts/stock/serializing-indicators-annotations.md +52 -10
  71. package/extended/charts/stock/stock-annotations.md +48 -21
  72. package/extended/charts/stock/stock-legend.md +43 -13
  73. package/extended/charts/stock/toolbar/comparison-control.md +91 -36
  74. package/extended/charts/stock/toolbar/data-save-control.md +63 -25
  75. package/extended/charts/stock/toolbar/date-range-selector.md +38 -13
  76. package/extended/charts/stock/toolbar/drawing-control.md +172 -68
  77. package/extended/charts/stock/toolbar/dropdown-control.md +32 -6
  78. package/extended/charts/stock/toolbar/dropdown-list-control.md +155 -71
  79. package/extended/charts/stock/toolbar/indicator-control.md +82 -25
  80. package/extended/charts/stock/toolbar/interval-control.md +58 -22
  81. package/extended/charts/stock/toolbar/period-selector.md +88 -31
  82. package/extended/charts/stock/toolbar/reset-control.md +26 -9
  83. package/extended/charts/stock/toolbar/series-type-control.md +44 -18
  84. package/extended/charts/stock/toolbar/settings-control.md +82 -32
  85. package/extended/charts/stock/toolbar.md +87 -124
  86. package/extended/charts/stock/translating-stock-chart.md +22 -4
  87. package/extended/charts/stock.md +196 -70
  88. package/extended/charts/timeline.md +199 -385
  89. package/extended/charts/venn.md +210 -79
  90. package/extended/charts/word-cloud.md +207 -134
  91. package/extended/charts/xy-chart/axes/axis-headers.md +27 -2
  92. package/extended/charts/xy-chart/axes/axis-ranges.md +193 -60
  93. package/extended/charts/xy-chart/axes/category-axis.md +54 -14
  94. package/extended/charts/xy-chart/axes/category-date-axis.md +59 -10
  95. package/extended/charts/xy-chart/axes/date-axis.md +275 -67
  96. package/extended/charts/xy-chart/axes/duration-axis.md +18 -2
  97. package/extended/charts/xy-chart/axes/gapless-date-axis.md +17 -6
  98. package/extended/charts/xy-chart/axes/value-axis.md +191 -41
  99. package/extended/charts/xy-chart/axes.md +43 -1716
  100. package/extended/charts/xy-chart/cursor.md +218 -80
  101. package/extended/charts/xy-chart/legend-xy-series.md +2 -299
  102. package/extended/charts/xy-chart/scrollbars.md +3 -517
  103. package/extended/charts/xy-chart/series/candlestick-series.md +77 -33
  104. package/extended/charts/xy-chart/series/column-series.md +132 -33
  105. package/extended/charts/xy-chart/series/line-series.md +104 -22
  106. package/extended/charts/xy-chart/series/smoothed-series.md +40 -24
  107. package/extended/charts/xy-chart/series/step-line-series.md +45 -9
  108. package/extended/charts/xy-chart/series.md +221 -84
  109. package/extended/charts/xy-chart/xy-chart-containers.md +39 -50
  110. package/extended/charts/xy-chart/zoom-and-pan.md +4 -2419
  111. package/extended/charts/xy-chart.md +145 -122
  112. package/extended/concepts/accessibility.md +198 -49
  113. package/extended/concepts/animations.md +8 -909
  114. package/extended/concepts/colors-gradients-and-patterns/filters.md +27 -52
  115. package/extended/concepts/colors-gradients-and-patterns/gradients.md +152 -71
  116. package/extended/concepts/colors-gradients-and-patterns/patterns.md +244 -221
  117. package/extended/concepts/colors-gradients-and-patterns/shadows.md +55 -31
  118. package/extended/concepts/colors-gradients-and-patterns.md +143 -183
  119. package/extended/concepts/common-elements/bullets.md +10 -1859
  120. package/extended/concepts/common-elements/buttons.md +106 -60
  121. package/extended/concepts/common-elements/containers.md +5 -1040
  122. package/extended/concepts/common-elements/graphics.md +66 -30
  123. package/extended/concepts/common-elements/html-content.md +65 -11
  124. package/extended/concepts/common-elements/images.md +35 -7
  125. package/extended/concepts/common-elements/labels.md +118 -50
  126. package/extended/concepts/common-elements/layers.md +31 -39
  127. package/extended/concepts/common-elements/modal-popups.md +72 -36
  128. package/extended/concepts/common-elements/tooltips.md +204 -45
  129. package/extended/concepts/common-elements.md +1 -1
  130. package/extended/concepts/data/net-load-utility.md +35 -46
  131. package/extended/concepts/data.md +299 -306
  132. package/extended/concepts/events.md +102 -26
  133. package/extended/concepts/exporting/annotator.md +71 -34
  134. package/extended/concepts/exporting/export-menu.md +144 -98
  135. package/extended/concepts/exporting/exporting-api.md +76 -8
  136. package/extended/concepts/exporting/exporting-data.md +116 -48
  137. package/extended/concepts/exporting/exporting-images.md +100 -55
  138. package/extended/concepts/exporting/exporting-pdf.md +171 -138
  139. package/extended/concepts/exporting/exporting-svg.md +72 -53
  140. package/extended/concepts/exporting/printing.md +61 -19
  141. package/extended/concepts/exporting.md +93 -119
  142. package/extended/concepts/formatters/data-placeholders.md +67 -43
  143. package/extended/concepts/formatters/formatting-dates.md +108 -388
  144. package/extended/concepts/formatters/formatting-durations.md +64 -55
  145. package/extended/concepts/formatters/text-styling.md +41 -74
  146. package/extended/concepts/formatters.md +44 -12
  147. package/extended/concepts/legend/heat-legend.md +2 -1233
  148. package/extended/concepts/legend.md +12 -1889
  149. package/extended/concepts/locales/creating-translations.md +201 -67
  150. package/extended/concepts/locales/right-to-left-support.md +2 -138
  151. package/extended/concepts/locales.md +29 -5
  152. package/extended/concepts/responsive.md +1 -103
  153. package/extended/concepts/serializing/chart-serializer.md +133 -148
  154. package/extended/concepts/serializing/json-editor.md +11 -6
  155. package/extended/concepts/serializing.md +257 -140
  156. package/extended/concepts/settings/adapters.md +55 -5
  157. package/extended/concepts/settings/heat-rules.md +142 -77
  158. package/extended/concepts/settings/list-templates.md +66 -8
  159. package/extended/concepts/settings/states.md +38 -29
  160. package/extended/concepts/settings/template-fields.md +26 -28
  161. package/extended/concepts/settings.md +47 -5
  162. package/extended/concepts/themes/creating-themes.md +297 -738
  163. package/extended/concepts.md +1 -1
  164. package/extended/examples/candlestick-ohlc/box-plot-chart.md +6 -4
  165. package/extended/examples/candlestick-ohlc/candlestick-chart.md +6 -4
  166. package/extended/examples/candlestick-ohlc/ohlc-chart.md +6 -4
  167. package/extended/examples/candlestick-ohlc/on-demand-data-loading.md +6 -4
  168. package/extended/examples/candlestick-ohlc/professional-candlesticks.md +6 -4
  169. package/extended/examples/candlestick-ohlc/stock-chart-candlesticks.md +6 -4
  170. package/extended/examples/column-bar/100-stacked-column-chart.md +6 -4
  171. package/extended/examples/column-bar/bar-and-line-chart-mix.md +6 -4
  172. package/extended/examples/column-bar/bar-chart-race.md +6 -4
  173. package/extended/examples/column-bar/bars-with-moving-bullets.md +6 -4
  174. package/extended/examples/column-bar/bullet-chart.md +6 -4
  175. package/extended/examples/column-bar/carbon-zero-progress.md +6 -4
  176. package/extended/examples/column-bar/clustered-bar-chart.md +6 -4
  177. package/extended/examples/column-bar/clustered-column-chart.md +6 -4
  178. package/extended/examples/column-bar/column-and-line-mix.md +6 -4
  179. package/extended/examples/column-bar/column-chart-images-top.md +6 -4
  180. package/extended/examples/column-bar/column-chart-with-patterns.md +5 -3
  181. package/extended/examples/column-bar/column-with-rotated-series.md +6 -4
  182. package/extended/examples/column-bar/columns-with-grainy-gradients.md +6 -4
  183. package/extended/examples/column-bar/columns-with-moving-bullets.md +6 -4
  184. package/extended/examples/column-bar/curved-columns.md +6 -4
  185. package/extended/examples/column-bar/divergent-stacked-bars.md +6 -4
  186. package/extended/examples/column-bar/drag-and-change-column-value.md +6 -4
  187. package/extended/examples/column-bar/drag-ordering-of-bars.md +6 -4
  188. package/extended/examples/column-bar/dumbbell-plot.md +6 -4
  189. package/extended/examples/column-bar/flame-chart.md +10 -6
  190. package/extended/examples/column-bar/floating-bar-chart.md +14 -29
  191. package/extended/examples/column-bar/grouped-and-sorted-columns.md +6 -4
  192. package/extended/examples/column-bar/grouped-stacks.md +6 -4
  193. package/extended/examples/column-bar/heat-map-with-legend.md +6 -4
  194. package/extended/examples/column-bar/horizontal-dumbbell-plot.md +6 -4
  195. package/extended/examples/column-bar/images-as-categories.md +20 -31
  196. package/extended/examples/column-bar/layered-column-chart.md +10 -9
  197. package/extended/examples/column-bar/lollipop-chart.md +6 -4
  198. package/extended/examples/column-bar/network-waterfall-chart.md +7 -5
  199. package/extended/examples/column-bar/pareto-diagram.md +6 -4
  200. package/extended/examples/column-bar/partitioned-bar-chart.md +6 -4
  201. package/extended/examples/column-bar/pictorial-column-chart.md +6 -4
  202. package/extended/examples/column-bar/real-time-data-sorting.md +6 -4
  203. package/extended/examples/column-bar/risk-heatmap.md +6 -4
  204. package/extended/examples/column-bar/simple-column-chart.md +6 -4
  205. package/extended/examples/column-bar/sorted-bar-chart.md +6 -4
  206. package/extended/examples/column-bar/stacked-bar-chart-with-negative-values.md +6 -4
  207. package/extended/examples/column-bar/stacked-bar-chart.md +6 -4
  208. package/extended/examples/column-bar/stacked-clustered-column-chart.md +6 -4
  209. package/extended/examples/column-bar/stacked-column-chart.md +6 -4
  210. package/extended/examples/column-bar/stacked-waterfall-chart.md +6 -4
  211. package/extended/examples/column-bar/step-count-chart.md +6 -4
  212. package/extended/examples/column-bar/time-zones-and-daylight-saving.md +6 -4
  213. package/extended/examples/column-bar/variance-indicators.md +6 -4
  214. package/extended/examples/column-bar/waffle-chart.md +6 -4
  215. package/extended/examples/column-bar/waterfall-chart.md +6 -4
  216. package/extended/examples/dashboards/maps-and-charts-dashboard.md +43 -21
  217. package/extended/examples/dashboards/road-trip-dashboard-with-map.md +6 -4
  218. package/extended/examples/docs-demos/a-wordcloud-with-a-custom-shape.md +185 -0
  219. package/extended/examples/docs-demos/adding-bullets-at-specific-dates.md +257 -0
  220. package/extended/examples/docs-demos/adding-events-to-bullets.md +166 -0
  221. package/extended/examples/docs-demos/adding-horizontal-line-drawing-dynamically-on-a-stock-chart.md +744 -0
  222. package/extended/examples/docs-demos/adding-images-to-container.md +83 -0
  223. package/extended/examples/docs-demos/adding-tooltips-to-pie-chart-slice-labels.md +96 -0
  224. package/extended/examples/docs-demos/alignment-of-nodes-on-sankey-diagram.md +79 -0
  225. package/extended/examples/docs-demos/amchrts-5-translating-country-names.md +79 -0
  226. package/extended/examples/docs-demos/annotating-charts.md +202 -0
  227. package/extended/examples/docs-demos/axis-bullets-on-opposite-side.md +277 -0
  228. package/extended/examples/docs-demos/axis-icons-via-ranges-2.md +236 -0
  229. package/extended/examples/docs-demos/axis-icons-via-ranges.md +229 -0
  230. package/extended/examples/docs-demos/axis-ranges-with-line-series-2.md +223 -0
  231. package/extended/examples/docs-demos/axis-ranges-with-line-series.md +223 -0
  232. package/extended/examples/docs-demos/axis-ranges-with-series.md +208 -0
  233. package/extended/examples/docs-demos/axis-ranges.md +242 -0
  234. package/extended/examples/docs-demos/axis-start-and-end-locations.md +161 -0
  235. package/extended/examples/docs-demos/basic-containers.md +79 -0
  236. package/extended/examples/docs-demos/basic-stock-chart.md +723 -0
  237. package/extended/examples/docs-demos/candlestick-series.md +200 -0
  238. package/extended/examples/docs-demos/canvas-and-svg-renderers.md +128 -0
  239. package/extended/examples/docs-demos/chart-title.md +192 -0
  240. package/extended/examples/docs-demos/chart-with-an-html-title.md +138 -0
  241. package/extended/examples/docs-demos/chart-with-annotator-support.md +201 -0
  242. package/extended/examples/docs-demos/chart-with-oversized-labels.md +118 -0
  243. package/extended/examples/docs-demos/chart-with-svg-filters.md +103 -0
  244. package/extended/examples/docs-demos/chart-with-title-and-sub-title.md +151 -0
  245. package/extended/examples/docs-demos/chord-diagram-2.md +84 -0
  246. package/extended/examples/docs-demos/chord-diagram.md +78 -0
  247. package/extended/examples/docs-demos/chord-directed-diagram.md +87 -0
  248. package/extended/examples/docs-demos/chord-non-ribbon-diagram.md +79 -0
  249. package/extended/examples/docs-demos/circular-labels.md +102 -0
  250. package/extended/examples/docs-demos/click-events-on-map-point-series.md +112 -0
  251. package/extended/examples/docs-demos/clustered-column-chart.md +127 -0
  252. package/extended/examples/docs-demos/clustering-columnseries.md +135 -0
  253. package/extended/examples/docs-demos/color-set-via-theme.md +188 -0
  254. package/extended/examples/docs-demos/column-chart-with-adapters-for-the-tooltips.md +161 -0
  255. package/extended/examples/docs-demos/column-series-with-adapters.md +125 -0
  256. package/extended/examples/docs-demos/column-series-with-bullet-masking-disabled.md +170 -0
  257. package/extended/examples/docs-demos/column-series-with-focusable-columns-2.md +139 -0
  258. package/extended/examples/docs-demos/column-series-with-focusable-columns.md +145 -0
  259. package/extended/examples/docs-demos/column-series-with-label-bullets.md +160 -0
  260. package/extended/examples/docs-demos/column-series-with-multiple-bullets.md +174 -0
  261. package/extended/examples/docs-demos/column-series-with-shadows.md +127 -0
  262. package/extended/examples/docs-demos/columns-with-custom-states.md +126 -0
  263. package/extended/examples/docs-demos/configuring-lineseries-appearance.md +129 -0
  264. package/extended/examples/docs-demos/consolidated-tooltip.md +232 -0
  265. package/extended/examples/docs-demos/creating-bullets-via-theme.md +174 -0
  266. package/extended/examples/docs-demos/cursor-and-legend-labels-with-category-axis.md +142 -0
  267. package/extended/examples/docs-demos/cursor-and-legend-labels.md +169 -0
  268. package/extended/examples/docs-demos/custom-button-to-add-data-items-2.md +212 -0
  269. package/extended/examples/docs-demos/custom-button-to-add-data-items-3.md +210 -0
  270. package/extended/examples/docs-demos/custom-button-to-add-data-items-4.md +210 -0
  271. package/extended/examples/docs-demos/custom-button-to-add-data-items-5.md +216 -0
  272. package/extended/examples/docs-demos/custom-button-to-add-data-items.md +197 -0
  273. package/extended/examples/docs-demos/custom-data-grouping-function.md +163 -0
  274. package/extended/examples/docs-demos/custom-pdf-export.md +269 -0
  275. package/extended/examples/docs-demos/custom-responsive-functions.md +110 -0
  276. package/extended/examples/docs-demos/custom-sankey-node-colors.md +103 -0
  277. package/extended/examples/docs-demos/custom-tooltip-on-scrollbar-grips.md +199 -0
  278. package/extended/examples/docs-demos/custom-xlsx-export.md +244 -0
  279. package/extended/examples/docs-demos/customizing-colors-of-a-stocktoolbar.md +708 -0
  280. package/extended/examples/docs-demos/customizing-tooltip-colors.md +177 -0
  281. package/extended/examples/docs-demos/data-grouping.md +152 -0
  282. package/extended/examples/docs-demos/date-axis-zoom-events.md +153 -0
  283. package/extended/examples/docs-demos/day-and-night-on-a-map.md +84 -0
  284. package/extended/examples/docs-demos/day-and-night-satellite-map.md +89 -0
  285. package/extended/examples/docs-demos/disabling-hovers-in-piechart-legend.md +99 -0
  286. package/extended/examples/docs-demos/disabling-radar-line-series-end-connection.md +199 -0
  287. package/extended/examples/docs-demos/display-charts-data-in-an-html-table.md +233 -0
  288. package/extended/examples/docs-demos/disposing-previously-created-root-element.md +188 -0
  289. package/extended/examples/docs-demos/dotted-world-map-with-heat-rules.md +118 -0
  290. package/extended/examples/docs-demos/drill-down-map.md +133 -0
  291. package/extended/examples/docs-demos/drill-down-sunburst-chart-via-api.md +168 -0
  292. package/extended/examples/docs-demos/drill-down-to-countries-with-zoom-control.md +227 -0
  293. package/extended/examples/docs-demos/drill-down-to-countries.md +200 -0
  294. package/extended/examples/docs-demos/duration-axis.md +140 -0
  295. package/extended/examples/docs-demos/dynamic-drill-down-map.md +171 -0
  296. package/extended/examples/docs-demos/dynamically-adding-and-removing-nodes-in-a-force-directed-tr.md +120 -0
  297. package/extended/examples/docs-demos/dynamically-changing-node-values-on-a-force-directed-tree.md +111 -0
  298. package/extended/examples/docs-demos/easing-functions-2.md +113 -0
  299. package/extended/examples/docs-demos/easing-functions.md +106 -0
  300. package/extended/examples/docs-demos/easing.md +97 -0
  301. package/extended/examples/docs-demos/expanded-tooltip-area.md +110 -0
  302. package/extended/examples/docs-demos/exporting-as-svg.md +107 -0
  303. package/extended/examples/docs-demos/exporting-data-with-custom-menu-2.md +262 -0
  304. package/extended/examples/docs-demos/exporting-data-with-custom-menu.md +252 -0
  305. package/extended/examples/docs-demos/exporting-data.md +246 -0
  306. package/extended/examples/docs-demos/exporting-menu-in-external-container.md +251 -0
  307. package/extended/examples/docs-demos/fill-on-a-plot-container.md +189 -0
  308. package/extended/examples/docs-demos/fixing-y-axis-zoom.md +145 -0
  309. package/extended/examples/docs-demos/flight-routes-arcing-above-a-globe.md +157 -0
  310. package/extended/examples/docs-demos/force-directed-chart-2.md +337 -0
  311. package/extended/examples/docs-demos/force-directed-chart-with-a-legend.md +365 -0
  312. package/extended/examples/docs-demos/force-directed-chart-with-cross-linked-nodes.md +139 -0
  313. package/extended/examples/docs-demos/force-directed-chart-with-fixed-nodes.md +346 -0
  314. package/extended/examples/docs-demos/force-directed-chart-with-images-as-nodes-2.md +148 -0
  315. package/extended/examples/docs-demos/force-directed-chart-with-images-as-nodes.md +124 -0
  316. package/extended/examples/docs-demos/force-directed-chart-with-legend.md +349 -0
  317. package/extended/examples/docs-demos/force-directed-chart-with-strength-configuration.md +140 -0
  318. package/extended/examples/docs-demos/force-directed-chart-with-topdepth-2.md +110 -0
  319. package/extended/examples/docs-demos/force-directed-chart-with-topdepth.md +340 -0
  320. package/extended/examples/docs-demos/force-directed-chart.md +350 -0
  321. package/extended/examples/docs-demos/force-directed-tree-with-animated-bullets.md +163 -0
  322. package/extended/examples/docs-demos/force-directed-tree-with-bullets.md +148 -0
  323. package/extended/examples/docs-demos/formatting-date-axis-labels.md +197 -0
  324. package/extended/examples/docs-demos/funnel-chart-2.md +105 -0
  325. package/extended/examples/docs-demos/funnel-chart.md +90 -0
  326. package/extended/examples/docs-demos/funnel-with-bullets.md +116 -0
  327. package/extended/examples/docs-demos/gantt-chart-w-data-saving-to-localstorage.md +309 -0
  328. package/extended/examples/docs-demos/gantt-chart-with-external-data.md +163 -0
  329. package/extended/examples/docs-demos/gantt-chart.md +173 -0
  330. package/extended/examples/docs-demos/gapless-date-axis.md +157 -0
  331. package/extended/examples/docs-demos/gauge-chart-2.md +117 -0
  332. package/extended/examples/docs-demos/gauge-chart-with-hand.md +145 -0
  333. package/extended/examples/docs-demos/gauge-chart.md +69 -0
  334. package/extended/examples/docs-demos/globe-with-a-raised-sun.md +104 -0
  335. package/extended/examples/docs-demos/globe-with-value-columns.md +120 -0
  336. package/extended/examples/docs-demos/gradients-2.md +127 -0
  337. package/extended/examples/docs-demos/gradients-with-line-series.md +140 -0
  338. package/extended/examples/docs-demos/gradients.md +167 -0
  339. package/extended/examples/docs-demos/grid-layout-of-the-container.md +90 -0
  340. package/extended/examples/docs-demos/heat-rules-on-columnseries-2.md +141 -0
  341. package/extended/examples/docs-demos/heat-rules-on-columnseries.md +133 -0
  342. package/extended/examples/docs-demos/horizontal-arc-diagram.md +151 -0
  343. package/extended/examples/docs-demos/horizontal-partition-chart.md +335 -0
  344. package/extended/examples/docs-demos/horizontal-pictorial-stacked-series.md +96 -0
  345. package/extended/examples/docs-demos/horizontal-tree-chart.md +150 -0
  346. package/extended/examples/docs-demos/html-labels-on-a-dateaxis.md +175 -0
  347. package/extended/examples/docs-demos/html-tooltips-2.md +138 -0
  348. package/extended/examples/docs-demos/html-tooltips.md +139 -0
  349. package/extended/examples/docs-demos/image-patterns.md +144 -0
  350. package/extended/examples/docs-demos/images-as-legend-markers-2.md +210 -0
  351. package/extended/examples/docs-demos/images-as-legend-markers.md +215 -0
  352. package/extended/examples/docs-demos/including-legend-from-external-container-into-export.md +175 -0
  353. package/extended/examples/docs-demos/json-config-with-an-opening-animation.md +128 -0
  354. package/extended/examples/docs-demos/keyboard-controllable-xy-cursor.md +173 -0
  355. package/extended/examples/docs-demos/legend-with-column-series-data-items.md +134 -0
  356. package/extended/examples/docs-demos/legend-with-custom-data.md +149 -0
  357. package/extended/examples/docs-demos/line-series-with-bullets-2.md +166 -0
  358. package/extended/examples/docs-demos/line-series-with-bullets.md +161 -0
  359. package/extended/examples/docs-demos/line-series-with-focusable-bullets.md +164 -0
  360. package/extended/examples/docs-demos/lineseries-strokefill-settings-via-json-config.md +232 -0
  361. package/extended/examples/docs-demos/lineseries-with-breaks.md +127 -0
  362. package/extended/examples/docs-demos/lineseries-with-open-data-fields.md +132 -0
  363. package/extended/examples/docs-demos/map-chart-heat-map-with-heat-legend.md +170 -0
  364. package/extended/examples/docs-demos/map-chart-heat-map.md +138 -0
  365. package/extended/examples/docs-demos/map-chart-with-orthographic-projection-globe.md +86 -0
  366. package/extended/examples/docs-demos/map-chart.md +77 -0
  367. package/extended/examples/docs-demos/map-line-and-point-series-used-together-2.md +115 -0
  368. package/extended/examples/docs-demos/map-line-and-point-series-used-together.md +105 -0
  369. package/extended/examples/docs-demos/map-line-pushing-data-items.md +90 -0
  370. package/extended/examples/docs-demos/map-point-series-creating-individual-data-items-2.md +103 -0
  371. package/extended/examples/docs-demos/map-point-series-creating-individual-data-items-3.md +88 -0
  372. package/extended/examples/docs-demos/map-point-series-creating-individual-data-items.md +86 -0
  373. package/extended/examples/docs-demos/map-point-series-with-data-and-datafields.md +102 -0
  374. package/extended/examples/docs-demos/map-point-series-with-data.md +105 -0
  375. package/extended/examples/docs-demos/map-point-series-with-geojson.md +128 -0
  376. package/extended/examples/docs-demos/map-sankey-chart-global-coffee-supply-chain.md +417 -0
  377. package/extended/examples/docs-demos/map-with-clustered-points.md +335 -0
  378. package/extended/examples/docs-demos/map-with-graticule-series.md +93 -0
  379. package/extended/examples/docs-demos/map-with-line-series-via-data.md +92 -0
  380. package/extended/examples/docs-demos/map-with-line-series.md +103 -0
  381. package/extended/examples/docs-demos/marker-moving-along-a-route.md +139 -0
  382. package/extended/examples/docs-demos/modal-popups-in-amcharts-5.md +214 -0
  383. package/extended/examples/docs-demos/modifying-active-state-on-pie-slices.md +90 -0
  384. package/extended/examples/docs-demos/modifying-chart-for-export.md +188 -0
  385. package/extended/examples/docs-demos/modifying-state-animation-options.md +131 -0
  386. package/extended/examples/docs-demos/multi-panel-stock-chart.md +261 -0
  387. package/extended/examples/docs-demos/multi-part-gauge.md +183 -0
  388. package/extended/examples/docs-demos/multiple-pie-series.md +125 -0
  389. package/extended/examples/docs-demos/multiple-root-elements.md +124 -0
  390. package/extended/examples/docs-demos/open-an-url-on-force-directed-node-click.md +653 -0
  391. package/extended/examples/docs-demos/opening-animation-with-autoappear.md +109 -0
  392. package/extended/examples/docs-demos/pack-chart.md +342 -0
  393. package/extended/examples/docs-demos/partition-chart.md +255 -0
  394. package/extended/examples/docs-demos/patterns.md +143 -0
  395. package/extended/examples/docs-demos/pdf-export-with-korean-characters-in-data.md +119 -0
  396. package/extended/examples/docs-demos/pictorial-stacked-series.md +95 -0
  397. package/extended/examples/docs-demos/pie-chart-legend-alignment-2.md +116 -0
  398. package/extended/examples/docs-demos/pie-chart-legend-alignment.md +112 -0
  399. package/extended/examples/docs-demos/pie-chart-with-a-custom-mask.md +96 -0
  400. package/extended/examples/docs-demos/pie-chart-with-custom-legend.md +127 -0
  401. package/extended/examples/docs-demos/pie-chart-with-external-horizontally-scrollable-legend.md +182 -0
  402. package/extended/examples/docs-demos/pie-chart-with-external-legend-2.md +173 -0
  403. package/extended/examples/docs-demos/pie-chart-with-external-legend.md +161 -0
  404. package/extended/examples/docs-demos/pie-chart-with-gradient-fill-and-grain-pattern.md +96 -0
  405. package/extended/examples/docs-demos/pie-chart-with-inner-radius-donut.md +89 -0
  406. package/extended/examples/docs-demos/pie-chart-with-radial-gradient.md +113 -0
  407. package/extended/examples/docs-demos/pie-chart-with-scrollable-legend.md +141 -0
  408. package/extended/examples/docs-demos/pie-chart.md +95 -0
  409. package/extended/examples/docs-demos/piechart-from-json-config.md +144 -0
  410. package/extended/examples/docs-demos/pieseries-slice-colors-via-data.md +113 -0
  411. package/extended/examples/docs-demos/pixel-shapes.md +107 -0
  412. package/extended/examples/docs-demos/positioning-series-bullets-by-data-field.md +184 -0
  413. package/extended/examples/docs-demos/pre-hidden-nodes-in-sankey.md +95 -0
  414. package/extended/examples/docs-demos/pre-hiding-series.md +181 -0
  415. package/extended/examples/docs-demos/pre-zoom-the-map-to-a-list-of-countries.md +86 -0
  416. package/extended/examples/docs-demos/pre-zooming-date-axis.md +159 -0
  417. package/extended/examples/docs-demos/profesional-candlesticks.md +206 -0
  418. package/extended/examples/docs-demos/radar-chart-axis-labels-2.md +205 -0
  419. package/extended/examples/docs-demos/radar-chart-axis-labels.md +210 -0
  420. package/extended/examples/docs-demos/radar-chart-with-custom-angles.md +210 -0
  421. package/extended/examples/docs-demos/radar-chart-with-date-axis.md +222 -0
  422. package/extended/examples/docs-demos/radar-chart-with-heat-legend.md +1077 -0
  423. package/extended/examples/docs-demos/radial-labels.md +102 -0
  424. package/extended/examples/docs-demos/removing-axes.md +196 -0
  425. package/extended/examples/docs-demos/removing-nodes-from-a-force-directed-tree-2.md +671 -0
  426. package/extended/examples/docs-demos/removing-nodes-from-a-force-directed-tree.md +654 -0
  427. package/extended/examples/docs-demos/resizing-exported-chart.md +191 -0
  428. package/extended/examples/docs-demos/retrieving-latlong-coordinates-of-a-map-click.md +81 -0
  429. package/extended/examples/docs-demos/right-to-left-chart.md +98 -0
  430. package/extended/examples/docs-demos/rotated-axis-labels.md +157 -0
  431. package/extended/examples/docs-demos/round-voronoi-treemap.md +1554 -0
  432. package/extended/examples/docs-demos/sankey-diagram-2.md +95 -0
  433. package/extended/examples/docs-demos/sankey-diagram-with-animated-bullets.md +118 -0
  434. package/extended/examples/docs-demos/sankey-diagram-with-bullets-2.md +108 -0
  435. package/extended/examples/docs-demos/sankey-diagram-with-bullets.md +103 -0
  436. package/extended/examples/docs-demos/sankey-diagram-with-labels-inside-node.md +97 -0
  437. package/extended/examples/docs-demos/sankey-diagram.md +78 -0
  438. package/extended/examples/docs-demos/satellite-globe.md +108 -0
  439. package/extended/examples/docs-demos/satellites-at-different-heights.md +138 -0
  440. package/extended/examples/docs-demos/scrollbar-with-chart-preview-2.md +171 -0
  441. package/extended/examples/docs-demos/scrollbar-with-chart-preview.md +188 -0
  442. package/extended/examples/docs-demos/selectively-displaying-bullets.md +183 -0
  443. package/extended/examples/docs-demos/series-tooltips-and-cursor.md +151 -0
  444. package/extended/examples/docs-demos/setting-xycursor-position.md +214 -0
  445. package/extended/examples/docs-demos/sizing-gradient-based-on-charts-plot-area.md +133 -0
  446. package/extended/examples/docs-demos/sizing-scrollbar-elements.md +176 -0
  447. package/extended/examples/docs-demos/slice-grouper-with-breakdown-of-the-other-slice-in-a-tooltip.md +154 -0
  448. package/extended/examples/docs-demos/slice-grouper-with-pie-series.md +133 -0
  449. package/extended/examples/docs-demos/sliced-chart-with-multiple-series.md +102 -0
  450. package/extended/examples/docs-demos/smoothed-line-series-2.md +183 -0
  451. package/extended/examples/docs-demos/smoothed-line-series.md +152 -0
  452. package/extended/examples/docs-demos/spectrum-chart.md +269 -0
  453. package/extended/examples/docs-demos/stacked-axes-legend.md +168 -0
  454. package/extended/examples/docs-demos/stacked-axes.md +159 -0
  455. package/extended/examples/docs-demos/stacked-bullets.md +278 -0
  456. package/extended/examples/docs-demos/stacked-column-chart-100.md +124 -0
  457. package/extended/examples/docs-demos/stacked-column-chart.md +114 -0
  458. package/extended/examples/docs-demos/start-and-end-angles-of-a-pie-chart.md +91 -0
  459. package/extended/examples/docs-demos/state-abbreviations-on-a-us-map.md +109 -0
  460. package/extended/examples/docs-demos/step-line-chart.md +198 -0
  461. package/extended/examples/docs-demos/steplineseries-with-no-risers-2.md +129 -0
  462. package/extended/examples/docs-demos/steplineseries-with-no-risers.md +127 -0
  463. package/extended/examples/docs-demos/sticky-tooltips-on-bullets.md +159 -0
  464. package/extended/examples/docs-demos/sticky-tooltips-on-columns.md +133 -0
  465. package/extended/examples/docs-demos/stock-chart-2.md +678 -0
  466. package/extended/examples/docs-demos/stock-chart-controls-series-type-control.md +345 -0
  467. package/extended/examples/docs-demos/stock-chart-controls.md +250 -0
  468. package/extended/examples/docs-demos/stock-chart-with-comparison-and-dynamic-search.md +395 -0
  469. package/extended/examples/docs-demos/stock-chart-with-comparison.md +366 -0
  470. package/extended/examples/docs-demos/stock-chart-with-custom-dropdown-control-2.md +317 -0
  471. package/extended/examples/docs-demos/stock-chart-with-custom-dropdown-control.md +254 -0
  472. package/extended/examples/docs-demos/stock-chart-with-custom-settings-control.md +287 -0
  473. package/extended/examples/docs-demos/stock-chart-with-custom-translation.md +677 -0
  474. package/extended/examples/docs-demos/stock-chart-with-data-granularity-switcher.md +407 -0
  475. package/extended/examples/docs-demos/stock-chart-with-dateperiod-selector.md +254 -0
  476. package/extended/examples/docs-demos/stock-chart-with-disabled-settings-icon-for-single-series.md +566 -0
  477. package/extended/examples/docs-demos/stock-chart-with-indicator-control.md +250 -0
  478. package/extended/examples/docs-demos/stock-chart-with-serialized-drawings-and-indicators.md +2283 -0
  479. package/extended/examples/docs-demos/stock-chart-with-series-type-control.md +323 -0
  480. package/extended/examples/docs-demos/stock-chart-with-settings-and-close-buttons-disabled-in-the.md +568 -0
  481. package/extended/examples/docs-demos/stock-chart.md +726 -0
  482. package/extended/examples/docs-demos/strip-count-plot.md +266 -0
  483. package/extended/examples/docs-demos/styling-columnseries.md +124 -0
  484. package/extended/examples/docs-demos/sunburst-chart-2.md +342 -0
  485. package/extended/examples/docs-demos/sunburst-chart-with-custom-startend-angles.md +345 -0
  486. package/extended/examples/docs-demos/sunburst-chart-with-inner-radius.md +343 -0
  487. package/extended/examples/docs-demos/sunburst-chart.md +336 -0
  488. package/extended/examples/docs-demos/surface-bullets-on-a-globe.md +122 -0
  489. package/extended/examples/docs-demos/svg-path-converter-to-points.md +166 -0
  490. package/extended/examples/docs-demos/svg-path-patterns.md +155 -0
  491. package/extended/examples/docs-demos/synced-value-axes.md +151 -0
  492. package/extended/examples/docs-demos/syncing-axis-widths-across-multiple-charts.md +188 -0
  493. package/extended/examples/docs-demos/syncing-cursors-across-several-charts.md +182 -0
  494. package/extended/examples/docs-demos/timeline-chart-serpentine.md +387 -0
  495. package/extended/examples/docs-demos/timeline-chart-spiral.md +385 -0
  496. package/extended/examples/docs-demos/timeline-chart.md +222 -0
  497. package/extended/examples/docs-demos/tooltip-orientation.md +144 -0
  498. package/extended/examples/docs-demos/tooltip-position.md +135 -0
  499. package/extended/examples/docs-demos/tooltip-shadows.md +249 -0
  500. package/extended/examples/docs-demos/tooltips-on-axis-labels.md +200 -0
  501. package/extended/examples/docs-demos/tracking-xycursor-position.md +161 -0
  502. package/extended/examples/docs-demos/tree-chart-configuring-node-outer-circles.md +161 -0
  503. package/extended/examples/docs-demos/tree-chart-configuring-node-radii-2.md +166 -0
  504. package/extended/examples/docs-demos/tree-chart-configuring-node-radii-3.md +151 -0
  505. package/extended/examples/docs-demos/tree-chart-configuring-node-radii.md +157 -0
  506. package/extended/examples/docs-demos/tree-chart-with-cross-linked-nodes.md +136 -0
  507. package/extended/examples/docs-demos/tree-chart.md +144 -0
  508. package/extended/examples/docs-demos/treemap-chart-2.md +259 -0
  509. package/extended/examples/docs-demos/treemap-chart-with-heat-rules.md +151 -0
  510. package/extended/examples/docs-demos/treemap-chart.md +343 -0
  511. package/extended/examples/docs-demos/treemap-parent-headers.md +140 -0
  512. package/extended/examples/docs-demos/treemap-using-adapters-for-rectangle-fills.md +124 -0
  513. package/extended/examples/docs-demos/turning-off-label-alignment.md +100 -0
  514. package/extended/examples/docs-demos/updating-series-values.md +119 -0
  515. package/extended/examples/docs-demos/us-map-with-state-grouped-clustered-points.md +3252 -0
  516. package/extended/examples/docs-demos/using-d3-curve-factories.md +223 -0
  517. package/extended/examples/docs-demos/using-d3-map-projections.md +247 -0
  518. package/extended/examples/docs-demos/using-ellipses-as-nodes-in-force-directed-tree.md +684 -0
  519. package/extended/examples/docs-demos/using-exporting-api-2.md +150 -0
  520. package/extended/examples/docs-demos/using-exporting-api.md +148 -0
  521. package/extended/examples/docs-demos/using-graphics-elements-2.md +73 -0
  522. package/extended/examples/docs-demos/using-graphics-elements-3.md +73 -0
  523. package/extended/examples/docs-demos/using-graphics-elements.md +69 -0
  524. package/extended/examples/docs-demos/using-interface-colors.md +195 -0
  525. package/extended/examples/docs-demos/using-templatedield-in-mappolygonseries.md +100 -0
  526. package/extended/examples/docs-demos/using-templatefield-in-sankey-diagram.md +118 -0
  527. package/extended/examples/docs-demos/using-templatefield-on-lineseries-troke.md +169 -0
  528. package/extended/examples/docs-demos/using-templatefield-with-bullets.md +186 -0
  529. package/extended/examples/docs-demos/using-templatefield-with-columnseries.md +147 -0
  530. package/extended/examples/docs-demos/value-dependent-coloring-of-columnseries.md +132 -0
  531. package/extended/examples/docs-demos/variable-radius-ranges-on-a-gauge.md +118 -0
  532. package/extended/examples/docs-demos/venn-diagram.md +105 -0
  533. package/extended/examples/docs-demos/vertical-arc-diagram.md +127 -0
  534. package/extended/examples/docs-demos/week-start-on-sunday.md +155 -0
  535. package/extended/examples/docs-demos/word-cloud-with-events.md +155 -0
  536. package/extended/examples/docs-demos/word-cloud.md +74 -0
  537. package/extended/examples/docs-demos/xy-scatter-chart-with-heat-rules-on-bullets.md +325 -0
  538. package/extended/examples/docs-demos/xychart-from-json-config-with-axis-bullets.md +228 -0
  539. package/extended/examples/docs-demos/xychart-from-json-config-with-axis-ranges.md +257 -0
  540. package/extended/examples/docs-demos/xychart-from-json-config.md +196 -0
  541. package/extended/examples/docs-demos/xychart-with-legend-via-json-config.md +260 -0
  542. package/extended/examples/docs-demos/zoom-to-a-clicked-country.md +97 -0
  543. package/extended/examples/docs-demos/zoomable-force-directed-tree.md +660 -0
  544. package/extended/examples/docs-demos/zoomable-value-axes.md +188 -0
  545. package/extended/examples/docs-demos/zooming-by-axis-pan.md +1880 -0
  546. package/extended/examples/docs-demos/zooming-map-with-ctrl-key-and-mouse-wheel-curtain.md +122 -0
  547. package/extended/examples/docs-demos/zooming-map-with-ctrl-key-and-mouse-wheel.md +88 -0
  548. package/extended/examples/docs-demos/zooming-with-ctrl-key-and-mouse-wheel-curtain.md +221 -0
  549. package/extended/examples/docs-demos/zooming-with-ctrl-key-and-mouse-wheel.md +183 -0
  550. package/extended/examples/flow/animated-sankey-diagram.md +32 -8
  551. package/extended/examples/flow/chord-diagram-with-animated-bullets.md +6 -4
  552. package/extended/examples/flow/chord-diagram.md +6 -4
  553. package/extended/examples/flow/horizontal-arc-diagram.md +6 -4
  554. package/extended/examples/flow/non-ribbon-chord-diagram.md +6 -4
  555. package/extended/examples/flow/sankey-diagram.md +6 -4
  556. package/extended/examples/flow/toggleable-chord-diagram.md +6 -4
  557. package/extended/examples/flow/traceable-sankey-diagram.md +7 -5
  558. package/extended/examples/flow/vertical-arc-diagram.md +7 -7
  559. package/extended/examples/flow/vertical-sankey-diagram.md +6 -4
  560. package/extended/examples/funnel-pyramid/funnel-chart-with-rounded-corners.md +6 -4
  561. package/extended/examples/funnel-pyramid/funnel-chart.md +6 -4
  562. package/extended/examples/funnel-pyramid/funnel-with-gradient-fill.md +6 -4
  563. package/extended/examples/funnel-pyramid/horizontal-funnel.md +6 -4
  564. package/extended/examples/funnel-pyramid/horizontal-pictorial-chart.md +11 -6
  565. package/extended/examples/funnel-pyramid/pictorial-chart.md +6 -4
  566. package/extended/examples/funnel-pyramid/pictorial-fraction-chart.md +6 -4
  567. package/extended/examples/funnel-pyramid/pictorial-stacked-chart.md +6 -4
  568. package/extended/examples/funnel-pyramid/pyramid-chart.md +6 -4
  569. package/extended/examples/gantt/editable-multilevel-gantt-chart.md +5 -3
  570. package/extended/examples/gantt/gantt-chart-dates.md +5 -3
  571. package/extended/examples/gantt/gantt-chart-in-read-only-mode.md +5 -3
  572. package/extended/examples/gantt/gantt-chart-playground.md +5 -3
  573. package/extended/examples/gantt/gantt-chart.md +5 -3
  574. package/extended/examples/gantt/gantt-with-hundreds-of-items.md +5 -3
  575. package/extended/examples/gauges/angular-gauge-with-two-axes.md +6 -4
  576. package/extended/examples/gauges/angular-gauge.md +6 -4
  577. package/extended/examples/gauges/animated-gauge.md +6 -4
  578. package/extended/examples/gauges/clock-with-two-faces.md +6 -4
  579. package/extended/examples/gauges/clock.md +6 -4
  580. package/extended/examples/gauges/compass-chart.md +6 -4
  581. package/extended/examples/gauges/gauge-with-bands.md +7 -4
  582. package/extended/examples/gauges/gauge-with-gradient-fill.md +6 -4
  583. package/extended/examples/gauges/multi-part-gauge.md +6 -4
  584. package/extended/examples/gauges/solid-gauge.md +6 -4
  585. package/extended/examples/gauges/yes-and-no-gauge.md +6 -4
  586. package/extended/examples/hierarchy/collapsible-force-directed-tree.md +6 -4
  587. package/extended/examples/hierarchy/drill-down-sunburst-chart.md +6 -4
  588. package/extended/examples/hierarchy/drill-down-treemap.md +6 -4
  589. package/extended/examples/hierarchy/dynamic-data-updates-on-treemap.md +6 -4
  590. package/extended/examples/hierarchy/force-directed-adding-links.md +6 -4
  591. package/extended/examples/hierarchy/force-directed-network.md +6 -4
  592. package/extended/examples/hierarchy/force-directed-tree-with-animated-bullets.md +6 -4
  593. package/extended/examples/hierarchy/force-directed-tree.md +6 -4
  594. package/extended/examples/hierarchy/horizontal-partition-chart.md +6 -4
  595. package/extended/examples/hierarchy/multilevel-tree-map.md +6 -4
  596. package/extended/examples/hierarchy/packed-circle-chart.md +6 -4
  597. package/extended/examples/hierarchy/rectangular-voronoi-tree-map.md +7 -5
  598. package/extended/examples/hierarchy/simple-treemap.md +6 -4
  599. package/extended/examples/hierarchy/single-level-packed-circles.md +6 -4
  600. package/extended/examples/hierarchy/sunburst-chart.md +6 -4
  601. package/extended/examples/hierarchy/sunburst-flavor-wheel.md +6 -4
  602. package/extended/examples/hierarchy/tree-chart.md +7 -5
  603. package/extended/examples/hierarchy/vertical-partition-chart.md +6 -4
  604. package/extended/examples/hierarchy/voronoi-treemap.md +7 -5
  605. package/extended/examples/hierarchy/zoomable-force-directed-tree.md +6 -4
  606. package/extended/examples/line-area/100-stacked-area-chart.md +6 -4
  607. package/extended/examples/line-area/animated-bullet-at-the-end-of-the-series.md +6 -4
  608. package/extended/examples/line-area/area-with-time-based-data.md +6 -4
  609. package/extended/examples/line-area/chart-with-gaps-in-data.md +6 -4
  610. package/extended/examples/line-area/comparing-different-date-values-google-analytics-style.md +6 -4
  611. package/extended/examples/line-area/control-chart.md +6 -4
  612. package/extended/examples/line-area/cpu-and-memory-timeline.md +11 -6
  613. package/extended/examples/line-area/data-grouping-50k-points.md +6 -4
  614. package/extended/examples/line-area/date-axis-with-labels-near-minor-grid-lines.md +6 -4
  615. package/extended/examples/line-area/date-based-data.md +6 -4
  616. package/extended/examples/line-area/date-based-line-chart.md +6 -4
  617. package/extended/examples/line-area/divergent-lines.md +7 -4
  618. package/extended/examples/line-area/draggable-range-with-close-button.md +6 -4
  619. package/extended/examples/line-area/drawing-chart-series-with-mouse-or-touch.md +6 -4
  620. package/extended/examples/line-area/duration-on-value-axis.md +6 -4
  621. package/extended/examples/line-area/error-chart.md +6 -4
  622. package/extended/examples/line-area/evenly-spaced-date-axis.md +6 -4
  623. package/extended/examples/line-area/highlighting-line-chart-series-on-legend-hover.md +11 -16
  624. package/extended/examples/line-area/line-chart-adding-data-every-second.md +6 -4
  625. package/extended/examples/line-area/line-chart-with-horizontal-target.md +6 -4
  626. package/extended/examples/line-area/line-chart-with-range-slider.md +9 -7
  627. package/extended/examples/line-area/line-chart-with-scroll-and-zoom.md +6 -4
  628. package/extended/examples/line-area/line-different-colors-ups-downs.md +6 -4
  629. package/extended/examples/line-area/line-graph.md +6 -4
  630. package/extended/examples/line-area/line-with-changing-color.md +6 -4
  631. package/extended/examples/line-area/line-with-custom-bullets.md +6 -4
  632. package/extended/examples/line-area/line-with-data-labels.md +6 -4
  633. package/extended/examples/line-area/live-data.md +6 -4
  634. package/extended/examples/line-area/live-order-book-depth-chart.md +6 -4
  635. package/extended/examples/line-area/logarithmic-scale.md +6 -4
  636. package/extended/examples/line-area/manipulate-chart-data-with-mouse.md +6 -4
  637. package/extended/examples/line-area/mixed-daily-and-intra-day-chart.md +6 -4
  638. package/extended/examples/line-area/multiple-date-axes.md +6 -4
  639. package/extended/examples/line-area/multiple-value-axes.md +6 -4
  640. package/extended/examples/line-area/no-gap-date-axis.md +6 -4
  641. package/extended/examples/line-area/process-control-chart.md +7 -5
  642. package/extended/examples/line-area/range-area-chart.md +6 -4
  643. package/extended/examples/line-area/range-chart-with-different-fill-colors.md +6 -4
  644. package/extended/examples/line-area/reversed-value-axis.md +6 -4
  645. package/extended/examples/line-area/selecting-and-marking-multiple-ranges.md +6 -4
  646. package/extended/examples/line-area/show-percentage-change.md +6 -4
  647. package/extended/examples/line-area/smoothed-line-chart.md +6 -4
  648. package/extended/examples/line-area/smoothed-stacked-area.md +6 -4
  649. package/extended/examples/line-area/spline-graph.md +6 -4
  650. package/extended/examples/line-area/stacked-area.md +6 -4
  651. package/extended/examples/line-area/step-line-chart.md +6 -4
  652. package/extended/examples/line-area/step-line-without-risers.md +6 -4
  653. package/extended/examples/line-area/stream-chart.md +6 -4
  654. package/extended/examples/line-area/trend-lines.md +6 -4
  655. package/extended/examples/line-area/vertical-line-chart.md +14 -13
  656. package/extended/examples/line-area/zoomable-value-axis.md +6 -4
  657. package/extended/examples/maps/animations-along-lines.md +6 -4
  658. package/extended/examples/maps/approximate-working-hours-map.md +6 -4
  659. package/extended/examples/maps/capitals-map.md +7 -5
  660. package/extended/examples/maps/changing-map-projection.md +6 -4
  661. package/extended/examples/maps/day-and-night-world-map.md +118 -24
  662. package/extended/examples/maps/drill-down-congressional-map.md +6 -4
  663. package/extended/examples/maps/drill-down-map.md +6 -4
  664. package/extended/examples/maps/drill-down-to-countries.md +6 -4
  665. package/extended/examples/maps/flight-routes-map.md +6 -4
  666. package/extended/examples/maps/globe-with-projected-circles.md +6 -4
  667. package/extended/examples/maps/globe-with-raised-arcs.md +6 -4
  668. package/extended/examples/maps/globe-with-raised-parallels.md +6 -4
  669. package/extended/examples/maps/globe-with-surface-bullets.md +6 -4
  670. package/extended/examples/maps/grouped-countries-map.md +6 -4
  671. package/extended/examples/maps/jupiter-and-its-moons.md +6 -4
  672. package/extended/examples/maps/location-sensitive-map.md +6 -4
  673. package/extended/examples/maps/london-traffic-map.md +235 -0
  674. package/extended/examples/maps/map-bubbles.md +6 -4
  675. package/extended/examples/maps/map-dynamic-pie-charts.md +6 -4
  676. package/extended/examples/maps/map-image-drill-down.md +6 -4
  677. package/extended/examples/maps/map-sankey-series.md +3 -2
  678. package/extended/examples/maps/map-timeline.md +6 -4
  679. package/extended/examples/maps/map-using-d3-projections.md +14 -5
  680. package/extended/examples/maps/map-with-animated-bubbles.md +6 -4
  681. package/extended/examples/maps/map-with-animated-lines.md +6 -4
  682. package/extended/examples/maps/map-with-curved-lines.md +6 -4
  683. package/extended/examples/maps/map-with-patterns.md +10 -6
  684. package/extended/examples/maps/map-with-pulsating-bullets.md +6 -4
  685. package/extended/examples/maps/map-with-sized-pin-bullets.md +6 -4
  686. package/extended/examples/maps/mars-landing-sites.md +6 -4
  687. package/extended/examples/maps/multi-series-map.md +6 -4
  688. package/extended/examples/maps/pacific-centered-map.md +6 -4
  689. package/extended/examples/maps/pixel-map.md +6 -4
  690. package/extended/examples/maps/rotate-globe-to-a-selected-country.md +208 -110
  691. package/extended/examples/maps/rotating-globe-with-circles.md +6 -4
  692. package/extended/examples/maps/rotating-globe.md +115 -25
  693. package/extended/examples/maps/rotating-moon.md +6 -4
  694. package/extended/examples/maps/sankey-map-with-waypoints.md +6 -4
  695. package/extended/examples/maps/satellite-image-globe.md +18 -4
  696. package/extended/examples/maps/saturn-and-its-rings.md +6 -4
  697. package/extended/examples/maps/selecting-multiple-areas-map.md +6 -4
  698. package/extended/examples/maps/solar-eclipse-map.md +6 -4
  699. package/extended/examples/maps/star-atlas.md +6 -4
  700. package/extended/examples/maps/trumps-reciprocal-tariffs-map.md +6 -4
  701. package/extended/examples/maps/us-congressional-districts.md +6 -4
  702. package/extended/examples/maps/us-heat-map.md +6 -4
  703. package/extended/examples/maps/weather-map.md +13 -11
  704. package/extended/examples/maps/world-map-with-clustered-points.md +6 -4
  705. package/extended/examples/maps/world-time-zone-map.md +6 -4
  706. package/extended/examples/maps/zooming-to-countries-map.md +6 -4
  707. package/extended/examples/miscellaneous/angled-word-cloud.md +6 -4
  708. package/extended/examples/miscellaneous/annotating-charts.md +6 -4
  709. package/extended/examples/miscellaneous/changing-data-word-cloud.md +6 -4
  710. package/extended/examples/miscellaneous/combined-bullet-column-line-chart.md +6 -4
  711. package/extended/examples/miscellaneous/complex-venn-diagram.md +6 -4
  712. package/extended/examples/miscellaneous/exporting-chart-to-image.md +6 -4
  713. package/extended/examples/miscellaneous/forest-plot.md +6 -4
  714. package/extended/examples/miscellaneous/historical-population-pyramid.md +6 -4
  715. package/extended/examples/miscellaneous/honeycomb-tile-map.md +6 -4
  716. package/extended/examples/miscellaneous/horizontally-stacked-axes.md +6 -4
  717. package/extended/examples/miscellaneous/hybrid-drill-down-pie-bar-chart.md +21 -4
  718. package/extended/examples/miscellaneous/infographic.md +6 -4
  719. package/extended/examples/miscellaneous/mekko.md +6 -4
  720. package/extended/examples/miscellaneous/micro-charts-sparklines.md +5 -5
  721. package/extended/examples/miscellaneous/pictogram.md +6 -4
  722. package/extended/examples/miscellaneous/population-pyramid.md +6 -4
  723. package/extended/examples/miscellaneous/progress-chart.md +6 -4
  724. package/extended/examples/miscellaneous/range-bullet-chart.md +6 -4
  725. package/extended/examples/miscellaneous/sentence-cloud.md +6 -4
  726. package/extended/examples/miscellaneous/shaped-word-cloud.md +7 -4
  727. package/extended/examples/miscellaneous/spectrum-chart.md +6 -4
  728. package/extended/examples/miscellaneous/strip-plot.md +6 -4
  729. package/extended/examples/miscellaneous/tag-cloud.md +6 -4
  730. package/extended/examples/miscellaneous/tile-map.md +6 -4
  731. package/extended/examples/miscellaneous/venn-diagram-with-patterns.md +6 -4
  732. package/extended/examples/miscellaneous/venn-diagram.md +6 -4
  733. package/extended/examples/miscellaneous/vertically-stacked-axes-chart.md +6 -4
  734. package/extended/examples/miscellaneous/violin-chart.md +6 -4
  735. package/extended/examples/miscellaneous/word-cloud.md +6 -4
  736. package/extended/examples/pie-donut/animated-time-line-pie-chart.md +6 -4
  737. package/extended/examples/pie-donut/donut-chart.md +6 -4
  738. package/extended/examples/pie-donut/donut-with-radial-gradient.md +6 -4
  739. package/extended/examples/pie-donut/dragging-pie-slices.md +6 -4
  740. package/extended/examples/pie-donut/grained-gradient-pie.md +6 -4
  741. package/extended/examples/pie-donut/nested-donut-chart.md +6 -4
  742. package/extended/examples/pie-donut/pie-chart-broken-slices.md +6 -4
  743. package/extended/examples/pie-donut/pie-chart-with-legend.md +6 -4
  744. package/extended/examples/pie-donut/pie-chart.md +6 -4
  745. package/extended/examples/pie-donut/pie-of-a-pie.md +6 -4
  746. package/extended/examples/pie-donut/semi-circle-pie-chart.md +6 -4
  747. package/extended/examples/pie-donut/simple-pie-chart.md +6 -4
  748. package/extended/examples/pie-donut/two-level-pie-chart.md +6 -4
  749. package/extended/examples/pie-donut/two-pie-charts-with-single-legend.md +6 -4
  750. package/extended/examples/pie-donut/variable-radius-nested-donut-chart.md +6 -4
  751. package/extended/examples/pie-donut/variable-radius-nested-pie.md +6 -4
  752. package/extended/examples/pie-donut/variable-radius-pie-chart.md +6 -4
  753. package/extended/examples/radar-polar/flower-chart.md +6 -4
  754. package/extended/examples/radar-polar/live-sorting-of-radar-columns.md +6 -4
  755. package/extended/examples/radar-polar/polar-area-chart.md +6 -4
  756. package/extended/examples/radar-polar/polar-chart.md +6 -4
  757. package/extended/examples/radar-polar/polar-scatter.md +6 -4
  758. package/extended/examples/radar-polar/radar-chart-visualizing-yearly-activities.md +16 -4
  759. package/extended/examples/radar-polar/radar-chart.md +6 -4
  760. package/extended/examples/radar-polar/radar-heat-map.md +6 -4
  761. package/extended/examples/radar-polar/radar-timeline.md +7 -4
  762. package/extended/examples/radar-polar/radar-with-date-axis.md +6 -4
  763. package/extended/examples/radar-polar/radial-bar-chart.md +6 -4
  764. package/extended/examples/radar-polar/radial-histogram.md +6 -4
  765. package/extended/examples/radar-polar/radial-line-graph.md +10 -6
  766. package/extended/examples/radar-polar/radial-ridgeline-chart.md +8 -4
  767. package/extended/examples/radar-polar/stacked-area-radar.md +6 -4
  768. package/extended/examples/radar-polar/variable-radius-radar.md +6 -4
  769. package/extended/examples/radar-polar/wheel-of-life.md +6 -4
  770. package/extended/examples/radar-polar/zoomable-radar.md +6 -4
  771. package/extended/examples/stock/changing-data-granularity.md +4 -4
  772. package/extended/examples/stock/live-stock-data.md +4 -4
  773. package/extended/examples/stock/separate-volume-panel.md +4 -4
  774. package/extended/examples/stock/stock-chart-comparing-prices.md +4 -4
  775. package/extended/examples/stock/stock-chart-with-bollinger-bands-indicator.md +4 -4
  776. package/extended/examples/stock/stock-chart-with-relative-strength-index.md +4 -4
  777. package/extended/examples/stock/stock-chart-with-volume-profile.md +4 -4
  778. package/extended/examples/stock/stock-chart.md +4 -4
  779. package/extended/examples/stock/stock-data-grouping.md +4 -4
  780. package/extended/examples/stock/stock-intraday-data.md +4 -4
  781. package/extended/examples/timeline/horizontal-serpentine-timeline.md +6 -4
  782. package/extended/examples/timeline/infinity-timeline.md +6 -4
  783. package/extended/examples/timeline/linear-process-diagram.md +19 -5
  784. package/extended/examples/timeline/serpentine-timeline-chart.md +6 -4
  785. package/extended/examples/timeline/spiral-timeline.md +6 -4
  786. package/extended/examples/timeline/stadium-track-chart.md +6 -4
  787. package/extended/examples/xy-bubble/animated-xy-bubble-timeline-chart.md +6 -4
  788. package/extended/examples/xy-bubble/beeswarm.md +6 -4
  789. package/extended/examples/xy-bubble/bubble-based-heat-map.md +6 -4
  790. package/extended/examples/xy-bubble/bubble-chart-with-pie-bullets.md +6 -4
  791. package/extended/examples/xy-bubble/bubble-chart.md +6 -4
  792. package/extended/examples/xy-bubble/irregular-interval-xy.md +6 -4
  793. package/extended/examples/xy-bubble/motion-chart.md +7 -5
  794. package/extended/examples/xy-bubble/scatter-chart.md +6 -4
  795. package/extended/examples/xy-bubble/scatter-plot-with-tens-of-thousands-points.md +6 -4
  796. package/extended/examples/xy-bubble/xy-chart-date-based-axis.md +6 -4
  797. package/extended/examples/xy-bubble/xy-chart-fills-axis.md +6 -4
  798. package/extended/examples/xy-bubble/xy-chart-value-based-line-graphs.md +6 -4
  799. package/extended/examples/xy-bubble/xy-error-chart.md +6 -4
  800. package/extended/examples/xy-bubble/zoomable-bubble-chart.md +6 -4
  801. package/extended/getting-started/integrations/am5-chart-element.md +212 -22
  802. package/extended/getting-started/integrations/cypress.md +14 -12
  803. package/extended/getting-started/integrations/ember-js.md +29 -30
  804. package/extended/getting-started/integrations/jest.md +8 -6
  805. package/extended/getting-started/integrations/next-js.md +11 -5
  806. package/extended/getting-started/integrations/nuxt.md +24 -4
  807. package/extended/getting-started/integrations/react.md +2 -4
  808. package/extended/getting-started/integrations/remix-3.md +8 -6
  809. package/extended/getting-started/integrations/remix.md +14 -6
  810. package/extended/getting-started/integrations.md +9 -9
  811. package/extended/getting-started/root-element.md +5 -572
  812. package/extended/migrating-from-amcharts-4.md +14 -19
  813. package/extended/reference/accelerationbands.md +15 -0
  814. package/extended/reference/accumulationdistribution.md +11 -0
  815. package/extended/reference/accumulativeswingindex.md +11 -0
  816. package/extended/reference/adapters.md +7 -0
  817. package/extended/reference/animatedtheme.md +6 -0
  818. package/extended/reference/animation.md +7 -0
  819. package/extended/reference/animationtime.md +6 -0
  820. package/extended/reference/annotator.md +16 -0
  821. package/extended/reference/arc.md +5 -0
  822. package/extended/reference/arcdiagram.md +12 -0
  823. package/extended/reference/arcdiagramlink.md +12 -0
  824. package/extended/reference/arcdiagramnodes.md +12 -0
  825. package/extended/reference/arcto.md +10 -0
  826. package/extended/reference/aroon.md +11 -0
  827. package/extended/reference/arraydisposer.md +6 -0
  828. package/extended/reference/averageseries.md +14 -0
  829. package/extended/reference/averagetruerange.md +11 -0
  830. package/extended/reference/awesomeoscillator.md +11 -0
  831. package/extended/reference/axis.md +22 -0
  832. package/extended/reference/axisbullet.md +7 -0
  833. package/extended/reference/axislabel.md +10 -0
  834. package/extended/reference/axislabelradial.md +11 -0
  835. package/extended/reference/axisrenderer.md +14 -0
  836. package/extended/reference/axisrenderercircular.md +15 -0
  837. package/extended/reference/axisrenderercurvex.md +19 -0
  838. package/extended/reference/axisrenderercurvey.md +15 -0
  839. package/extended/reference/axisrendererradial.md +14 -0
  840. package/extended/reference/axisrendererx.md +13 -0
  841. package/extended/reference/axisrenderery.md +13 -0
  842. package/extended/reference/axistick.md +8 -0
  843. package/extended/reference/basecolumnseries.md +18 -0
  844. package/extended/reference/beginfill.md +6 -0
  845. package/extended/reference/begingroup.md +6 -0
  846. package/extended/reference/beginpath.md +6 -0
  847. package/extended/reference/benchmark.md +5 -0
  848. package/extended/reference/beziercurveto.md +5 -0
  849. package/extended/reference/bollingerbands.md +15 -0
  850. package/extended/reference/breadcrumbbar.md +9 -0
  851. package/extended/reference/bullbearpower.md +11 -0
  852. package/extended/reference/bullet.md +7 -0
  853. package/extended/reference/button.md +9 -0
  854. package/extended/reference/calloutseries.md +15 -0
  855. package/extended/reference/candlestick.md +8 -0
  856. package/extended/reference/candlestickseries.md +13 -0
  857. package/extended/reference/canvaslayer.md +5 -0
  858. package/extended/reference/canvasrenderer.md +31 -0
  859. package/extended/reference/categoryaxis.md +27 -0
  860. package/extended/reference/categorydateaxis.md +17 -0
  861. package/extended/reference/chaikinmoneyflow.md +11 -0
  862. package/extended/reference/chaikinoscillator.md +11 -0
  863. package/extended/reference/chart.md +9 -0
  864. package/extended/reference/chartelement.md +6 -0
  865. package/extended/reference/chartindicator.md +15 -0
  866. package/extended/reference/chartserializer.md +13 -0
  867. package/extended/reference/children.md +11 -0
  868. package/extended/reference/chord.md +12 -0
  869. package/extended/reference/chorddirected.md +12 -0
  870. package/extended/reference/chordlink.md +12 -0
  871. package/extended/reference/chordlinkdirected.md +9 -0
  872. package/extended/reference/chordnodes.md +12 -0
  873. package/extended/reference/chordnonribbon.md +12 -0
  874. package/extended/reference/circle.md +8 -0
  875. package/extended/reference/circlepattern.md +7 -0
  876. package/extended/reference/clockhand.md +9 -0
  877. package/extended/reference/closepath.md +10 -0
  878. package/extended/reference/clusteredpointseries.md +16 -0
  879. package/extended/reference/color.md +23 -7
  880. package/extended/reference/colorblinddarktheme.md +6 -0
  881. package/extended/reference/colorblindtheme.md +6 -0
  882. package/extended/reference/colorcontrol.md +14 -0
  883. package/extended/reference/colorpicker.md +13 -0
  884. package/extended/reference/colorpickerbutton.md +9 -0
  885. package/extended/reference/colorpickerdefaulttheme.md +6 -0
  886. package/extended/reference/colorset.md +13 -0
  887. package/extended/reference/columnseries.md +13 -0
  888. package/extended/reference/commoditychannelindex.md +11 -0
  889. package/extended/reference/comparisoncontrol.md +9 -0
  890. package/extended/reference/component.md +19 -0
  891. package/extended/reference/confirmbutton.md +9 -0
  892. package/extended/reference/container.md +18 -0
  893. package/extended/reference/counterdisposer.md +10 -0
  894. package/extended/reference/counterref.md +5 -0
  895. package/extended/reference/csvparser.md +4 -0
  896. package/extended/reference/curvechart.md +10 -0
  897. package/extended/reference/curvecolumnseries.md +13 -0
  898. package/extended/reference/curvecursor.md +10 -0
  899. package/extended/reference/curvedefaulttheme.md +6 -0
  900. package/extended/reference/curvelineseries.md +12 -0
  901. package/extended/reference/darktheme.md +6 -0
  902. package/extended/reference/dataitem.md +12 -0
  903. package/extended/reference/dataprocessor.md +12 -0
  904. package/extended/reference/datasavecontrol.md +15 -0
  905. package/extended/reference/datavizdarktheme.md +6 -0
  906. package/extended/reference/dataviztheme.md +6 -0
  907. package/extended/reference/dateaxis.md +27 -0
  908. package/extended/reference/dateformatter.md +12 -0
  909. package/extended/reference/daterangeselector.md +8 -0
  910. package/extended/reference/defaulttheme.md +6 -0
  911. package/extended/reference/disparityindex.md +11 -0
  912. package/extended/reference/disposer.md +5 -0
  913. package/extended/reference/disposerclass.md +5 -0
  914. package/extended/reference/doodleseries.md +13 -0
  915. package/extended/reference/drawcircle.md +5 -0
  916. package/extended/reference/drawellipse.md +5 -0
  917. package/extended/reference/drawingcontrol.md +16 -0
  918. package/extended/reference/drawingseries.md +37 -0
  919. package/extended/reference/drawingtoolcontrol.md +12 -0
  920. package/extended/reference/drawrect.md +5 -0
  921. package/extended/reference/dropdown.md +15 -0
  922. package/extended/reference/dropdowncolors.md +12 -0
  923. package/extended/reference/dropdowncontrol.md +8 -0
  924. package/extended/reference/dropdownlist.md +14 -0
  925. package/extended/reference/dropdownlistcontrol.md +14 -0
  926. package/extended/reference/durationaxis.md +16 -0
  927. package/extended/reference/durationformatter.md +15 -0
  928. package/extended/reference/editableaxislabel.md +10 -0
  929. package/extended/reference/editablelabel.md +10 -0
  930. package/extended/reference/ellipse.md +8 -0
  931. package/extended/reference/ellipseseries.md +18 -0
  932. package/extended/reference/embertheme.md +6 -0
  933. package/extended/reference/endfill.md +6 -0
  934. package/extended/reference/endgroup.md +6 -0
  935. package/extended/reference/endstroke.md +6 -0
  936. package/extended/reference/entity.md +14 -0
  937. package/extended/reference/eventdispatcher.md +20 -0
  938. package/extended/reference/exporting.md +35 -0
  939. package/extended/reference/exportingmenu.md +13 -0
  940. package/extended/reference/fibonacciseries.md +14 -0
  941. package/extended/reference/fibonaccitimezoneseries.md +14 -0
  942. package/extended/reference/flow.md +16 -0
  943. package/extended/reference/flowdefaulttheme.md +6 -0
  944. package/extended/reference/flowlink.md +12 -0
  945. package/extended/reference/flownode.md +9 -0
  946. package/extended/reference/flownodes.md +18 -0
  947. package/extended/reference/forcedirected.md +13 -0
  948. package/extended/reference/frozendarktheme.md +6 -0
  949. package/extended/reference/frozentheme.md +6 -0
  950. package/extended/reference/funnelseries.md +17 -0
  951. package/extended/reference/funnelslice.md +12 -0
  952. package/extended/reference/gantt.md +16 -0
  953. package/extended/reference/ganttcategoryaxis.md +30 -0
  954. package/extended/reference/ganttcategoryaxisrenderer.md +9 -0
  955. package/extended/reference/ganttdateaxis.md +13 -0
  956. package/extended/reference/ganttdateaxisrenderer.md +10 -0
  957. package/extended/reference/ganttdefaulttheme.md +6 -0
  958. package/extended/reference/ganttseries.md +28 -0
  959. package/extended/reference/gaplessdateaxis.md +21 -0
  960. package/extended/reference/geometrichittester.md +5 -0
  961. package/extended/reference/ghostlayer.md +8 -0
  962. package/extended/reference/gradient.md +7 -0
  963. package/extended/reference/grainpattern.md +7 -0
  964. package/extended/reference/graphics.md +8 -0
  965. package/extended/reference/graphicsdata.md +27 -0
  966. package/extended/reference/graphicsimage.md +10 -0
  967. package/extended/reference/graticuleseries.md +12 -0
  968. package/extended/reference/grid.md +8 -0
  969. package/extended/reference/gridlayout.md +7 -0
  970. package/extended/reference/heatlegend.md +13 -0
  971. package/extended/reference/heikinashi.md +11 -0
  972. package/extended/reference/hierarchy.md +24 -0
  973. package/extended/reference/hierarchydefaulttheme.md +6 -0
  974. package/extended/reference/hierarchylink.md +13 -0
  975. package/extended/reference/hierarchynode.md +9 -0
  976. package/extended/reference/horizontallayout.md +7 -0
  977. package/extended/reference/horizontallineseries.md +14 -0
  978. package/extended/reference/horizontalrayseries.md +14 -0
  979. package/extended/reference/iconcontrol.md +14 -0
  980. package/extended/reference/iconseries.md +19 -0
  981. package/extended/reference/indicator.md +16 -0
  982. package/extended/reference/indicatorcontrol.md +17 -0
  983. package/extended/reference/interactionmanager.md +12 -0
  984. package/extended/reference/interfacecolors.md +7 -0
  985. package/extended/reference/intervalcontrol.md +9 -0
  986. package/extended/reference/jsondata.md +5 -0
  987. package/extended/reference/jsonparser.md +9 -0
  988. package/extended/reference/kellydarktheme.md +6 -0
  989. package/extended/reference/kellytheme.md +6 -0
  990. package/extended/reference/label.md +14 -0
  991. package/extended/reference/labelboxes.md +5 -0
  992. package/extended/reference/labelfit.md +5 -0
  993. package/extended/reference/labelseries.md +18 -0
  994. package/extended/reference/language.md +18 -0
  995. package/extended/reference/layout.md +7 -0
  996. package/extended/reference/legend.md +11 -0
  997. package/extended/reference/line.md +8 -0
  998. package/extended/reference/lineargradient.md +7 -0
  999. package/extended/reference/lineargradientdef.md +4 -0
  1000. package/extended/reference/linearrowseries.md +18 -0
  1001. package/extended/reference/linedash.md +6 -0
  1002. package/extended/reference/linedashoffset.md +6 -0
  1003. package/extended/reference/linepattern.md +7 -0
  1004. package/extended/reference/lineseries.md +12 -0
  1005. package/extended/reference/linestyle.md +6 -0
  1006. package/extended/reference/lineto.md +5 -0
  1007. package/extended/reference/link.md +9 -0
  1008. package/extended/reference/linkedhierarchy.md +20 -0
  1009. package/extended/reference/linkedhierarchynode.md +9 -0
  1010. package/extended/reference/list.md +23 -0
  1011. package/extended/reference/listautodispose.md +12 -0
  1012. package/extended/reference/listdata.md +6 -0
  1013. package/extended/reference/listtemplate.md +7 -0
  1014. package/extended/reference/macd.md +11 -0
  1015. package/extended/reference/macross.md +10 -0
  1016. package/extended/reference/mapchart.md +27 -0
  1017. package/extended/reference/mapchartdefaulttheme.md +6 -0
  1018. package/extended/reference/mapline.md +13 -0
  1019. package/extended/reference/maplineseries.md +15 -0
  1020. package/extended/reference/mappointseries.md +17 -0
  1021. package/extended/reference/mappolygon.md +13 -0
  1022. package/extended/reference/mappolygonseries.md +19 -0
  1023. package/extended/reference/maprasterseries.md +11 -0
  1024. package/extended/reference/mapsankeynodes.md +11 -0
  1025. package/extended/reference/mapsankeyseries.md +18 -0
  1026. package/extended/reference/mapseries.md +11 -0
  1027. package/extended/reference/materialdarktheme.md +6 -0
  1028. package/extended/reference/materialtheme.md +6 -0
  1029. package/extended/reference/matrix.md +9 -0
  1030. package/extended/reference/measure.md +14 -0
  1031. package/extended/reference/medianprice.md +11 -0
  1032. package/extended/reference/microcharttheme.md +6 -0
  1033. package/extended/reference/midnighttheme.md +6 -0
  1034. package/extended/reference/modal.md +14 -0
  1035. package/extended/reference/momentum.md +11 -0
  1036. package/extended/reference/monotonextension.md +8 -0
  1037. package/extended/reference/monotoneytension.md +8 -0
  1038. package/extended/reference/moonrisedarktheme.md +6 -0
  1039. package/extended/reference/moonrisetheme.md +6 -0
  1040. package/extended/reference/moveto.md +5 -0
  1041. package/extended/reference/movingaverage.md +10 -0
  1042. package/extended/reference/movingaveragedeviation.md +11 -0
  1043. package/extended/reference/movingaverageenvelope.md +15 -0
  1044. package/extended/reference/multidisposer.md +6 -0
  1045. package/extended/reference/mutablevaluedisposer.md +12 -0
  1046. package/extended/reference/nightseries.md +12 -0
  1047. package/extended/reference/norddarktheme.md +6 -0
  1048. package/extended/reference/nordtheme.md +6 -0
  1049. package/extended/reference/numberformatter.md +11 -0
  1050. package/extended/reference/numericstepper.md +9 -0
  1051. package/extended/reference/ohlc.md +8 -0
  1052. package/extended/reference/ohlcseries.md +13 -0
  1053. package/extended/reference/onbalancevolume.md +11 -0
  1054. package/extended/reference/op.md +5 -0
  1055. package/extended/reference/orthogonalline.md +12 -0
  1056. package/extended/reference/overboughtoversold.md +11 -0
  1057. package/extended/reference/pack.md +12 -0
  1058. package/extended/reference/panelcontrols.md +9 -0
  1059. package/extended/reference/parallelchannelseries.md +14 -0
  1060. package/extended/reference/partition.md +12 -0
  1061. package/extended/reference/pasteldarktheme.md +6 -0
  1062. package/extended/reference/pasteltheme.md +6 -0
  1063. package/extended/reference/pathpattern.md +7 -0
  1064. package/extended/reference/pattern.md +7 -0
  1065. package/extended/reference/patternsdarktheme.md +6 -0
  1066. package/extended/reference/patternset.md +16 -0
  1067. package/extended/reference/patternstheme.md +6 -0
  1068. package/extended/reference/percent.md +9 -0
  1069. package/extended/reference/percentchart.md +9 -0
  1070. package/extended/reference/percentdefaulttheme.md +6 -0
  1071. package/extended/reference/percentseries.md +20 -0
  1072. package/extended/reference/periodselector.md +12 -0
  1073. package/extended/reference/petroleumtheme.md +6 -0
  1074. package/extended/reference/pictorialstackedseries.md +13 -0
  1075. package/extended/reference/picture.md +8 -0
  1076. package/extended/reference/picturepattern.md +7 -0
  1077. package/extended/reference/piechart.md +14 -0
  1078. package/extended/reference/pieseries.md +12 -0
  1079. package/extended/reference/pixelmapseries.md +18 -0
  1080. package/extended/reference/pointedrectangle.md +8 -0
  1081. package/extended/reference/polygon.md +8 -0
  1082. package/extended/reference/polylineseries.md +19 -0
  1083. package/extended/reference/progresspie.md +9 -0
  1084. package/extended/reference/pvt.md +11 -0
  1085. package/extended/reference/pyramidseries.md +13 -0
  1086. package/extended/reference/quadrantlineseries.md +14 -0
  1087. package/extended/reference/quadraticcurveto.md +5 -0
  1088. package/extended/reference/radarchart.md +10 -0
  1089. package/extended/reference/radarcolumnseries.md +13 -0
  1090. package/extended/reference/radarcursor.md +10 -0
  1091. package/extended/reference/radardefaulttheme.md +6 -0
  1092. package/extended/reference/radarlineseries.md +12 -0
  1093. package/extended/reference/radialgradient.md +7 -0
  1094. package/extended/reference/radialgradientdef.md +4 -0
  1095. package/extended/reference/radiallabel.md +15 -0
  1096. package/extended/reference/radialtext.md +9 -0
  1097. package/extended/reference/rectangle.md +8 -0
  1098. package/extended/reference/rectanglepattern.md +7 -0
  1099. package/extended/reference/rectangleseries.md +14 -0
  1100. package/extended/reference/regressionseries.md +14 -0
  1101. package/extended/reference/relativestrengthindex.md +11 -0
  1102. package/extended/reference/resetcontrol.md +8 -0
  1103. package/extended/reference/resizesensor.md +5 -0
  1104. package/extended/reference/responsivebasetheme.md +16 -0
  1105. package/extended/reference/responsivemaxtheme.md +12 -0
  1106. package/extended/reference/responsivetheme.md +7 -0
  1107. package/extended/reference/root.md +16 -0
  1108. package/extended/reference/roundedrectangle.md +8 -0
  1109. package/extended/reference/sankey.md +12 -0
  1110. package/extended/reference/sankeylink.md +12 -0
  1111. package/extended/reference/sankeynodes.md +12 -0
  1112. package/extended/reference/savannatheme.md +6 -0
  1113. package/extended/reference/scenecontainer.md +15 -0
  1114. package/extended/reference/scenegraphics.md +33 -0
  1115. package/extended/reference/sceneimage.md +12 -0
  1116. package/extended/reference/scenenode.md +24 -0
  1117. package/extended/reference/sceneradialtext.md +8 -0
  1118. package/extended/reference/scenetext.md +12 -0
  1119. package/extended/reference/scrollbar.md +9 -0
  1120. package/extended/reference/serialchart.md +9 -0
  1121. package/extended/reference/serialchartcontainer.md +9 -0
  1122. package/extended/reference/serializer.md +11 -0
  1123. package/extended/reference/series.md +19 -0
  1124. package/extended/reference/seriestypecontrol.md +9 -0
  1125. package/extended/reference/serpentinechart.md +10 -0
  1126. package/extended/reference/settings.md +22 -0
  1127. package/extended/reference/settingscontrol.md +9 -0
  1128. package/extended/reference/settingsmodal.md +16 -0
  1129. package/extended/reference/shadow.md +6 -0
  1130. package/extended/reference/simplelineseries.md +20 -0
  1131. package/extended/reference/slice.md +8 -0
  1132. package/extended/reference/slicedchart.md +9 -0
  1133. package/extended/reference/slicegrouper.md +11 -0
  1134. package/extended/reference/slider.md +9 -0
  1135. package/extended/reference/smoothedradarlineseries.md +12 -0
  1136. package/extended/reference/smoothedxlineseries.md +12 -0
  1137. package/extended/reference/smoothedxylineseries.md +12 -0
  1138. package/extended/reference/smoothedylineseries.md +12 -0
  1139. package/extended/reference/spiralchart.md +10 -0
  1140. package/extended/reference/spiriteddarktheme.md +6 -0
  1141. package/extended/reference/spiritedtheme.md +6 -0
  1142. package/extended/reference/sprite.md +44 -0
  1143. package/extended/reference/spriteeventdispatcher.md +10 -0
  1144. package/extended/reference/spriteresizer.md +9 -0
  1145. package/extended/reference/standarddeviation.md +11 -0
  1146. package/extended/reference/star.md +8 -0
  1147. package/extended/reference/starpattern.md +7 -0
  1148. package/extended/reference/state.md +9 -0
  1149. package/extended/reference/states.md +8 -0
  1150. package/extended/reference/steplineseries.md +12 -0
  1151. package/extended/reference/stochasticmomentumindex.md +11 -0
  1152. package/extended/reference/stochasticoscillator.md +11 -0
  1153. package/extended/reference/stockchart.md +28 -0
  1154. package/extended/reference/stockchartdefaulttheme.md +6 -0
  1155. package/extended/reference/stockcontrol.md +13 -0
  1156. package/extended/reference/stockicons.md +4 -0
  1157. package/extended/reference/stocklegend.md +11 -0
  1158. package/extended/reference/stockpanel.md +17 -0
  1159. package/extended/reference/stocktoolbar.md +7 -0
  1160. package/extended/reference/stylerule.md +10 -0
  1161. package/extended/reference/stylesheet.md +6 -0
  1162. package/extended/reference/sunburst.md +12 -0
  1163. package/extended/reference/sunclock.md +6 -0
  1164. package/extended/reference/supertrend.md +15 -0
  1165. package/extended/reference/svgdefs.md +7 -0
  1166. package/extended/reference/svgdocument.md +11 -0
  1167. package/extended/reference/svglayer.md +4 -0
  1168. package/extended/reference/svgpathsink.md +13 -0
  1169. package/extended/reference/svgrenderer.md +6 -0
  1170. package/extended/reference/targetedeventdispatcher.md +6 -0
  1171. package/extended/reference/template.md +17 -0
  1172. package/extended/reference/templateadapters.md +5 -0
  1173. package/extended/reference/templatestate.md +7 -0
  1174. package/extended/reference/templatestates.md +6 -0
  1175. package/extended/reference/text.md +15 -0
  1176. package/extended/reference/textformatter.md +4 -0
  1177. package/extended/reference/theme.md +5 -0
  1178. package/extended/reference/throttler.md +4 -0
  1179. package/extended/reference/tick.md +8 -0
  1180. package/extended/reference/timezone.md +6 -0
  1181. package/extended/reference/tooltip.md +13 -0
  1182. package/extended/reference/tree.md +20 -0
  1183. package/extended/reference/treemap.md +12 -0
  1184. package/extended/reference/trendlineseries.md +14 -0
  1185. package/extended/reference/triangle.md +8 -0
  1186. package/extended/reference/trianglepattern.md +7 -0
  1187. package/extended/reference/trix.md +11 -0
  1188. package/extended/reference/typicalprice.md +11 -0
  1189. package/extended/reference/value.md +5 -0
  1190. package/extended/reference/valueaxis.md +24 -0
  1191. package/extended/reference/venn.md +19 -0
  1192. package/extended/reference/venndefaulttheme.md +6 -0
  1193. package/extended/reference/verticallayout.md +7 -0
  1194. package/extended/reference/verticallineseries.md +14 -0
  1195. package/extended/reference/volume.md +11 -0
  1196. package/extended/reference/volumeprofile.md +10 -0
  1197. package/extended/reference/voronoitreemap.md +12 -0
  1198. package/extended/reference/vwap.md +10 -0
  1199. package/extended/reference/williamsr.md +11 -0
  1200. package/extended/reference/wordcloud.md +11 -0
  1201. package/extended/reference/wordclouddefaulttheme.md +6 -0
  1202. package/extended/reference/xychart.md +15 -0
  1203. package/extended/reference/xychartdefaulttheme.md +6 -0
  1204. package/extended/reference/xychartscrollbar.md +9 -0
  1205. package/extended/reference/xycursor.md +14 -0
  1206. package/extended/reference/xyseries.md +22 -0
  1207. package/extended/reference/zigzag.md +10 -0
  1208. package/extended/reference/zoomablecontainer.md +16 -0
  1209. package/extended/reference/zoomcontrol.md +9 -0
  1210. package/extended/reference/zoomtools.md +9 -0
  1211. package/package.json +1 -1
  1212. package/src/content.js +10 -2
  1213. package/src/tools.js +33 -6
package/content/SKILL.md CHANGED
@@ -42,10 +42,10 @@ Docs: https://docs.amcharts.com/v5/
42
42
  10. **CategoryAxis must receive data** — call `xAxis.data.setAll(data)` in addition to series data. Forgetting this is the #1 bug.
43
43
  11. **DateAxis values must be timestamps** — use `new Date().getTime()`, not Date objects.
44
44
  12. **Disposal is mandatory in SPAs** — in React, Vue, Angular, Svelte or React Native use amCharts' framework package, which creates and disposes the root for you (see "Frameworks"); without one, call `root.dispose()` on component unmount. Not `chart.dispose()`.
45
- 13. **Style through amCharts, not CSS** — charts draw on canvas by default, so CSS cannot reach chart internals. Even with the optional SVG renderer (5.21.0) the shapes carry no per-element classes or ids, are rewritten as the chart redraws, and exports ignore page CSS. Use amCharts settings/templates/themes instead.
45
+ 13. **Style through amCharts, not CSS** — charts draw on canvas by default, so CSS cannot reach chart internals. Even with the optional SVG renderer the shapes carry no per-element classes or ids, are rewritten as the chart redraws, and exports ignore page CSS. Use amCharts settings/templates/themes instead.
46
46
  14. **Dark backgrounds require Dark theme** — If the user requests or the page clearly has a dark background, always add `am5themes_Dark.new(root)` to `root.setThemes()` after Animated and ResponsiveMax. Without it, labels, grid, and tooltips will be invisible. If the background is not clearly dark, default to white/light and do NOT add the Dark theme unless asked.
47
47
  15. **Use default amCharts colors** — Do NOT invent custom color palettes unless the user explicitly asks for specific colors. amCharts assigns colors automatically from its built-in ColorSet. If you need a color programmatically, use `chart.get("colors").getIndex(index)` or `chart.get("colors").next()`. For pie/percent charts, use `series.get("colors")` instead. With 3 or more series in one XY chart, the default colors are close blues and violets (hues 18° apart): set `chart.get("colors").set("step", 3)` before adding series, or use the `Colorblind` theme (see "ColorSet").
48
- 16. **Every chart gets `Animated` and `ResponsiveMax` (5.22.0+)** — `root.setThemes([am5themes_Animated.new(root), am5themes_ResponsiveMax.new(root)])`, with a palette or `Dark` theme after them. ResponsiveMax fits labels and legends at any size and adapts the chart on small screens: axis labels are spaced to fit, legends shrink and then scroll, and scrollbars give way to pinch zoom on phones. Import `@amcharts/amcharts5/themes/ResponsiveMax`, or load `themes/ResponsiveMax.js` after `themes/Animated.js`. The theme is new in 5.22.0: for an older version, leave it out (in React Native, before react-native 5.0.3). One exception: a `Micro` sparkline keeps `Micro` alone.
48
+ 16. **Every chart gets `Animated` and `ResponsiveMax`** — `root.setThemes([am5themes_Animated.new(root), am5themes_ResponsiveMax.new(root)])`, with a palette or `Dark` theme after them. ResponsiveMax fits labels and legends at any size and adapts the chart on small screens: axis labels are spaced to fit, legends shrink and then scroll, and scrollbars give way to pinch zoom on phones. Import `@amcharts/amcharts5/themes/ResponsiveMax`, or load `themes/ResponsiveMax.js` after `themes/Animated.js`. One exception: a `Micro` sparkline keeps `Micro` alone.
49
49
 
50
50
  ## Package / module map
51
51
 
@@ -64,27 +64,22 @@ Docs: https://docs.amcharts.com/v5/
64
64
  | Venn | `@amcharts/amcharts5/venn` | `venn.js` | Venn |
65
65
  | Gantt | `@amcharts/amcharts5/gantt` | `gantt.js` | Gantt (also needs `xy.js` and `plugins/colorPicker.js`, both before `gantt.js`) |
66
66
  | Geodata | `@amcharts/amcharts5-geodata/*` | `geodata/*.js` | worldLow, usaLow, etc. |
67
- | Themes | `@amcharts/amcharts5/themes/Animated`, `@amcharts/amcharts5/themes/ResponsiveMax` (5.22.0) | `themes/Animated.js`, `themes/ResponsiveMax.js` | am5themes_Animated, am5themes_ResponsiveMax |
67
+ | Themes | `@amcharts/amcharts5/themes/Animated`, `@amcharts/amcharts5/themes/ResponsiveMax` | `themes/Animated.js`, `themes/ResponsiveMax.js` | am5themes_Animated, am5themes_ResponsiveMax |
68
68
  | Exporting | `@amcharts/amcharts5/plugins/exporting` | `plugins/exporting.js` | Exporting, ExportingMenu |
69
69
  | JSON | `@amcharts/amcharts5/plugins/json` | `plugins/json.js` | ChartSerializer, JsonParser |
70
- | Chart element (5.21.0) | `@amcharts/amcharts5/element` | `element.js` (after `plugins/json.js`) | `<am5-chart>` — see "Serializing to JSON" |
70
+ | Chart element | `@amcharts/amcharts5/element` | `element.js` (after `plugins/json.js`) | `<am5-chart>` — see "Serializing to JSON" |
71
71
  | Framework packages | `@amcharts/amcharts5-react`, `-vue`, `-angular`, `-svelte`, `-react-native` (separate npm packages) | — | `useAmChart`, `<AmChart>`, `[amChart]`, `attachAmChart` — see "Frameworks" |
72
72
 
73
- **Plain HTML, no bundler.** Load the script files ("CDN script" above) with `<script>` tags: `index.js` first, then the chart packages, then themes. They are on the amCharts CDN (`https://cdn.amcharts.com/lib/5/index.js`), and since 5.22.0 also in the npm package's `dist/` folder, so npm CDNs serve them:
74
-
75
- ```html
76
- <script src="https://cdn.jsdelivr.net/npm/@amcharts/amcharts5@5.22.0/dist/index.js"></script>
77
- <script src="https://cdn.jsdelivr.net/npm/@amcharts/amcharts5@5.22.0/dist/xy.js"></script>
78
- <script src="https://cdn.jsdelivr.net/npm/@amcharts/amcharts5@5.22.0/dist/themes/Animated.js"></script>
79
- <script src="https://cdn.jsdelivr.net/npm/@amcharts/amcharts5@5.22.0/dist/themes/ResponsiveMax.js"></script>
80
- ```
73
+ **Plain HTML, no bundler.** Load the script files ("CDN script" above) with `<script>` tags: `index.js` first, then the chart packages, then themes. They are on the amCharts CDN (`https://cdn.amcharts.com/lib/5/index.js`), and in the npm package's `dist/` folder, so npm CDNs serve them. On jsDelivr they are under `https://cdn.jsdelivr.net/npm/@amcharts/amcharts5@5.22.0/dist/`, with the same file names: `index.js`, `xy.js`, `themes/Animated.js`, `themes/ResponsiveMax.js`.
81
74
 
82
75
  - **Which CDN:** cdn.amcharts.com by default. Where only npm CDNs are allowed (Claude artifacts and other AI sandboxes, strict CSPs), use jsDelivr or unpkg (`https://unpkg.com/@amcharts/amcharts5@5.22.0/dist/index.js`). The files are also at `node_modules/@amcharts/amcharts5/dist/`.
83
76
  - **Pin one version for every file,** and use classic script tags, not `type="module"`: the lazy parts (PDF, Excel and annotation export) load from the `deps/` folder beside `index.js`.
84
77
  - **Maps:** the package's `dist/geodata/` has only `worldLow.js` and `usaLow.js`. Other maps are in the `@amcharts/amcharts5-geodata` package's `dist/`, at the same path as below `geodata/` on the amCharts CDN (`dist/worldLow.js`, `dist/region/world/europeLow.js`), on unpkg (`https://unpkg.com/@amcharts/amcharts5-geodata@5.2.0/dist/worldLow.js`) but not jsDelivr, which refuses a package that large.
85
78
  - **PDF fonts** (`am5fonts_*`) are only on cdn.amcharts.com.
86
79
 
87
- **Bundling.** Keep code splitting on (esbuild: `splitting: true`, `format: "esm"`). With the stock toolbar's drawing or indicator controls, `<am5-chart>`, the JSON plugin or the exporting plugin, a single-file bundle inlines the exporting plugin's lazy parts (PDF, Excel, annotations), about 1 MB gzipped more: a stock chart with those controls loads about 275 KB gzipped split, 1.4 MB as one file (the toolbar itself and `PeriodSelector` add almost nothing). So does `import * as am5stock` when the whole namespace object is kept (assigned to a variable or `window`); `am5stock.StockChart` and the like keep only what they use. A stock chart without those controls bundles to about 130–200 KB, core + `xy` to about 170 KB. The script files gzipped (5.22.0): `index.js` + `xy.js` 182 KB, + `stock.js` 260 KB. Docs: https://docs.amcharts.com/v5/getting-started/#bundling.
80
+ **Bundling.** Keep code splitting on (esbuild: `splitting: true`, `format: "esm"`). With the stock toolbar's drawing or indicator controls, `<am5-chart>`, the JSON plugin or the exporting plugin, a single-file bundle inlines the exporting plugin's lazy parts (PDF, Excel, annotations), about 1 MB gzipped more: a stock chart with those controls loads about 275 KB gzipped split, 1.4 MB as one file (the toolbar itself and `PeriodSelector` add almost nothing). So does `import * as am5stock` when the whole namespace object is kept (assigned to a variable or `window`); `am5stock.StockChart` and the like keep only what they use. A stock chart without those controls bundles to about 130–200 KB, core + `xy` to about 170 KB. The script files gzipped: `index.js` + `xy.js` 182 KB, + `stock.js` 260 KB. Docs: https://docs.amcharts.com/v5/getting-started/#bundling.
81
+
82
+ **The npm package also ships** `AGENTS.md`, `docs/` (a bundled copy of these notes, possibly older) and `examples/<name>/index.ts` (62 also as `config.json`; `examples/examples.json` lists what each shows). When the package is installed, those examples are verified starting points.
88
83
 
89
84
  ## Which reference to read
90
85
 
@@ -115,7 +110,7 @@ If the user asks about core setup (theming, colors, exporting, legends, tooltips
115
110
  ```js
116
111
  const root = am5.Root.new("chartdiv"); // div id or HTMLElement reference
117
112
 
118
- // Apply theme(s): Animated and ResponsiveMax on every chart (ResponsiveMax from 5.22.0); a palette or Dark after them
113
+ // Apply theme(s): Animated and ResponsiveMax on every chart; a palette or Dark after them
119
114
  root.setThemes([am5themes_Animated.new(root), am5themes_ResponsiveMax.new(root)]);
120
115
 
121
116
  // Set locale (optional)
@@ -125,11 +120,15 @@ root.locale = am5locales_de_DE;
125
120
  // Set date/number formats (optional)
126
121
  root.dateFormatter.setAll({ dateFormat: "yyyy-MM-dd" });
127
122
  root.numberFormatter.setAll({ numberFormat: "#,###.##" });
123
+
124
+ // Time zone (optional): date axes, formatters, data grouping and the stock
125
+ // PeriodSelector/DateRangeSelector follow it; root.utc = true for UTC
126
+ root.timezone = am5.Timezone.new("America/New_York");
128
127
  ```
129
128
 
130
129
  One Root per DOM element: a second `am5.Root.new()` on the same element throws "You cannot have multiple Roots on the same DOM node", so dispose the old root first. Separate elements on one page can each have their own Root (for example, a chart in a modal), and each is disposed on its own.
131
130
 
132
- **Canvas or SVG (5.21.0).** Charts draw on canvas by default. `am5.SVGRenderer` draws the same chart as live SVG instead — it can only be chosen when the root is created:
131
+ **Canvas or SVG.** Charts draw on canvas by default. `am5.SVGRenderer` draws the same chart as live SVG instead — it can only be chosen when the root is created:
133
132
 
134
133
  ```js
135
134
  const root = am5.Root.new("chartdiv", { renderer: am5.SVGRenderer });
@@ -139,14 +138,14 @@ am5.Root.defaultRenderer = am5.SVGRenderer;
139
138
 
140
139
  Charts look and behave the same with either (text is measured the same way, interaction and image export work as usual); only blend modes `DST_OVER`, `SRC_ATOP` and `XOR` are canvas-only (drawn as normal in SVG, with a console warning). Keep the canvas default unless the user asks for SVG in the page. An SVG **file** does not need it — `am5.renderToSVG()` and the exporting menu make SVG from either renderer (see "Exporting"). In SVG mode pointer input is still resolved by amCharts (the `<svg>` layers have `pointer-events="none"`), so attach handlers with `events.on()`, not DOM listeners.
141
140
 
142
- **Available themes** (as of 5.22.0):
141
+ **Available themes:**
143
142
 
144
143
  | Kind | Themes |
145
144
  |------|--------|
146
- | Behavioral | `Animated` (animations), `ResponsiveMax` (5.22.0, on every chart: fits labels, legends and scrollbars; see "Responsive rules"), `Micro` (stripped-down micro charts, alone), `Responsive` (the older size-based theme, which mostly hides parts on small charts) |
145
+ | Behavioral | `Animated` (animations), `ResponsiveMax` (on every chart: fits labels, legends and scrollbars; see "Responsive rules"), `Micro` (stripped-down micro charts, alone), `Responsive` (a size-based theme, which mostly hides parts on small charts) |
147
146
  | Light palettes | `Dataviz`, `Frozen`, `Kelly`, `Material`, `Moonrise`, `Spirited`, `Ember`, `Nord`, `Pastel`, `Petroleum`, `Savanna`, `Colorblind` (Okabe-Ito, color-blindness safe), `Patterns` (pattern fills instead of flat colors) |
148
147
  | Dark | `Dark`, `Midnight`, plus a dark variant of most palettes: `DatavizDark`, `FrozenDark`, `KellyDark`, `MaterialDark`, `MoonriseDark`, `SpiritedDark`, `NordDark`, `PastelDark`, `ColorblindDark`, `PatternsDark` |
149
- | Parameterized (5.20.0) | `Monochrome`, `Adaptive` — see below |
148
+ | Parameterized | `Monochrome`, `Adaptive` — see below |
150
149
 
151
150
  Palette themes are additive: put them after `Animated` and `ResponsiveMax`, e.g. `root.setThemes([am5themes_Animated.new(root), am5themes_ResponsiveMax.new(root), am5themes_Nord.new(root)])`. The `*Dark` variants already carry dark interface colors, so do NOT also add `Dark`.
152
151
 
@@ -180,12 +179,12 @@ chart.get("colors").set("colors", [
180
179
  am5.color(0xbb9f06)
181
180
  ]);
182
181
 
183
- // A color on a scale through several colors (5.21.2): position 0–1, clamped, colors evenly spaced
182
+ // A color on a scale through several colors: position 0–1, clamped, colors evenly spaced; a third argument "hsl" blends in HSL (default "rgb")
184
183
  var ic = root.interfaceColors;
185
184
  var mid = am5.Color.interpolateColors(0.5, [ic.get("negative"), ic.get("warning"), ic.get("positive")]); // = warning
186
185
  ```
187
186
 
188
- The interface color `warning` (5.21.2) is a yellow between `negative` (red) and `positive` (green), for the middle of a bad-to-good scale. Prefer `interpolateColors()` through it over `am5.Color.interpolate(t, negative, positive)`, whose middle is brown.
187
+ The interface color `warning` is a yellow between `negative` (red) and `positive` (green), for the middle of a bad-to-good scale. Prefer `interpolateColors()` through it over `am5.Color.interpolate(t, negative, positive)`, whose middle is brown.
189
188
 
190
189
  ## Legend
191
190
 
@@ -201,7 +200,7 @@ legend.data.setAll(chart.series.values);
201
200
  legend.data.setAll(series.dataItems);
202
201
  ```
203
202
 
204
- **A legend that fits: `autoFit: true` (5.22.0).** As room runs out, it fits the legend in steps:
203
+ **A legend that fits: `autoFit: true`.** As room runs out, it fits the legend in steps:
205
204
  1. Empty value labels give their room back.
206
205
  2. A legend that fits at three quarters of its size or more gets smaller.
207
206
  3. One that wouldn't fit even then scrolls instead, usually at full size, and item names too wide are shortened.
@@ -209,7 +208,7 @@ legend.data.setAll(series.dataItems);
209
208
 
210
209
  Above or below the chart it takes at most 30% of the chart's height, beside it at most 40% of its width. A `width`, `height`, `maxWidth`, `maxHeight`, `scale` or `verticalScrollbar` you set on the legend is kept. Without it, a long legend below a pie can take the whole chart and leave the pie no room.
211
210
 
212
- **A right-to-left chart (5.22.0)**, for Hebrew or Arabic: set the Root's `direction` when you create it.
211
+ **A right-to-left chart**, for Hebrew or Arabic: set the Root's `direction` when you create it.
213
212
 
214
213
  ```js
215
214
  const root = am5.Root.new("chartdiv", { direction: "rtl" });
@@ -220,9 +219,9 @@ const root = am5.Root.new("chartdiv", { direction: "rtl" });
220
219
  - `"ltr"` keeps everything left to right, e.g. an English chart on a `dir="rtl"` page.
221
220
  - Not set, text follows the CSS direction of the chart's element, and legends stay left to right.
222
221
 
223
- Set it in `Root.new()` (or a JSON config's `root` section), not later. Drop `reverseChildren` from legend items in older code, or the legend flips back.
222
+ Set it in `Root.new()` (or a JSON config's `root` section), not later. Don't also set `reverseChildren` on legend items: the two undo each other and the legend flips back.
224
223
 
225
- A `Label` with a `width` keeps its text inside its box for every `textAlign` and `direction` since 5.22.0: `left` and `right` are the box's sides, `start` and `end` follow the direction.
224
+ A `Label` with a `width` keeps its text inside its box for every `textAlign` and `direction`: `left` and `right` are the box's sides, `start` and `end` follow the direction.
226
225
 
227
226
  ## Tooltip
228
227
 
@@ -316,7 +315,7 @@ Numbers in `{placeholders}` use `root.numberFormatter`'s `numberFormat` (default
316
315
 
317
316
  - The part after `.` decides rounding. With no `.` nothing is rounded, unlike Excel's `#,###`; a format ending in `.` rounds to a whole number. For animated values (`{valueXWorking}` in a bar race) use `'#,###.'`.
318
317
  - Every number placeholder gets a thousands separator, so a year `{year}` shows `2,024`. Use `{year.formatNumber('#')}`, or keep the year a string in the data.
319
- - Positive, negative and zero formats are split by `|`, not `;` (`"#,###;'-'#,###;0"` prints `500;-500;0`). The negative part still gets a minus unless it has the `s` modifier: `"#,###|(#,###s)|'-'"` gives `1,000`, `(1,000)`, `-`. Before 5.22.0, `#,###s` lost the thousands separator.
318
+ - Positive, negative and zero formats are split by `|`, not `;` (`"#,###;'-'#,###;0"` prints `500;-500;0`). The negative part still gets a minus unless it has the `s` modifier: `"#,###|(#,###s)|'-'"` gives `1,000`, `(1,000)`, `-`.
320
319
  - On a value axis with fractional steps, a trailing `.` makes duplicate labels (`1, 1, 2, 2`); use `maxPrecision: 0` there.
321
320
 
322
321
  ## Chart title
@@ -363,7 +362,7 @@ const exporting = am5plugins_exporting.Exporting.new(root, {
363
362
  });
364
363
  ```
365
364
 
366
- **SVG export (5.21.0)** works whichever renderer draws the chart. The `ExportingMenu` lists "SVG" by default (`svgOptions: { disabled: true }` removes it; `svgOptions: { precision: 3 }` sets the decimals); in code use `exporting.download("svg")`, `exporting.getSVG()` (markup) or `exporting.exportSVG()` (data URI). Without the plugin, the core has `am5.renderToSVG()`:
365
+ **SVG export** works whichever renderer draws the chart. The `ExportingMenu` lists "SVG" by default (`svgOptions: { disabled: true }` removes it; `svgOptions: { precision: 3 }` sets the decimals); in code use `exporting.download("svg")`, `exporting.getSVG()` (markup) or `exporting.exportSVG()` (data URI). Without the plugin, the core has `am5.renderToSVG()`:
367
366
 
368
367
  ```js
369
368
  // The chart as last drawn — after a change, wait for the frame to be drawn
@@ -373,11 +372,11 @@ root.events.once("frameended", function () {
373
372
  });
374
373
  ```
375
374
 
376
- Options: `width`, `height`, `precision` (default `3`), `idPrefix` (`"am5-"`; vary it when several SVGs share a page), `title` (screen-reader name; default the Root `ariaLabel`), `background` (CSS color; default transparent), `includeNonExportable` (5.21.5, default `false`: also write elements marked `exportable: false`, such as scrollbar grips). Left out: elements with `exportable: false` (unless `includeNonExportable`), cross-origin images without CORS, and fully transparent elements. Since 5.21.5 the SVG suits design tools such as Figma: fonts are attributes with sizes in pixels, text is placed without `dominant-baseline`, patterns are drawn as shapes, and layers are named after series, data items, axes and the legend.
375
+ Options: `width`, `height`, `precision` (default `3`), `idPrefix` (`"am5-"`; vary it when several SVGs share a page), `title` (screen-reader name; default the Root `ariaLabel`), `background` (CSS color; default transparent), `includeNonExportable` (default `false`: also write elements marked `exportable: false`, such as scrollbar grips). Left out: elements with `exportable: false` (unless `includeNonExportable`), cross-origin images without CORS, and fully transparent elements. The SVG suits design tools such as Figma: fonts are attributes with sizes in pixels, text is placed without `dominant-baseline`, patterns are drawn as shapes, and layers are named after series, data items, axes and the legend.
377
376
 
378
377
  ## Responsive rules
379
378
 
380
- **`am5themes_ResponsiveMax` (5.22.0) goes on every chart** (Critical rule 16). It fits labels and legends at any size, and adapts the chart on small screens, hiding parts only as the last step:
379
+ **`am5themes_ResponsiveMax` goes on every chart** (Critical rule 16). It fits labels and legends at any size, and adapts the chart on small screens, hiding parts only as the last step:
381
380
 
382
381
  ```js
383
382
  import am5themes_ResponsiveMax from "@amcharts/amcharts5/themes/ResponsiveMax"; // script tag: themes/ResponsiveMax.js
@@ -408,7 +407,7 @@ The settings also work on their own. All are off by default:
408
407
 
409
408
  `ChartSerializer` saves these settings when you set them in code. It does not save what they decide (hidden labels, a smaller legend, the pinch zoom), nor what a theme turns on, so a config saved from a small chart opens full size.
410
409
 
411
- **Rules of your own** go on the `am5themes_ResponsiveMax` instance (before 5.22.0, on `am5themes_Responsive`, which also hides parts of its own):
410
+ **Rules of your own** go on the `am5themes_ResponsiveMax` instance (`am5themes_Responsive` takes them too, but also hides parts of its own):
412
411
 
413
412
  ```js
414
413
  const responsive = am5themes_ResponsiveMax.new(root);
@@ -447,7 +446,7 @@ series.set("heatRules", [{
447
446
  key: "radius"
448
447
  }]);
449
448
 
450
- // Through more than two values (5.21.2): `stops` in place of min/max, e.g. red–yellow–green
449
+ // Through more than two values: `stops` in place of min/max, e.g. red–yellow–green
451
450
  var ic = root.interfaceColors;
452
451
  series.set("heatRules", [{
453
452
  target: series.columns.template,
@@ -469,9 +468,9 @@ A `radius` rule is linear in radius: areas grow with the square of the value, an
469
468
  | `min` | color/number | Value applied at the lowest data value |
470
469
  | `max` | color/number | Value applied at the highest data value |
471
470
  | `neutral` | color/number | Value for elements whose data item has no value (otherwise they keep the template's) |
472
- | `stops` | array | Values for a scale through more than two (5.21.2), in place of `min`/`max`: the lowest data value gets the first, the highest the last, blended between. Numbers, percents or colors, all of one kind |
473
- | `minValue` | number | Override auto-calculated min (skips `calculateAggregates`; `0` is honored since 5.21.0) |
474
- | `maxValue` | number | Override auto-calculated max (skips `calculateAggregates`; `0` is honored since 5.21.0) |
471
+ | `stops` | array | Values for a scale through more than two, in place of `min`/`max`: the lowest data value gets the first, the highest the last, blended between. Numbers, percents or colors, all of one kind |
472
+ | `minValue` | number | Override auto-calculated min (skips `calculateAggregates`; `0` is honored) |
473
+ | `maxValue` | number | Override auto-calculated max (skips `calculateAggregates`; `0` is honored) |
475
474
  | `customFunction` | function | `(sprite, min, max, value)` — full control over the rule |
476
475
 
477
476
  **Using heat rules on bullets** — bullets need an explicit `am5.Template`, and the series must track the field the rule reads:
@@ -502,7 +501,7 @@ Rules that make bullet heat rules work (each failure is **silent** — every bul
502
501
  - `dataField` is the data item **property key** (`"valueY"`, `"valueX"`, `"value"`, …), **not** the raw column name. To size XY bullets by a column that is not already an axis value, register it as the base value field: `series.set("valueField", "population")` and use `dataField: "value"`.
503
502
  - `calculateAggregates: true` is required (unless `minValue`/`maxValue` are given) — without it `valueLow`/`valueHigh` are never computed and every bullet gets the midpoint size.
504
503
  - Setting `valueField` (or any `*Field`) **after** the series has processed data does not re-read the data — re-set it: `series.data.setAll(series.data.values.slice())`.
505
- - Bullet heat rules survive `ChartSerializer` (verified 5.21.0): the sample sprite the serializer builds from the factory is disposed right away and leaves the template, so the old `sprite._setDataItem(dataItem)` workaround is not needed.
504
+ - Bullet heat rules survive `ChartSerializer`.
506
505
 
507
506
  **HeatLegend:**
508
507
 
@@ -520,7 +519,7 @@ series.events.on("datavalidated", function() {
520
519
  heatLegend.set("endValue", series.getPrivate("valueHigh"));
521
520
  });
522
521
 
523
- // Through several colors (5.21.2): `colors` in place of startColor/endColor, matching a heat rule's `stops`
522
+ // Through several colors: `colors` in place of startColor/endColor, matching a heat rule's `stops`
524
523
  var ic = root.interfaceColors;
525
524
  var scaleLegend = chart.children.push(am5.HeatLegend.new(root, {
526
525
  orientation: "horizontal",
@@ -538,7 +537,7 @@ series.appear(1000); // duration in ms
538
537
  chart.appear(1000, 100); // duration, delay
539
538
  ```
540
539
 
541
- **`autoAppear` (5.21.0)** — the same opening animation as a setting, so it works from a JSON config or `<am5-chart>`, where `appear()` cannot be called:
540
+ **`autoAppear`** — the same opening animation as a setting, so it works from a JSON config or `<am5-chart>`, where `appear()` cannot be called:
542
541
 
543
542
  ```js
544
543
  chart.setAll({ autoAppear: true, appearDuration: 1000, appearDelay: 100 });
@@ -548,7 +547,7 @@ series.setAll({ autoAppear: true, appearDuration: 1000 }); // a series waits f
548
547
 
549
548
  It plays once, when the element is first drawn (data updates do not replay it; turning the setting off and on does). `autoAppear` defaults to `false`; `appearDuration` falls back to the element's `stateAnimationDuration`; `appearDelay` (default `0`) keeps the element hidden until it starts. Elements made from a template play as each is made; an element that starts hidden stays hidden.
550
549
 
551
- **Declared animations — the `animations` setting (5.20.8).** Every element can carry its own animations as data, so they live in a JSON config and survive `ChartSerializer` — prefer this over `sprite.animate({ loops: Infinity })` for endless effects:
550
+ **Declared animations — the `animations` setting.** Every element can carry its own animations as data, so they live in a JSON config and survive `ChartSerializer` — prefer this over `sprite.animate({ loops: Infinity })` for endless effects:
552
551
 
553
552
  ```js
554
553
  series.bullets.push(function (root, series, dataItem) {
@@ -621,9 +620,9 @@ whenRendered(root, function () { /* everything is drawn */ });
621
620
 
622
621
  With `root.fps` set, frames are spaced `1000 / root.fps` ms apart, so wait longer than that instead of two animation frames. Endless animations (`loops: Infinity` with `animate()`, `loops: 0` in declared `animations`) never settle. Without a license, the amCharts logo fades in 3 s after the root is created and draws for 1.5 s; a check during that time waits for it.
623
622
 
624
- **Opening a link on click needs no handler (5.20.7):** `series.set("urlField", "url")` makes each item's bullet, column, slice, Venn slice, map polygon or map line open the URL in its data row (`linkTarget`, default `"_self"`) — see "Recent API changes". Hierarchy nodes, flow nodes/links and word-cloud labels are not linked; keep a `click` handler there.
623
+ **Opening a link on click needs no handler:** `series.set("urlField", "url")` makes each item's bullet, column, slice, Venn slice, map polygon or map line open the URL in its data row (`linkTarget`, default `"_self"`) — see "Recent API changes". Hierarchy nodes, flow nodes/links and word-cloud labels are not linked; keep a `click` handler there.
625
624
 
626
- **A tap fires no DOM `click` on a pannable chart.** On touch, a tap on an XYChart with `panX`/`panY`, under a cursor with a zoom or select `behavior`, or on a `draggable` sprite gives `pointerdown`/`pointerup` but no `mousedown`/`mouseup`/`click` on the page (Chrome touch emulation, 5.21.5). The amCharts `click` event still fires: use `events.on("click", …)`, not a DOM listener.
625
+ **A tap fires no DOM `click` on a pannable chart.** On touch, a tap on an XYChart with `panX`/`panY`, under a cursor with a zoom or select `behavior`, or on a `draggable` sprite gives `pointerdown`/`pointerup` but no `mousedown`/`mouseup`/`click` on the page (Chrome touch emulation). The amCharts `click` event still fires: use `events.on("click", …)`, not a DOM listener.
627
626
 
628
627
  ## Settings API
629
628
 
@@ -646,12 +645,12 @@ const cursor = chart.set("cursor", am5xy.XYCursor.new(root, {}));
646
645
 
647
646
  ## Settings that already equal the default — omit them
648
647
 
649
- Generated code routinely spells out settings that equal the amCharts default (verified against the default themes, and for `Gantt` the code, of 5.21.2). They add noise and mislead readers into thinking they matter. Do not emit these unless changing them:
648
+ Generated code routinely spells out settings that equal the amCharts default (verified against the default themes, and for `Gantt` the code). They add noise and mislead readers into thinking they matter. Do not emit these unless changing them:
650
649
 
651
650
  | Class | Setting(s) that are already the default |
652
651
  |-------|------------------------------------------|
653
652
  | All hierarchy series | `childDataField: "children"`, `downDepth: 1`, `initialDepth: 5` |
654
- | `Sunburst`, `Partition`, `Treemap`, `VoronoiTreemap` | `singleBranchOnly: true` (`Partition`/`Treemap` also `upDepth: 0`; `VoronoiTreemap` also `shapeType: "polygon"`; `Sunburst` ignores the setting since 5.21.0 — always single-branch) |
653
+ | `Sunburst`, `Partition`, `Treemap`, `VoronoiTreemap` | `singleBranchOnly: true` (`Partition`/`Treemap` also `upDepth: 0`; `VoronoiTreemap` also `shapeType: "polygon"`; `Sunburst` ignores the setting — always single-branch) |
655
654
  | `Tree`, `ForceDirected` | `singleBranchOnly: false`, `upDepth: Infinity`, `topDepth: 0` (`Tree` also `orientation: "vertical"`) |
656
655
  | `PieSeries`, `FunnelSeries`, `PyramidSeries`, `PictorialStackedSeries` | `alignLabels: true` (`PieSeries` also `startAngle: -90`, `endAngle: 270`; `FunnelSeries` also `orientation: "vertical"`, `startLocation: 0`, `endLocation: 1`, `bottomRatio: 0`) |
657
656
  | `Chord` | `sort: "none"` (data order) |
@@ -704,7 +703,7 @@ On maps it is worse: a `geometry` can't be animated, so with `setIndex` it switc
704
703
 
705
704
  A data item's bullets are a plain array **property**: `dataItem.bullets?.[0]?.get("sprite")` is the sprite the bullet function made (`dataItem.get("bullets")` is `undefined`).
706
705
 
707
- `dataItem.bullets` stays `undefined` until the series draws that item: right after `data.setAll()`, in `datavalidated` and in the first `frameended` (5.21.5: bullets appeared on the second frame), and, on a zoomed `DateAxis`, for items out of view. Decide a bullet's look inside the bullet function from `dataItem` (or with `templateField`), not by reaching into `dataItem.bullets` after setting the data.
706
+ `dataItem.bullets` stays `undefined` until the series draws that item: right after `data.setAll()`, in `datavalidated` and in the first `frameended` (bullets appear on the second frame), and, on a zoomed `DateAxis`, for items out of view. Decide a bullet's look inside the bullet function from `dataItem` (or with `templateField`), not by reaching into `dataItem.bullets` after setting the data.
708
707
 
709
708
  ## Performance: big data, fast updates, no animation
710
709
 
@@ -761,7 +760,7 @@ polygon.states.lookup("default")?.set("fill", color);
761
760
 
762
761
  **`sprite.hover()` also shows the sprite's tooltip.** To highlight other elements from an event (related links or columns), apply the state instead: `sprite.states.applyAnimate("hover")`, and `"default"` to undo it. Several `hover()` calls move the shared tooltip to the last sprite.
763
762
 
764
- ## Parameterized themes — Monochrome & Adaptive (5.20.0)
763
+ ## Parameterized themes — Monochrome & Adaptive
765
764
 
766
765
  Two themes generate their palette from colors you pass in (OKLCH-based, so the result stays perceptually balanced). Because a theme cannot take constructor parameters, these ship as **factory functions** — call them with `(root, settings)`; `.new(root, settings)` also works.
767
766
 
@@ -796,7 +795,7 @@ root.setThemes([
796
795
 
797
796
  Both are additive (they do not modify built-in themes) and both handle dark mode themselves via `dark: true` — do not also add the `Dark` theme.
798
797
 
799
- **More settings (5.21.2, both themes, all off by default):** `interleave: true` takes the colors in the order 1, 4, 2, 5, 3, 6, so series next to each other differ more (Monochrome keeps `accent` first); `mapShade: true` fills map land with a mid shade of the base color, as light as default map land, instead of the color itself; `keepContrast: true` keeps the series colors and primary buttons at least 3:1 against the background (or give a ratio, e.g. `4.5`). In Adaptive it moves `baseColor` and `baseColor2` themselves, so the first color is then not exactly the brand color; in Monochrome it moves the end of the shades nearest the background. A branded palette:
798
+ **More settings (both themes, all off by default):** `interleave: true` takes the colors in the order 1, 4, 2, 5, 3, 6, so series next to each other differ more (Monochrome keeps `accent` first); `mapShade: true` fills map land with a mid shade of the base color, as light as default map land, instead of the color itself; `keepContrast: true` keeps the series colors and primary buttons at least 3:1 against the background (or give a ratio, e.g. `4.5`). In Adaptive it moves `baseColor` and `baseColor2` themselves, so the first color is then not exactly the brand color; in Monochrome it moves the end of the shades nearest the background. A branded palette:
800
799
 
801
800
  ```js
802
801
  am5themes_Adaptive(root, { baseColor: 0x2c6e91, baseColor2: 0xffdd00, count: 10, interleave: true, mapShade: true, keepContrast: true })
@@ -858,11 +857,11 @@ colors.set("colors", [
858
857
  ]);
859
858
  ```
860
859
 
861
- **Swapping a `ColorSet`.** The theme's `baseColor` resolves lazily, so a **synchronous** re-color right after swapping a `ColorSet` can read a transient value (sprites momentarily black). Re-set the series data and let amCharts' own data pass recolor the sprites. Before 5.22.0, `colorSet.set("colors", [])` crashed the next `next()`/`getIndex()`. Since 5.22.0 an empty list starts from `baseColor`.
860
+ **Swapping a `ColorSet`.** The theme's `baseColor` resolves lazily, so a **synchronous** re-color right after swapping a `ColorSet` can read a transient value (sprites momentarily black). Re-set the series data and let amCharts' own data pass recolor the sprites. An empty `colors` list starts from `baseColor`.
862
861
 
863
- **`step` with a theme that reuses its colors** (`reuse: true`: Adaptive, Monochrome, Nord, Pastel, Kelly, …): before 5.21.2 a `step` sharing a factor with the list length used only a few of the colors (a word cloud or treemap with Nord got two or three). Now every color is used before any repeats, so `step: count / 2` interleaves the palette.
862
+ **`step` with a theme that reuses its colors** (`reuse: true`: Adaptive, Monochrome, Nord, Pastel, Kelly, …): every color is used before any repeats, so `step: count / 2` interleaves the palette.
864
863
 
865
- **Repeats are lighter (5.21.3).** In themes that reuse their list, once every color has been used, the next round is 10% lighter instead of the same colors again. This covers Adaptive, Monochrome, Ember, Frozen, Kelly, Material, Midnight, Moonrise, Nord, Pastel, Petroleum, Savanna and Spirited, with their Dark variants, but not Colorblind, Patterns or Dataviz. The setting is `repeatLightness` on the `ColorSet`: HSL lightness per round, `0.1` is 10%, and a negative value makes it darker. It only acts with `reuse: true`. The color sets of one root share the theme's list, and the repeats are added to that list, so whichever color set on the root first needs a new round decides that round for every chart on it. To repeat the colors as they are, as before 5.21.3, set it for the whole root:
864
+ **Repeats are lighter.** In themes that reuse their list, once every color has been used, the next round is 10% lighter. This covers Adaptive, Monochrome, Ember, Frozen, Kelly, Material, Midnight, Moonrise, Nord, Pastel, Petroleum, Savanna and Spirited, with their Dark variants, but not Colorblind, Patterns or Dataviz. The setting is `repeatLightness` on the `ColorSet`: HSL lightness per round, `0.1` is 10%, and a negative value makes it darker. It only acts with `reuse: true`. The color sets of one root share the theme's list, and the repeats are added to that list, so whichever color set on the root first needs a new round decides that round for every chart on it. To repeat the colors as they are, set it for the whole root:
866
865
 
867
866
  ```js
868
867
  // Every ColorSet on the root, through a theme rule
@@ -876,7 +875,7 @@ am5themes_Adaptive.new(root, { repeatLightness: false });
876
875
 
877
876
  With one chart on the root, `chart.get("colors").set("repeatLightness", 0)` before the data is set works too.
878
877
 
879
- **Three or more series.** Smallest color difference (CIEDE2000) among the first 4 / 6 series colors, 5.21.5; higher is easier to tell apart:
878
+ **Three or more series.** Smallest color difference (CIEDE2000) among the first 4 / 6 series colors; higher is easier to tell apart:
880
879
 
881
880
  | Choice | First 4 / 6 | Note |
882
881
  |---|---|---|
@@ -897,12 +896,14 @@ series.data.processor = am5.DataProcessor.new(root, {
897
896
  dateFormat: "yyyy-MM-dd", // read as local time (UTC with root.utc); see below for leaving it out
898
897
  numericFields: ["value", "count"],
899
898
  colorFields: ["color"],
900
- emptyAs: 0 // replace null, undefined and "" with 0 (before 5.21.0 it also replaced 0 and false)
899
+ emptyAs: 0 // replace null, undefined and "" with 0 (0 and false stay)
901
900
  });
902
901
  // Configure processor BEFORE setting data
903
902
  ```
904
903
 
905
- Without `dateFormat`, since 5.21.1 the browser's `Date` parses the strings, so ISO strings work and a date-only `"2024-03-15"` is midnight **UTC**. Before 5.21.1 every such string became 1 January 1970.
904
+ Without `dateFormat`, the browser's `Date` parses the strings, so ISO strings work and a date-only `"2024-03-15"` is midnight **UTC**.
905
+
906
+ **CSV:** `am5.CSVParser.parse(text, options)` turns CSV text into rows. An empty string gives `[]` with `useColumnNames: true`, but `[{}]` (one empty row) with the default options, so check for that before `data.setAll()`. Empty lines are skipped unless `skipEmpty: false`.
906
907
 
907
908
  ## Serializing to JSON (ChartSerializer / JsonParser)
908
909
 
@@ -910,18 +911,18 @@ Without `dateFormat`, since 5.21.1 the browser's `Date` parses the strings, so I
910
911
 
911
912
  `am5plugins_json.ChartSerializer` turns a live chart into a JSON config and `am5plugins_json.JsonParser` rebuilds it (`await parser.parse(config, { parent: root.container })`). Rules that keep round-trips working:
912
913
 
913
- - **Serialize the chart's top-level container child:** `serializer.serializeAll(root.container.children.getIndex(0))` — the chart, or on chart-less types (hierarchy, flow, word cloud, Venn) the series itself. Before 5.21.0 a series placed straight in `root.container`, or one whose `selectedDataItem` points back at itself, overflowed the stack (`Maximum call stack size exceeded`) or broke `JSON.stringify`; 5.21.0 serializes them. A drilled-down hierarchy's `selectedDataItem` is still not restored (it is written as `"@self.dataItems.-1"`).
914
- - **Adapters do not round-trip.** `includeAdapters` (default `true`) writes each adapter as `{ key, callback: "function (…) {…}" }`; the parser does not turn that string back into a function (and the closure's `chart`/`series`/`root` would not exist anyway). Before 5.20.4 the string was registered as a callback and crashed the chart (`i[s] is not a function` in `Entity.fold`); since 5.20.4 such adapters are skipped. Either way the effect is lost — replace palette-coloring adapters with declarative equivalents: `colorByDataItem: true` on column series (5.20.4), a per-item `fill` data field + `templateField`, or `heatRules`.
915
- - **Only user-set settings are serialized (5.20.3)** — theme and library defaults are left out, so a serialized config is much smaller than before and a value you never set will not appear in it. Add `includeRoot: true` (5.20.2) to also write a top-level `root` section (Root settings/properties, `interfaceColors`, formatters). Since 5.22.0 a parsed `root` section sets only those properties and a named locale, and never turns `sanitizeHTML` off, unless parsed with `trusted: true` (`references/json.md` rule 9).
916
- - **Re-parsing into an existing chart:** `parser.parse(config, { updateTargets: "soft" })` (5.20.3) applies settings onto an existing object of the same `type` instead of replacing it. The default `"strict"` replaces.
917
- - **Maps and locales with npm imports (5.21.4):** a geodata pack or locale that isn't a global is copied into the config whole, about 250 KB for `worldLow`, unless the serializer gets it in `resources`. `am5plugins_json.ChartSerializer.new(root, { resources: { am5geodata_worldLow } })` writes `"geoJSON": "am5geodata_worldLow"` instead; parse it back with the same `resources` (`references/json.md`, rule 8). With script tags the packs are globals and are written by name without it.
918
- - **Also saved (5.20.6 – 5.20.8):** `themeTags` you pass to `.new()` (5.20.6 — e.g. a `Button` with `themeTags: ["switch"]` keeps its look; tags the library adds are left out); a legend inside an `axisHeader` (5.20.7); declared `animations` (5.20.8, see "Animations"); and animations started in code that **loop forever** (`loops: Infinity`) with a nameable `am5.ease` easing — written as `animations` entries. `runningAnimations` (5.20.8, default `true`) controls the latter: `am5plugins_json.ChartSerializer.new(root, { runningAnimations: false })` turns it off. Never saved: finite animations (`appear()`, states, zoom) and loops with a custom-function or `pow` easing — for the opening animation use `autoAppear` (5.21.0, see "Animations").
919
- - **Data-item loops (5.21.0):** a loop started on a **data item** in code (`dataItem.animate({ key: "positionOnLine", loops: Infinity, … })`) is saved as an `animations` entry with `target: "dataItem"`. When every data item plays the same loop, it goes on the bullet sprite. Since 5.21.3, when they differ (e.g. points each moving at their own speed), each one goes in its own data row, under the sprite's `templateField` (`"bulletSettings"` if none is set). Before 5.21.3, every item got the first one's loop.
920
- - **Also saved (5.21.0):** a series hidden with `hide()` or a legend click; elements you add to library-built containers (`chart.plotContainer`, `seriesContainer`, axes containers, an axis) — no `themeTags: ["serialize"]` needed; a `ZoomableContainer`'s `contents`; `Date` values (as timestamps); settings on a series' `bulletsContainer` and on a pie/funnel series' `labelsContainer`/`ticksContainer`; the `axisFills`, `rectangles` (`Treemap`, `Partition`) and `polygons` (`VoronoiTreemap`) templates. A color taken from `root.interfaceColors` is written as a reference, `"@root.interfaceColors.get('background')"`, so a config parsed under another theme (e.g. Dark) uses that theme's color — write the same string in hand-made configs. Since 5.21.3 a color taken from the theme's palette with `getIndex()` is written as `"@colors.getIndex(3)"` the same way, and hand-made configs can use it too in settings (e.g. `"fill": "@colors.getIndex(0)"`). Only the palette's own colors become references: generated or lightened repeats stay hex, and references are not read inside data rows. Changing a setting such as `step` on a chart's colors no longer writes the theme's whole palette into the config.
921
- - **Not captured by `ChartSerializer` (as of 5.21.0)** — re-apply these in code after `parse()`: a `ZoomTools` you added to a hand-made `ZoomableContainer` (its `target` is written as a copy, so the parsed buttons drive a different container — re-point `target`, or use `am5.SerialChartContainer`, which wires its own `zoomTools`); Venn `hoverGraphics` (Venn slice-template `states` do round-trip); data items added with `pushDataItem()` (only `series.data` rows are written — map points on lines can be data rows since 5.20.6, see `references/map.md`).
914
+ - **Serialize the chart's top-level container child:** `serializer.serializeAll(root.container.children.getIndex(0))` — the chart, or on chart-less types (hierarchy, flow, word cloud, Venn) the series itself. A series placed straight in `root.container`, or one whose `selectedDataItem` points back at itself, serializes too. A drilled-down hierarchy's `selectedDataItem` is not restored (it is written as `"@self.dataItems.-1"`).
915
+ - **Adapters do not round-trip.** `includeAdapters` (default `true`) writes each adapter as `{ key, callback: "function (…) {…}" }`; the parser does not turn that string back into a function (and the closure's `chart`/`series`/`root` would not exist anyway). On parse such adapters are skipped, so the effect is lost — replace palette-coloring adapters with declarative equivalents: `colorByDataItem: true` on column series, a per-item `fill` data field + `templateField`, or `heatRules`.
916
+ - **Only user-set settings are serialized** — theme and library defaults are left out, so a value you never set will not appear in it. Add `includeRoot: true` to also write a top-level `root` section (Root settings/properties, `interfaceColors`, formatters). A parsed `root` section sets only those properties and a named locale, and never turns `sanitizeHTML` off, unless parsed with `trusted: true` (`references/json.md` rule 9).
917
+ - **Re-parsing into an existing chart:** `parser.parse(config, { updateTargets: "soft" })` applies settings onto an existing object of the same `type` instead of replacing it. The default `"strict"` replaces.
918
+ - **Maps and locales with npm imports:** a geodata pack or locale that isn't a global is copied into the config whole, about 250 KB for `worldLow`, unless the serializer gets it in `resources`. `am5plugins_json.ChartSerializer.new(root, { resources: { am5geodata_worldLow } })` writes `"geoJSON": "am5geodata_worldLow"` instead; parse it back with the same `resources` (`references/json.md`, rule 8). With script tags the packs are globals and are written by name without it.
919
+ - **Also saved:** `themeTags` you pass to `.new()` (e.g. a `Button` with `themeTags: ["switch"]` keeps its look; tags the library adds are left out); a legend inside an `axisHeader`; declared `animations` (see "Animations"); and animations started in code that **loop forever** (`loops: Infinity`) with a nameable `am5.ease` easing — written as `animations` entries. `runningAnimations` (default `true`) controls the latter: `am5plugins_json.ChartSerializer.new(root, { runningAnimations: false })` turns it off. Never saved: finite animations (`appear()`, states, zoom) and loops with a custom-function or `pow` easing — for the opening animation use `autoAppear` (see "Animations").
920
+ - **Data-item loops:** a loop started on a **data item** in code (`dataItem.animate({ key: "positionOnLine", loops: Infinity, … })`) is saved as an `animations` entry with `target: "dataItem"`. When every data item plays the same loop, it goes on the bullet sprite. When they differ (e.g. points each moving at their own speed), each one goes in its own data row, under the sprite's `templateField` (`"bulletSettings"` if none is set).
921
+ - **Also saved:** a series hidden with `hide()` or a legend click; elements you add to library-built containers (`chart.plotContainer`, `seriesContainer`, axes containers, an axis) — no `themeTags: ["serialize"]` needed; a `ZoomableContainer`'s `contents`; `Date` values (as timestamps); settings on a series' `bulletsContainer` and on a pie/funnel series' `labelsContainer`/`ticksContainer`; the `axisFills`, `rectangles` (`Treemap`, `Partition`) and `polygons` (`VoronoiTreemap`) templates. A color taken from `root.interfaceColors` is written as a reference, `"@root.interfaceColors.get('background')"`, so a config parsed under another theme (e.g. Dark) uses that theme's color — write the same string in hand-made configs. A color taken from the theme's palette with `getIndex()` is written as `"@colors.getIndex(3)"` the same way, and hand-made configs can use it too in settings (e.g. `"fill": "@colors.getIndex(0)"`). Colors a color set makes past the theme's list are written as references too. In a data row (e.g. a column `fill` from a `templateField`) the serializer marks the row, and the object in it that holds the reference, with `"__parse": true`; the parser reads references only in marked objects (and in arrays), and elsewhere in data a string starting with `@` or `#` is plain text. A hand-written data row needs both markers: `{ "c": "A", "v": 10, "cs": { "fill": "@colors.getIndex(2)", "__parse": true }, "__parse": true }` (see `references/json.md`, rule 3). A setting such as `step` on a chart's colors is written without the theme's palette.
922
+ - **Not captured by `ChartSerializer`** — re-apply these in code after `parse()`: a `ZoomTools` you added to a hand-made `ZoomableContainer` (its `target` is written as a copy, so the parsed buttons drive a different container — re-point `target`, or use `am5.SerialChartContainer`, which wires its own `zoomTools`); Venn `hoverGraphics` (Venn slice-template `states` do round-trip); data items added with `pushDataItem()` (only `series.data` rows are written — map points on lines can be data rows, see `references/map.md`).
922
923
  - **Bullets** are captured by calling the factory with a sample data item — write factories as `function(root, series, dataItem)` (pitfall #36).
923
924
 
924
- **`<am5-chart>` — a chart as an HTML element (5.21.0).** Builds a chart from a JSON config with no root or chart code. With script tags, load `index.js`, `plugins/json.js`, `element.js`, then every chart package the config uses; with npm, `import { defineChartElement } from "@amcharts/amcharts5/element"` and call `defineChartElement()`, which does nothing if the element already exists. A bare `import "@amcharts/amcharts5/element"` also works from 5.21.5; before that, esbuild dropped it and the element was never defined. Chart packages are loaded on demand. Then set `element.themes = [am5themes_Animated, am5themes_ResponsiveMax]`, for a map `element.resources = { am5geodata_worldLow }` (5.21.4), and `element.config = {…}`, as properties:
925
+ **`<am5-chart>` — a chart as an HTML element.** Builds a chart from a JSON config with no root or chart code. With script tags, load `index.js`, `plugins/json.js`, `element.js`, then every chart package the config uses; with npm, `import { defineChartElement } from "@amcharts/amcharts5/element"` and call `defineChartElement()`, which does nothing if the element already exists. A bare `import "@amcharts/amcharts5/element"` also works. Chart packages are loaded on demand. Then set `element.themes = [am5themes_Animated, am5themes_ResponsiveMax]`, for a map `element.resources = { am5geodata_worldLow }`, and `element.config = {…}`, as properties:
925
926
 
926
927
  ```html
927
928
  <script src="https://cdn.amcharts.com/lib/5/index.js"></script>
@@ -945,7 +946,7 @@ document.querySelector("am5-chart").whenReady().then(function (r) {
945
946
  </script>
946
947
  ```
947
948
 
948
- Attributes: `config` (JSON) or `src` (URL of a JSON file), `themes`, `renderer="svg"` (default canvas). The `themes` attribute takes names, space- or comma-separated, or since 5.21.4 JSON with a theme's settings: `themes='["Animated", "ResponsiveMax", ["Adaptive", { "baseColor": "#4150a0" }]]'`. It works with script tags only. With npm, the `themes` property takes theme classes, e.g. `[am5themes_Animated, am5themes_ResponsiveMax]`, or since 5.21.4 a class with its settings: `[am5themes_Animated, am5themes_ResponsiveMax, [am5themes_Adaptive, { baseColor: "#4150a0" }]]`. Without a height from CSS or its parent it is 400 px high. Themes are not part of a config. Changing `config`/`themes` rebuilds the chart; removing the element disposes it.
949
+ Attributes: `config` (JSON) or `src` (URL of a JSON file), `themes`, `renderer="svg"` (default canvas). The `themes` attribute takes names, space- or comma-separated, or JSON with a theme's settings: `themes='["Animated", "ResponsiveMax", ["Adaptive", { "baseColor": "#4150a0" }]]'`. It works with script tags only. With npm, the `themes` property takes theme classes, e.g. `[am5themes_Animated, am5themes_ResponsiveMax]`, or a class with its settings: `[am5themes_Animated, am5themes_ResponsiveMax, [am5themes_Adaptive, { baseColor: "#4150a0" }]]`. Without a height from CSS or its parent it is 400 px high. Themes are not part of a config. Changing `config`/`themes` rebuilds the chart; removing the element disposes it.
949
950
 
950
951
  ## Accessibility
951
952
 
@@ -959,9 +960,9 @@ series.columns.template.setAll({
959
960
  // focusableGroup: "series1" — TAB to first, arrows within group
960
961
  ```
961
962
 
962
- **High contrast (5.21.0):** in a forced-colors mode such as Windows High Contrast, labels, grid, axes and buttons take the system colors so they stay visible; series colors are kept. It is on by default — `am5.Root.new("chartdiv", { forcedColors: false })` keeps the chart's own interface colors.
963
+ **High contrast:** in a forced-colors mode such as Windows High Contrast, labels, grid, axes and buttons take the system colors so they stay visible; series colors are kept. It is on by default — `am5.Root.new("chartdiv", { forcedColors: false })` keeps the chart's own interface colors.
963
964
 
964
- Keyboard/screen-reader behavior in 5.21.0: a `focusableGroup` is one TAB stop; arrow keys move between its members even when they are draggable (flow and hierarchy nodes) and SHIFT + arrows drag them; ESC hides a focused element's tooltip and ends a keyboard drag; SPACE clicks a focused element with a button-like `role`. New `ariaExpanded` setting (set by the library on Gantt tasks with subtasks and on hierarchy nodes with children); a `role: "button"` with `toggleKey` exposes `aria-pressed`. `am5.Modal` is a dialog to screen readers, named by its new `ariaLabel` setting (else its first heading).
965
+ Keyboard/screen-reader behavior: a `focusableGroup` is one TAB stop; arrow keys move between its members even when they are draggable (flow and hierarchy nodes) and SHIFT + arrows drag them; ESC hides a focused element's tooltip and ends a keyboard drag; SPACE clicks a focused element with a button-like `role`. The `ariaExpanded` setting is set by the library on Gantt tasks with subtasks and on hierarchy nodes with children; a `role: "button"` with `toggleKey` exposes `aria-pressed`. `am5.Modal` is a dialog to screen readers, named by its `ariaLabel` setting (else its first heading).
965
966
 
966
967
  ## Container & Layout
967
968
 
@@ -993,7 +994,9 @@ container.setAll({
993
994
 
994
995
  Use layouts to arrange charts, legends, controls, and labels within containers.
995
996
 
996
- **Right to left: `direction: "rtl"` (5.22.0).** On a container with a horizontal or grid layout, it places the children from right to left, as a mirror image: a child's `marginLeft` ends up on its right. Rows of a grid still go top to bottom. In a vertical layout, children with no `x` of their own line up on the right. For a right-to-left language, set the Root's `direction` instead, which also turns the text and lays out the legends (see "Legend"). `reverseChildren: true` only reverses the order, so a grid starts at the bottom row; don't use it for RTL.
997
+ **Hidden children take no space.** An element hidden with `visible: false`, `forceHidden` or `hide()` takes up no room in a container sized to its content, e.g. a hidden XY scrollbar leaves no empty band above the plot.
998
+
999
+ **Right to left: `direction: "rtl"`.** On a container with a horizontal or grid layout, it places the children from right to left, as a mirror image: a child's `marginLeft` ends up on its right. Rows of a grid still go top to bottom. In a vertical layout, children with no `x` of their own line up on the right. For a right-to-left language, set the Root's `direction` instead, which also turns the text and lays out the legends (see "Legend"). `reverseChildren: true` only reverses the order, so a grid starts at the bottom row; don't use it for RTL.
997
1000
 
998
1001
  ## UI Elements
999
1002
 
@@ -1040,7 +1043,7 @@ button.events.on("click", function() {
1040
1043
 
1041
1044
  ## Frameworks (React, Vue, Angular, Svelte, React Native)
1042
1045
 
1043
- In a framework app, use amCharts' package for that framework instead of writing the mount and dispose code yourself. The packages were first released on 2026-10-22; the current ones are react 5.0.1, vue 5.0.2, angular 5.0.1, svelte 5.0.3 (2026-10-23) and react-native 5.0.3, which loads amCharts 5.22.0. Each package makes the chart once its element is on the page, disposes it with the component, and loads the library in the browser only, so pages rendered on a server work (Next.js, Nuxt, SvelteKit, Angular SSR). Each takes a chart written in code, or a chart from a JSON config (it wraps the `<am5-chart>` element, see "Serializing to JSON").
1046
+ In a framework app, use amCharts' package for that framework instead of writing the mount and dispose code yourself. The current ones are react 5.0.1, vue 5.0.2, angular 5.0.1, svelte 5.0.3 and react-native 5.0.3, which loads amCharts 5.22.0. Each package makes the chart once its element is on the page, disposes it with the component, and loads the library in the browser only, so pages rendered on a server work (Next.js, Nuxt, SvelteKit, Angular SSR). Each takes a chart written in code, or a chart from a JSON config (it wraps the `<am5-chart>` element, see "Serializing to JSON").
1044
1047
 
1045
1048
  | Framework | Package | A chart in code | A chart from a JSON config |
1046
1049
  |---|---|---|---|
@@ -1050,7 +1053,7 @@ In a framework app, use amCharts' package for that framework instead of writing
1050
1053
  | Svelte 4+ (SvelteKit) | `@amcharts/amcharts5-svelte` | Svelte 5.29+: `<div {@attach attachAmChart(buildChart)} style="height: 500px">`; Svelte 4 and older 5: `<div use:amChart={{ setup: buildChart, deps: [data] }}>` | `<am5-chart {@attach attachAmChartConfig({ config, themes })}>`, or `use:amChartConfig={{ config, themes }}`; events `onready`/`onerror` (`on:ready` in Svelte 4) |
1051
1054
  | React Native 0.72+ | `@amcharts/amcharts5-react-native` (+ `react-native-webview` 13+) | `<AmChart code={code} data={data} />`, where `code` is a **string** (below) | `<AmChart config={config} themes={["Animated", "ResponsiveMax"]} />` |
1052
1055
 
1053
- Install the library with the package: `npm install @amcharts/amcharts5 @amcharts/amcharts5-react`. The current web packages need amCharts 5.21.4 or later (peer dependency `^5.21.4`); 5.0.0 worked with 5.21.0 and later. React Native installs only `@amcharts/amcharts5-react-native react-native-webview`: the WebView loads the library from the amCharts CDN.
1056
+ Install the library with the package: `npm install @amcharts/amcharts5 @amcharts/amcharts5-react`. The current web packages need amCharts 5.21.4 or later (peer dependency `^5.21.4`). React Native installs only `@amcharts/amcharts5-react-native react-native-webview`: the WebView loads the library from the amCharts CDN.
1054
1057
 
1055
1058
  ```jsx
1056
1059
  // React. Vue, Angular and Svelte work the same way: your function gets the root.
@@ -1093,8 +1096,8 @@ function Chart({ data }) {
1093
1096
  - **The chart's element needs a height.** The JSON-config components are 400 px high without one.
1094
1097
  - **Deps make the chart again from scratch:** `[data]` in React, `watch` in Vue (what Vue's `watch()` takes; add `deep: true` to also catch `push()`), `[amChartDeps]` in Angular, `deps` in Svelte actions. A Svelte attachment runs again when state read in its own expression changes. To change data without rebuilding, return what you need and use it from `result` (React, Vue), from `(amChartReady)`'s `{ root, result }` (Angular), or from a `$state.raw` variable set in the function (Svelte).
1095
1098
  - **SVG:** `useAmChart(setup, deps, { renderer: "svg" })` in React, `{ renderer: "svg" }` in Vue's options, `[amChartRenderer]="'svg'"` in Angular, and `attachAmChart(setup, { renderer: "svg" })` or `renderer: "svg"` in Svelte's action parameter. The JSON-config components take a `renderer` prop or input.
1096
- - **Themes for the JSON-config components are classes** (`[am5themes_Animated, am5themes_ResponsiveMax]`, not `.new(root)`): themes are not part of a config. A theme with its settings is a pair (5.21.4): `[am5themes_Animated, am5themes_ResponsiveMax, [am5themes_Adaptive, { baseColor: "#4150a0" }]]`. React Native takes theme **names** (`["Animated", "ResponsiveMax", "Dark"]`), and the pair as `["Adaptive", { baseColor: "#4150a0" }]`.
1097
- - **Maps and locales in a JSON config** (5.21.4): the config names its geodata (`"geoJSON": "am5geodata_worldLow"`) and locale (`"am5locales_de_DE"`), and with npm imports those aren't globals, so pass them in the `resources` prop: `<AmChart config={config} resources={{ am5geodata_worldLow }} />` in React (import it from `@amcharts/amcharts5-geodata/worldLow`), `:resources` in Vue, `[resources]` in Angular, and `resources` in Svelte's `attachAmChartConfig({ config, resources })` / `use:amChartConfig`. Without it the map is blank, with a console warning that names the pack. React Native loads the geodata a config names by itself, but not a locale: give it `modules={["locales/de_DE"]}`.
1099
+ - **Themes for the JSON-config components are classes** (`[am5themes_Animated, am5themes_ResponsiveMax]`, not `.new(root)`): themes are not part of a config. A theme with its settings is a pair: `[am5themes_Animated, am5themes_ResponsiveMax, [am5themes_Adaptive, { baseColor: "#4150a0" }]]`. React Native takes theme **names** (`["Animated", "ResponsiveMax", "Dark"]`), and the pair as `["Adaptive", { baseColor: "#4150a0" }]`.
1100
+ - **Maps and locales in a JSON config**: the config names its geodata (`"geoJSON": "am5geodata_worldLow"`) and locale (`"am5locales_de_DE"`), and with npm imports those aren't globals, so pass them in the `resources` prop: `<AmChart config={config} resources={{ am5geodata_worldLow }} />` in React (import it from `@amcharts/amcharts5-geodata/worldLow`), `:resources` in Vue, `[resources]` in Angular, and `resources` in Svelte's `attachAmChartConfig({ config, resources })` / `use:amChartConfig`. Without it the map is blank, with a console warning that names the pack. React Native loads the geodata a config names by itself, but not a locale: give it `modules={["locales/de_DE"]}`.
1098
1101
  - **Give amCharts plain data.** In Vue, keep amCharts objects out of reactive state: use `shallowRef()` for data, or pass `toRaw(data)`. In Svelte 5, use `$state.snapshot(data)`.
1099
1102
  - **License:** call `am5.addLicense("AM5C-…")` once when the app starts, before any chart is made, never in the setup function, because the logo is decided when the root is made. Put it in `main.ts`/`main.jsx`, before `createApp()` or `bootstrapApplication()`. In Next.js, put it at the top of a client component's file; in Nuxt, in a client plugin (`plugins/amcharts.client.ts`); in SvelteKit, in `src/hooks.client.ts`. React Native takes `licenses={["AM5C-…"]}` on each chart.
1100
1103
  - **Errors** thrown in your function go to React's nearest error boundary, Vue's `app.config.errorHandler`, Angular's `ErrorHandler` and `(amChartError)`, and Svelte's `onError` option (an uncaught error without it).
@@ -1174,13 +1177,13 @@ onMount(() => { const root = am5.Root.new(chartdiv); /* ... */ return () => root
1174
1177
  6. **Raw hex strings for colors** — use `am5.color()`.
1175
1178
  7. **Mixing v4 and v5 API** — they are completely incompatible.
1176
1179
  8. **Calling `chart.dispose()` instead of `root.dispose()`** — always dispose root.
1177
- 9. **Using CSS to style chart elements** — amCharts draws on canvas by default; even with `am5.SVGRenderer` (5.21.0) its shapes have no per-element classes, are rewritten on redraw, and exports ignore page CSS. Style through settings, templates and themes.
1180
+ 9. **Using CSS to style chart elements** — amCharts draws on canvas by default; even with `am5.SVGRenderer` its shapes have no per-element classes, are rewritten on redraw, and exports ignore page CSS. Style through settings, templates and themes.
1178
1181
  10. **Wrong package import** — check the package map table above.
1179
1182
  11. **Calling `.each()` on `dataItems`** — `series.dataItems` is a plain array, not an amCharts `List`. Use `am5.array.each(series.dataItems, fn)` or standard `forEach`/`for` loops. Only `series.data` (the `ListData` object) has `.each()`.
1180
- 12. **CDN script load order** — `index.js` must load first, then `xy.js`, then any package that depends on it (`radar.js`, `timeline.js`, `gantt.js`). Wrong order causes runtime errors. Correct order: `index.js`, `xy.js`, then `radar.js` / `timeline.js` / `gantt.js`, then `themes/*.js`. Gantt also needs `plugins/colorPicker.js` before `gantt.js`, or `am5gantt` is undefined. From an npm CDN (5.22.0+) the order and file names are the same under `…/@amcharts/amcharts5@<version>/dist/`; load every file from one pinned version.
1183
+ 12. **CDN script load order** — `index.js` must load first, then `xy.js`, then any package that depends on it (`radar.js`, `timeline.js`, `gantt.js`). Wrong order causes runtime errors. Correct order: `index.js`, `xy.js`, then `radar.js` / `timeline.js` / `gantt.js`, then `themes/*.js`. Gantt also needs `plugins/colorPicker.js` before `gantt.js`, or `am5gantt` is undefined. From an npm CDN the order and file names are the same under `…/@amcharts/amcharts5@<version>/dist/`; load every file from one pinned version.
1181
1184
  13. **No `minorGrid` / `minorTicks` / `minorLabels` objects** — These do not exist on axes. Minor grid is enabled via boolean flags on the **renderer**: `minorGridEnabled: true` and optionally `minorLabelsEnabled: true`. Styling is done through theme rules targeting the `"minor"` tag, not through separate object properties.
1182
1185
  14. **Flow chart animated bullets go on `series.bullets`, NOT `series.links.template.bullets`** — To animate labels/circles flowing along Sankey or Chord links, use `series.bullets.push(function(...) { ... })`. Animate `bullet.locationX` (Sankey) or `bullet.locationY` (Chord) from 0→1 with `loops: Infinity`. Use an adapter on opacity for fade effect. See `references/flow.md` → "Animated bullets along links".
1183
- 15. **`MapPointSeries` needs `latitudeField`/`longitudeField` when your data fields are named anything other than `latitude`/`longitude`** — Since 5.16.1 the series defaults to `latitudeField: "latitude"`, `longitudeField: "longitude"`, so data using exactly those names works with no declaration. Any other naming (`lat`/`lng`, `y`/`x`, …) must be declared or the points silently won't appear: `am5map.MapPointSeries.new(root, { latitudeField: "lat", longitudeField: "lng" })`. Neither is needed with `pushDataItem({ latitude: ..., longitude: ... })`, which passes coordinates directly. On amCharts **older than 5.16.1** there were no defaults, so declare the fields explicitly if you must support those versions.
1186
+ 15. **`MapPointSeries` needs `latitudeField`/`longitudeField` when your data fields are named anything other than `latitude`/`longitude`** — The series defaults to `latitudeField: "latitude"`, `longitudeField: "longitude"`, so data using exactly those names works with no declaration. Any other naming (`lat`/`lng`, `y`/`x`, …) must be declared or the points silently won't appear: `am5map.MapPointSeries.new(root, { latitudeField: "lat", longitudeField: "lng" })`. Neither is needed with `pushDataItem({ latitude: ..., longitude: ... })`, which passes coordinates directly.
1184
1187
  16. **`data.setAll()` does NOT animate — use `data.setIndex()` for animated updates** — When the user asks to update/refresh data with animation, do NOT use `series.data.setAll(newData)` — it replaces everything instantly with no transition. Instead, update each item with `series.data.setIndex(i, newItem)` which triggers smooth value animation. For full replacement with animation, loop: `newData.forEach(function(item, i) { series.data.setIndex(i, item); })`.
1185
1188
  17. **`color.lighten()` / `color.darken()` are NOT instance methods** — `am5.color(0xff0000).lighten(0.3)` does NOT work. Use static methods: `am5.Color.lighten(color, 0.3)` to lighten, `am5.Color.lighten(color, -0.3)` to darken. There is NO `darken()` method — use negative lighten. Also available: `am5.Color.brighten()`, `am5.Color.saturate()`.
1186
1189
  18. **Venn diagram has no `VennDiagram` class** — `am5venn.Venn` is pushed directly into a `Container`, NOT into a chart's `series`. See `references/venn.md`.
@@ -1206,9 +1209,9 @@ onMount(() => { const root = am5.Root.new(chartdiv); /* ... */ return () => root
1206
1209
  38. **Changing a value on a data item moves nothing** — series draw from the working values: set `valueYWorking` (XY) or `valueWorking` (pie) along with the value, or use `series.data.setIndex()`. See "Dynamic data".
1207
1210
  39. **A setting changed after a hover snaps back on unhover** — the `"default"` state keeps the value from before the first hover. Change it there too: `sprite.states.lookup("default")?.set("fill", c)`. See "States".
1208
1211
  40. **`templateField` goes on the template, not on the series** — per-item settings from data rows are read by the elements a template makes: `series.columns.template.set("templateField", "columnSettings")`, likewise `slices.template`, `mapPolygons.template` or a bullet sprite. Set on the series, `templateField` does nothing and every column stays the same. For a pattern per column, see `references/xy.md` → "Different pattern per column".
1209
- 41. **A JSON-config map that draws nothing with npm imports** — the config names its geodata (`"geoJSON": "am5geodata_worldLow"`), and with npm imports there is no global of that name. Pass the pack in `resources` (5.21.4): `JsonParser.parse(config, { parent, resources: { am5geodata_worldLow } })`, `element.resources`, or the framework packages' `resources` prop. The same goes for a locale (`am5locales_de_DE`). Since 5.21.4 a console warning names the missing pack. Before 5.21.4, set `window.am5geodata_worldLow = am5geodata_worldLow` after importing it. A config serialized from such a chart copies the whole pack unless `ChartSerializer` gets the same `resources`.
1212
+ 41. **A JSON-config map that draws nothing with npm imports** — the config names its geodata (`"geoJSON": "am5geodata_worldLow"`), and with npm imports there is no global of that name. Pass the pack in `resources`: `JsonParser.parse(config, { parent, resources: { am5geodata_worldLow } })`, `element.resources`, or the framework packages' `resources` prop. The same goes for a locale (`am5locales_de_DE`). A console warning names the missing pack. A config serialized from such a chart copies the whole pack unless `ChartSerializer` gets the same `resources`.
1210
1213
  42. **An `am5.Graphics` redraws only when `draw` changes** — `graphics.set("draw", fn)` with the function it already has does nothing. Pass a new closure that captures the new points: `graphics.set("draw", (display) => paint(display, points))`.
1211
- 43. **A legend value without a cursor needs `calculateAggregates`** — `legendValueText` is used only under a cursor; otherwise the value label shows `legendRangeValueText`, which has no data item: `{valueY}` is empty there, and `{valueYClose}` (the latest value), `{valueYSum}`, `{valueYHigh}` and the other range values are empty unless the series has `calculateAggregates: true` (no warning, 5.21.5). See `references/xy.md` → Legend.
1214
+ 43. **A legend value without a cursor needs `calculateAggregates`** — `legendValueText` is used only under a cursor; otherwise the value label shows `legendRangeValueText`, which has no data item: `{valueY}` is empty there, and `{valueYClose}` (the latest value), `{valueYSum}`, `{valueYHigh}` and the other range values are empty unless the series has `calculateAggregates: true` (no warning). See `references/xy.md` → Legend.
1212
1215
  44. **`#,###` does not round** — a number format without a `.` keeps every decimal (`6,708.044000000005` while animating); end it with `.` for whole numbers (`'#,###.'`) or give the decimals (`'#,###.00'`). Every number placeholder also gets a thousands separator, so `{year}` shows `2,024`: use `{year.formatNumber('#')}`. Sections are split by `|`, not `;`. See "Number formats".
1213
1216
 
1214
1217
  ## Easing functions
@@ -1235,7 +1238,7 @@ sprite.animate({
1235
1238
  easing: am5.ease.out(am5.ease.cubic)
1236
1239
  });
1237
1240
 
1238
- // Name <-> function (5.20.8)
1241
+ // Name <-> function
1239
1242
  am5.ease.byName("cubic", "out"); // same as am5.ease.out(am5.ease.cubic); unknown name -> linear
1240
1243
  am5.ease.easingInfo(am5.ease.yoyo(am5.ease.sine)); // { easing: "sine", yoyo: true }
1241
1244
  ```
@@ -1254,24 +1257,24 @@ Skip this step entirely if you cannot execute code (e.g., chat-only context with
1254
1257
 
1255
1258
  ## Recent API changes
1256
1259
 
1257
- Latest release covered here: **5.22.0** (2026-11-16), with geodata 5.2.0, and the framework packages react 5.0.1, vue 5.0.2, angular 5.0.1, svelte 5.0.3 (2026-10-23) and react-native 5.0.3 (2026-11-16). These are the renames, new settings and behavior changes that code written from older knowledge most often gets wrong — prefer these names/settings. For exact types and defaults, use the typings (`*.d.ts`) or the amCharts MCP server's `get_api_reference`, which is generated from them; for anything newer, verify against the live docs (see next section).
1260
+ Latest release covered here: **5.22.0** (2026-11-16), with geodata 5.2.0, and the framework packages react 5.0.1, vue 5.0.2, angular 5.0.1, svelte 5.0.3 and react-native 5.0.3. These are the renames, new settings and behaviors that code written from older knowledge most often gets wrong — prefer these names/settings. For exact types and defaults, use the typings (`*.d.ts`) or the amCharts MCP server's `get_api_reference`, which is generated from them; for anything newer, verify against the live docs (see next section).
1258
1261
 
1259
1262
  **Renamed settings (old name still works but is deprecated — use the new one):**
1260
1263
 
1261
- | Class(es) | Old | New | Since |
1262
- |-----------|-----|-----|-------|
1263
- | `MovingAverage`, `MovingAverageDeviation`, `MovingAverageEnvelope`, `BollingerBands` | `type` | `maType` | 5.18.0 |
1264
- | `VoronoiTreemap` | `type` | `shapeType` | 5.18.0 |
1264
+ | Class(es) | Old | New |
1265
+ |-----------|-----|-----|
1266
+ | `MovingAverage`, `MovingAverageDeviation`, `MovingAverageEnvelope`, `BollingerBands` | `type` | `maType` |
1267
+ | `VoronoiTreemap` | `type` | `shapeType` |
1265
1268
 
1266
1269
  ```js
1267
1270
  // Moving-average indicators: use maType, not type
1268
1271
  am5stock.MovingAverage.new(root, { maType: "exponential", period: 20 });
1269
- am5hierarchy.VoronoiTreemap.new(root, { shapeType: "rectangle" }); // was: type
1272
+ am5hierarchy.VoronoiTreemap.new(root, { shapeType: "rectangle" }); // not type
1270
1273
  ```
1271
1274
 
1272
- **Breaking change — WordCloud internals (5.20.1):** the layout is now computed synchronously in one pass (much faster). The per-data-item `ghostLabel` is gone and labels live in an internal container, so `dataItem.get("ghostLabel")` and any code walking `series.children` to find labels must be updated — use `series.labels` / `dataItem.get("label")` instead.
1275
+ **WordCloud labels:** the layout is computed synchronously in one pass. There is no per-data-item `ghostLabel`, and labels live in an internal container, so reach them with `series.labels` / `dataItem.get("label")`, not by walking `series.children`.
1273
1276
 
1274
- **Framework packages (5.0.0, 2026-10-22):** `@amcharts/amcharts5-react`, `@amcharts/amcharts5-vue`, `@amcharts/amcharts5-angular`, `@amcharts/amcharts5-svelte` and `@amcharts/amcharts5-react-native`. They make and dispose the chart with the component and work with server rendering. Prefer them over hand-written `Root.new()`/`dispose()` code in those frameworks. See "Frameworks".
1277
+ **Framework packages:** `@amcharts/amcharts5-react`, `@amcharts/amcharts5-vue`, `@amcharts/amcharts5-angular`, `@amcharts/amcharts5-svelte` and `@amcharts/amcharts5-react-native`. They make and dispose the chart with the component and work with server rendering. Prefer them over hand-written `Root.new()`/`dispose()` code in those frameworks. See "Frameworks".
1275
1278
 
1276
1279
  **New in 5.22.0 (2026-11-16):**
1277
1280
  - **Script files on npm CDNs:** the npm package has the script files in `dist/`, so jsDelivr and unpkg serve them (see "Plain HTML, no bundler"). Geodata 5.2.0 has `dist/` too, on unpkg.
@@ -1281,198 +1284,92 @@ am5hierarchy.VoronoiTreemap.new(root, { shapeType: "rectangle" }); // was: type
1281
1284
  - Bounds with `right` less than `left`, or past ±180, cross the date line. On a flat map the two sides meet only with a rotation passed, e.g. `zoomToGeoBounds(bounds, 500, -180)`.
1282
1285
  - A `zoomToGeoBounds()`, `zoomToDataItem()` or `zoomToGeoPoint()` call before the map is drawn zooms once it is.
1283
1286
  - Zooms keep `rotationZ`.
1284
- - Two `zoomToGeoPoint()` or `zoomToPoint()` calls in a row without animation end in the right place.
1285
1287
  - **Maps, data:**
1286
- - GeoJSON feature properties are read as data fields: with `valueField: "value"` set, a custom GeoJSON with `"properties": { "value": 12 }` gives each polygon its value without data rows, and heat rules their range. `"properties": null` no longer throws.
1287
- - A series with heat rules whose `geoJSON` is set later (a drill-down) draws.
1288
+ - GeoJSON feature properties are read as data fields: with `valueField: "value"` set, a custom GeoJSON with `"properties": { "value": 12 }` gives each polygon its value without data rows, and heat rules their range.
1288
1289
  - When `include` and `exclude` both list an item, `exclude` wins.
1289
- - The `zoomControl` is no longer drawn twice.
1290
- - A map with panning and `pinchZoom` off no longer blocks page scrolling on touch screens.
1291
- - **Heat rules:** values outside `minValue` / `maxValue` get `min` / `max` instead of going past the ends. On a `logarithmic` rule, zero and below get `min`.
1290
+ - A map with panning and `pinchZoom` off lets the page scroll on touch screens.
1291
+ - **Heat rules:** values outside `minValue` / `maxValue` get `min` / `max`. On a `logarithmic` rule, zero and below get `min`.
1292
1292
  - **Number formats:** a modifier right after the digits, as in `#,###s`, keeps the thousands separator.
1293
- - **ValueAxis:** a `logarithmic` axis with `min: 0` starts at `treatZeroAs`, or where the data starts, instead of drawing nothing.
1294
- - **Colors and drawing:**
1295
- - `LinearGradient` takes any `rotation` (5.20.8 to 5.21.5 drew only 0 to 90).
1296
- - An empty `ColorSet` `colors` list starts from `baseColor` instead of crashing.
1297
- - A `PicturePattern` the size of its picture shows it.
1298
- - `drawEllipse(x, y, …)` draws at x, y.
1299
- - **Series and bullets:**
1300
- - Bullets that take the series color follow it when it changes.
1301
- - Setting `minBulletDistance` back to 0 shows the bullets again.
1302
- - `data.setIndex()` and `updateData()` apply the row's `templateField` settings.
1303
- - **Pie labels:** a label hidden with `forceHidden` no longer leaves a gap in its column. `PyramidSeries` and `PictorialStackedSeries` with `alignLabels: false` keep their labels on their slices.
1304
- - **Gantt:** charts with many tasks load several times faster and scroll two to three times as fast. The date rows' labels use `keepInView`, and on a narrow chart a view of two to four weeks shows months in the top row instead of labels on top of each other.
1305
- - **Hierarchy:** after `data.setAll()`, a `VoronoiTreemap` draws again, and a drilled-down Treemap or Sunburst shows the new data from the top.
1306
- - **Word cloud:** a number as a category (a year) no longer throws, but shows formatted, `2,025`. See `references/wordcloud.md`.
1293
+ - **ValueAxis:** a `logarithmic` axis with `min: 0` starts at `treatZeroAs`, or where the data starts.
1294
+ - **Gantt:** the date rows' labels use `keepInView`, and on a narrow chart a view of two to four weeks shows months in the top row.
1295
+ - **Hierarchy:** after `data.setAll()`, a drilled-down Treemap or Sunburst shows the new data from the top.
1296
+ - **Word cloud:** a number as a category (a year) shows formatted, `2,025`, so pass years as strings. See `references/wordcloud.md`.
1307
1297
  - **Right to left:**
1308
1298
  - `am5.Root.new("chartdiv", { direction: "rtl" })` draws text right to left and lays out legends from the right. See "Legend".
1309
1299
  - Containers take `direction: "rtl"`, which lays out a horizontal or grid layout from right to left and lines a vertical layout's children up on the right.
1310
- - On a `dir="rtl"` page, labels are placed right as well as drawn right to left (each sat off by its own width).
1300
+ - On a `dir="rtl"` page, labels are placed and drawn right to left.
1311
1301
  - A `Label` with a `width` keeps its text inside its box for every `textAlign` and `direction`.
1312
- - **Text:** font names with spaces, and font lists such as `[fontFamily: 'Source Code Pro', monospace]`, are read right. Center- or right-aligned wrapped text no longer draws its bold or colored parts out of place.
1302
+ - **Text:** font names with spaces, and font lists such as `[fontFamily: 'Source Code Pro', monospace]`, work in text markup.
1313
1303
  - **TypeScript:** `am5.IGraphics` and `am5.Animation` work as types.
1314
- - **Size:** the script builds are smaller (`index.js` by about 50 KB, 10 KB gzipped), and they no longer define the global `regeneratorRuntime`. The npm package installs only the d3 modules it uses, not the whole `d3`.
1315
- - **Geodata 5.2.0:** Nauru is named "Naoero" (on the CDN since 5.20.2); its id `NR` is unchanged.
1316
- - react-native 5.0.3 loads 5.22.0, so its `themes` take `"ResponsiveMax"` too.
1317
-
1318
- **New in 5.21.5 (2026-10-26):**
1319
- - `am5.renderToSVG()` writes SVG that design tools such as Figma read correctly, and its new option `includeNonExportable` also writes elements marked `exportable: false`. See "SVG export".
1320
- - JSON: theme colors in data (e.g. a column's `fill` from a `templateField`), and colors a color set makes after its theme's list runs out, are saved as references (`"@colors.getIndex(n)"`, `"@root.interfaceColors.get(...)"`), so they follow the theme the config is parsed with.
1321
- - Fixed: color sets of one chart that made more colors than their theme's list could repeat colors another set had already made. With `am5themes_Adaptive`, JSON saved the palette's first color as the primary button color.
1322
- - npm: a bare `import "@amcharts/amcharts5/element"` defines `<am5-chart>` with esbuild too. `defineChartElement()` still works.
1323
- - react-native 5.0.2 loads 5.21.5.
1324
-
1325
- **New in 5.21.4 (2026-10-23):**
1326
- - `resources` gives a JSON config the geodata and locales it names (`"geoJSON": "am5geodata_worldLow"`, `"locale": "am5locales_de_DE"`) when they aren't globals, as with npm imports. It's taken by:
1327
- - `JsonParser.parse(config, { parent, resources: { am5geodata_worldLow } })`;
1328
- - `ChartSerializer.new(root, { resources })`, which then writes those packs by name instead of copying them whole;
1329
- - `<am5-chart>` (`element.resources`);
1330
- - the framework packages' `resources` prop.
1331
-
1332
- A name that can't be found now logs a warning. Before, the map was just blank. See "Serializing to JSON" and `references/json.md`.
1333
- - `<am5-chart>` and the framework packages take a theme with its settings: `[am5themes_Adaptive, { baseColor: "#4150a0" }]`. The `themes` attribute takes the same as JSON: `themes='["Animated", ["Adaptive", { "baseColor": "#4150a0" }]]'`.
1334
- - The framework packages' new versions (react 5.0.1, vue 5.0.2, angular 5.0.1, svelte 5.0.3, react-native 5.0.1) have both, and the web ones need amCharts 5.21.4 or later.
1335
-
1336
- **New in 5.21.3 (2026-10-21):**
1337
- - `ColorSet` `repeatLightness`: themes that reuse their colors (Adaptive, Monochrome, Kelly, Material, Nord, Pastel and others, but not Colorblind or Patterns) now make each repeat of the list 10% lighter. For the old behavior, set `repeatLightness: 0` through a theme rule, `rule("ColorSet").set("repeatLightness", 0)`: the color sets of a root share one list. In the Adaptive and Monochrome theme settings, use `false`. See "ColorSet".
1338
- - JSON: palette colors are written as `"@colors.getIndex(n)"`, so they follow the theme the config is parsed with. A `step` or `passOptions` set on a chart's colors round-trips without the theme's palette. Data-item loops that differ per item are saved per item. See "Serializing to JSON".
1339
- - Maps: d3 projections with a shape of their own (HEALPix, Armadillo, Berghaus, interrupted and polyhedral) display properly, and switching projections at zoom level 1 shows the whole map again.
1340
-
1341
- **New in 5.21.2 (2026-10-14):**
1342
- - Interface color `warning`: a yellow between `negative` and `positive` (default `#f2c230`; themes with their own `positive`/`negative` have a matching one), for the middle of a bad-to-good scale: `root.interfaceColors.get("warning")`.
1343
- - `am5.Color.interpolateColors(position, colors, mode?)`: a color on a scale through any number of colors, evenly spaced (`position` 0–1, clamped; `mode` `"rgb"` (default) or `"hsl"`). Through `[negative, warning, positive]` it avoids the brown middle of `Color.interpolate(t, negative, positive)`. See "Colors".
1344
- - Heat rules: `stops` (numbers, percents or colors, all of one kind) in place of `min`/`max`, for a scale through more than two values. `HeatLegend`: `colors` in place of `startColor`/`endColor`, a gradient through them with `stepCount: 1` or one step per color otherwise (`stepCount` is then ignored). See "Heat rules".
1345
- - `am5themes_Adaptive` and `am5themes_Monochrome`: `interleave`, `mapShade` and `keepContrast` (all off by default). See "Parameterized themes".
1346
- - Fixed: a ColorSet `step` with a theme that reuses its colors used only two or three of them (word clouds and treemaps with Nord, Pastel or Adaptive), see "ColorSet"; `RadialGradient` with pixel `x`/`y` was off-center on radar fills and similar shapes in 5.21.1.
1347
-
1348
- **Behavior changes / fixes (5.21.1, 2026-10-13)** — no workaround needed any more:
1349
- - `root.timezone`: charts were up to 16 times slower with it, and grid, labels, data groups and date math could be an hour off around a daylight saving change. A `DateAxis` grid of several hours now stays on the clock after a DST change (where the clocks skip a grid time, the line goes at the jump). `PeriodSelector` and `DateRangeSelector` follow `root.timezone`/`root.utc` (they used the viewer's time zone). Date formats `Z`, `ZZ`, `x`, `i`, `I` are right with `root.timezone`, and `YYYY`, `ww`, `W`, `DDD` honor `root.utc`.
1350
- - `DataProcessor`: string dates in `dateFields` without a `dateFormat` were all read as 1 January 1970. Now the browser's `Date` parses them, and a date-only `"2024-03-15"` is midnight UTC. See "Data processor".
1351
- - A chart in a container scaled with CSS (`transform` or `zoom`) was scaled twice, and clicks hit the wrong elements.
1352
- - Maps: a `zoomLevel` set before the map loaded was ignored or left the map blank; `MapSankeySeries` bands follow `linkColorMode` and node fill changes, and nodes without coordinates are drawn; raised map lines (`MapLine` `altitude`) draw 3–4 times faster.
1353
- - `RadialGradient` is centered on map polygons, line and area fills and bullets (with `target` set, on the target). `Picture`: changing a shadow setting after the image loaded no longer removes the image. `CurveChart`: a path scaled down to fit no longer gets far too many labels and grid lines. Responsive theme: XY axis ticks on small charts are no longer moved inside the plot.
1354
-
1355
- **New in 5.21.0 (2026-10-08):**
1356
-
1357
- *Rendering, export, chart element*
1358
- - SVG rendering: `renderer: am5.SVGRenderer` in `Root.new()` settings (only when the root is created), or `am5.Root.defaultRenderer = am5.SVGRenderer` before creating roots. Canvas stays the default; charts look and behave the same; blend modes `DST_OVER`, `SRC_ATOP` and `XOR` are canvas-only. See "Root element setup".
1359
- - `am5.renderToSVG(rootOrElement, options?)` — SVG markup of the chart (or of one element, e.g. `pixelSeries.pixels`) as last drawn, from either renderer; screen readers read it as one image named by `title` / the Root `ariaLabel`. Exporting plugin: `"svg"` format (`download("svg")`, `getSVG()`, `exportSVG()`, `svgOptions`), listed in `ExportingMenu` by default. See "Exporting".
1360
- - `<am5-chart>` element — a chart from a JSON config (`config` or `src`), with `themes` and `renderer="svg"`; load `element.js` after `plugins/json.js`, or with npm import `defineChartElement` from `@amcharts/amcharts5/element` and call it. See "Serializing to JSON".
1361
- - The npm package now ships `AGENTS.md`, `docs/` (a bundled copy of these notes, possibly older) and `examples/<name>/index.ts` (62 also as `config.json`; `examples/examples.json` lists what each shows) — when the package is installed, those examples are verified starting points.
1362
-
1363
- *Maps* (details and snippets in `references/map.md`)
1364
- - `am5map.MapRasterSeries` — a whole-world equirectangular image (e.g. `https://cdn.amcharts.com/lib/5/geodata/images/earthDay2048.jpg`) reprojected as the map turns and zooms (WebGL2 where it can); `nightSrc` + `sunDate`/`sunPosition` show day and night.
1365
- - `am5map.NightSeries` — shades the night side in twilight steps and shows the sun: `sunDate` (`"now"`, timestamp, date string or `Date`) or `sunPosition`; `sunAltitude` (metres) keeps the sun in view past a globe's edge. `am5map.getSunPosition(date?)` returns the `{ longitude, latitude }` where the sun is overhead.
1366
- - `am5map.PixelMapSeries` — polygons drawn as a grid of pixels (`pixelType`, `step`, `uniform`, `columnHeight` with `MapPolygon` `pixelHeight`, or the series' `pixelHeightFunction`); heat rules, states and tooltips work as on `MapPolygonSeries`.
1367
- - `MapLine` `altitude` (metres; each leg arcs) and `MapPointSeries` `altitudeField` (no default) raise lines and points; `MapPointSeries` `surfaceBullets` lays bullets on the map surface; `MapChart` `autoHome` goes home once loaded; `MapPolygonSeries` `clickZoom` zooms to a clicked polygon and back.
1368
-
1369
- *Core*
1370
- - `autoAppear` / `appearDuration` / `appearDelay` on every element — `appear()` as settings, so JSON configs get the opening animation. See "Animations".
1371
- - `Root` `forcedColors` (default `true`) — interface colors follow Windows High Contrast. See "Accessibility".
1372
- - `Scrollbar` `outsideAxes` — `true` puts a chart's scrollbar beyond the axes on its side, `false` between them and the plot; unset, the chart decides. Only for `scrollbarX`/`scrollbarY`. See `references/ui-elements.md`.
1373
- - `ChartSerializer`/`JsonParser`: colors from `root.interfaceColors` are saved as `"@root.interfaceColors.get('…')"` references (they follow the theme the config is parsed with); data-item loops, hidden series, elements added to plot/axis containers, `Date` values and more are now saved. See "Serializing to JSON".
1374
- - Accessibility: `ariaExpanded` setting, `Modal` `ariaLabel`, keyboard changes (ESC, SPACE, arrows in draggable groups). See "Accessibility".
1375
- - New locale prompts, translated in all locales: "OK", "Cancel", "Delete", "Settings", "Expand", "Move Up", "Move Down".
1376
-
1377
- **Behavior changes (5.21.0)** — existing code may now render or act differently:
1378
- - A hidden element (`visible: false`, `forceHidden` or `hide()`) no longer takes up space in a container sized to its content — e.g. a hidden XY scrollbar no longer leaves an empty band above the plot.
1379
- - `DataProcessor` `emptyAs` replaces only `null`, `undefined` and `""` — no longer `0` and `false`.
1380
- - `Label` `fillOpacity: 0` now hides the text (it was ignored). `strokeWidth: 0` now draws no line (was 1 px) and `shadowOpacity: 0` no shadow (was a full one).
1381
- - Heat rules: `minValue: 0` / `maxValue: 0` are honored (the data's lowest/highest value was used instead).
1382
- - Bullets with `stacked: "up"` (or `"auto"` in the lower half) on a vertical series stack instead of overlapping.
1383
- - `calculateAggregates` on non-XY series (pie, map heat maps): `valueChange`, `valueChangePercent` and the like are numbers now (were `NaN`), and right on bubble series.
1384
- - `Gantt`: the category axis' `colorField` and `nameField` are honored (bar colors were always read from `color`).
1385
- - `Sunburst` ignores `singleBranchOnly` (always `true`). `StockToolbar` `focusable` now defaults to `true`.
1386
- - Responsive theme: minor axis labels are hidden only on charts 600 px or smaller (was 1000 px), so turned-on minor labels show on mid-size charts.
1387
- - `PatternSet` starts over from its first pattern past the end of its list (elements after the 17th got no pattern).
1388
- - `DurationFormatter`: codes `H`, `D`, `Y`, `K`, `k`, `n` work (as `h`, `d`, `y`, `h`, `h`, `S` — e.g. `"HH:mm:ss"` gave `NaN`); durations between a month and a year use the month formats again (`1m 15d 00:00:00`, not `45d 00:00:00`), which `DurationAxis` labels show.
1389
- - `am5.CSVParser` honors `skipEmpty: false` (empty lines were always skipped). `series.updateData([])` removes every data item (it kept the first).
1390
- - A `fontSize` given as a number in a string (`"8"`) counts as pixels (was ignored). Filters (`brightness`, `saturate`, `blur`, …) combine instead of replacing each other, and one set back to neutral turns off.
1391
- - A logarithmic `ValueAxis` with values ≤ 0 logs a console warning pointing to `treatZeroAs` (it silently drew nothing).
1392
- - `am5.Color.alternative(color)` without light/dark colors returns black for light colors (it always returned white). Date format `YYYY` is right west of UTC. `Label` `maxChars` cut at a word boundary uses the `ellipsis` setting.
1393
- - Exporting: CSV/HTML with `pivot: true` follow `dataFieldsOrder` (were reversed); HTML `headerClass` is applied; `maxHeight` shrinks the image.
1394
- - Fixes that remove old workarounds (details in the references): map `goHome()` before the map is ready or on a globe, `zoomToGeoBounds()` duration and bounds, dragging a zoomed map to its edges, `lineType` changes; `innerRadius: am5.percent(0)` on pie/radar/gauge; `AxisRendererRadial` negative `radius`; `SmoothedRadarLineSeries` `tension`, `ForceDirected` forces, `Partition`/`Sunburst` `nodePadding`, `Sunburst` angles and `Chord` `sort: "none"` changed after drawing; `WordCloud` word filtering (`minValue` / `minWordLength` / `excludeWords`); stock indicator column colors; `GaplessDateAxis` with grouped data and `root.timezone`.
1395
-
1396
- **Behavior changes / fixes (5.20.6 – 5.20.8)** — no workaround needed any more:
1397
- - `CategoryAxis` (5.20.6): series data no longer has to follow the axis-category order for every item to be drawn (e.g. Gantt-like column charts sorted by date). Line series still connect points in data order.
1398
- - Logarithmic `ValueAxis` over a wide range labels its grid with round powers of ten (5.20.6).
1399
- - Content added to an `axisHeader` after the chart is built (e.g. a legend) now makes the axis leave room instead of covering it (5.20.7).
1400
- - A `Container`'s `background` with its own `templateField` now reads the container's data item (5.20.7), so a per-bullet label background works: `am5.Label.new(root, { text: "{valueY}", populateText: true, background: am5.RoundedRectangle.new(root, { templateField: "labelBg" }) })` with `labelBg: { fill: am5.color(0xff0000) }` in the data row.
1401
- - `am5.CSVParser.parse("")` no longer loops until "Invalid array length" (5.20.7) — an empty server response is safe. It returns `[]` with `useColumnNames: true`, but `[{}]` (one empty row) with default options, so check for that before `data.setAll()`.
1402
- - JSON: `JsonParser` resolves references that point further down the config, and user `themeTags` are serialized — see *JSON config / serialization* below.
1403
-
1404
- **New settings / methods worth knowing:**
1405
-
1406
- *Declared animations, links, map points on lines (5.20.6 – 5.20.8)*
1407
- - `animations` setting on **every** element (5.20.8): an array of `IDeclaredAnimation` entries `{ key, from?, to, duration, delay?, loops?, yoyo?, easing?, ease?, target? }` — animations described as data (`loops: 0` = forever, `easing` by **name**, `target: "dataItem"` for data-item values). Round-trips through JSON. `IDeclaredAnimation` is not exported from the package index. See "Animations" above for the snippet, defaults and the `from` caveat.
1408
- - `am5.ease.byName(name, mode?)` / `am5.ease.easingInfo(fn)` (5.20.8) — easing function ↔ name; only the 8 named base easings (and `out`/`inOut`/`yoyo` of them) have names. See "Easing functions" above.
1409
- - `ChartSerializer`: `runningAnimations` (5.20.8, default `true`) — saves endless code-started loops as `animations` entries. See "Serializing to JSON" above.
1410
- - `Series` links (5.20.7): `urlField` (no default — links are off until set) names the data field holding a URL; the data item's `url` field gets it. Clicking the item's bullet (any series), column (`ColumnSeries`, candlestick, OHLC, Gantt…), slice (pie, funnel, pyramid, pictorial, Venn), `MapPolygon` or `MapLine` opens it in `linkTarget` (default `"_self"`; `"_blank"` opens with `noopener`; a chart inside an iframe usually wants `"_blank"` or `"_top"`). `cursorOverStyle: "pointer"` is set automatically unless you set one. `javascript:`/`data:`/`vbscript:` URLs are never opened. Override `series.openUrl(dataItem)` to intercept clicks. `urlField` can be set after the data, and a URL added later (`data.setIndex()`) links too. **Not linked:** hierarchy nodes, flow nodes/links, word-cloud labels, `MapSankeySeries` nodes.
1411
- - `MapPointSeries` (5.20.6): `lineIdField` (default `"lineId"`), `positionOnLineField` (`"positionOnLine"`), `autoRotateField` (`"autoRotate"`), `autoRotateAngleField` (`"autoRotateAngle"`) — a point on a line can be a plain data row `{ lineId: "jfk-lhr", positionOnLine: 0.5, autoRotate: true }` instead of `pushDataItem({ lineDataItem, positionOnLine })`, so it is saved by `ChartSerializer`. Data values of `autoRotate`/`autoRotateAngle` win over the bullet's. See `references/map.md`.
1412
- - `MapPointSeries` (5.20.8): an auto-rotating point turns round to face its travel direction on the way back — **only** while a bullet-sprite `animations` entry (`target: "dataItem"`, `key: "positionOnLine"`, e.g. with `yoyo: true`) moves it toward the line start. A point moved by `dataItem.animate()` in code is not flipped; that code must turn it.
1304
+ - **Geodata 5.2.0:** Nauru is named "Naoero"; its id is `NR`.
1305
+ - react-native 5.0.3 loads 5.22.0, so its `themes` take `"ResponsiveMax"`.
1306
+
1307
+ **Settings and methods worth knowing** (newer than most training data):
1308
+
1309
+ *Declared animations, links, map points on lines*
1310
+ - `animations` setting on **every** element: an array of `IDeclaredAnimation` entries `{ key, from?, to, duration, delay?, loops?, yoyo?, easing?, ease?, target? }` — animations described as data (`loops: 0` = forever, `easing` by **name**, `target: "dataItem"` for data-item values). Round-trips through JSON. `IDeclaredAnimation` is not exported from the package index. See "Animations" above for the snippet, defaults and the `from` caveat.
1311
+ - `am5.ease.byName(name, mode?)` / `am5.ease.easingInfo(fn)` — easing function ↔ name; only the 8 named base easings (and `out`/`inOut`/`yoyo` of them) have names. See "Easing functions" above.
1312
+ - `ChartSerializer`: `runningAnimations` (default `true`) — saves endless code-started loops as `animations` entries. See "Serializing to JSON" above.
1313
+ - `Series` links: `urlField` (no default — links are off until set) names the data field holding a URL; the data item's `url` field gets it. Clicking the item's bullet (any series), column (`ColumnSeries`, candlestick, OHLC, Gantt…), slice (pie, funnel, pyramid, pictorial, Venn), `MapPolygon` or `MapLine` opens it in `linkTarget` (default `"_self"`; `"_blank"` opens with `noopener`; a chart inside an iframe usually wants `"_blank"` or `"_top"`). `cursorOverStyle: "pointer"` is set automatically unless you set one. `javascript:`/`data:`/`vbscript:` URLs are never opened. Override `series.openUrl(dataItem)` to intercept clicks. `urlField` can be set after the data, and a URL added later (`data.setIndex()`) links too. **Not linked:** hierarchy nodes, flow nodes/links, word-cloud labels, `MapSankeySeries` nodes.
1314
+ - `MapPointSeries`: `lineIdField` (default `"lineId"`), `positionOnLineField` (`"positionOnLine"`), `autoRotateField` (`"autoRotate"`), `autoRotateAngleField` (`"autoRotateAngle"`) — a point on a line can be a plain data row `{ lineId: "jfk-lhr", positionOnLine: 0.5, autoRotate: true }` instead of `pushDataItem({ lineDataItem, positionOnLine })`, so it is saved by `ChartSerializer`. Data values of `autoRotate`/`autoRotateAngle` win over the bullet's. See `references/map.md`.
1315
+ - `MapPointSeries`: an auto-rotating point turns round to face its travel direction on the way back — **only** while a bullet-sprite `animations` entry (`target: "dataItem"`, `key: "positionOnLine"`, e.g. with `yoyo: true`) moves it toward the line start. A point moved by `dataItem.animate()` in code is not flipped; that code must turn it.
1413
1316
 
1414
1317
  *Themes & styling*
1415
- - 20+ new themes (5.20.0): `Midnight`, `Ember`, `Nord`, `Pastel`, `Colorblind`, `Patterns`, `Petroleum`, `Savanna`, plus `*Dark` variants of most palettes. Two parameterized factory themes, `Monochrome` and `Adaptive` — see "Parameterized themes" above.
1416
- - New fill patterns (5.20.0): `am5.StarPattern` (`radius`, `innerRadius`, `spikes`, `gap`, `checkered`) and `am5.TrianglePattern` (`maxWidth`, `maxHeight`, `gap`, `checkered`).
1417
- - `rotateShapes` (5.20.0) on `RectanglePattern`/`StarPattern`/`TrianglePattern`: `rotation` then spins each shape around its own center instead of the whole grid — tiles seamlessly and is much faster. Prefer it over a whole-pattern `rotation` on large tiles.
1418
- - `Series`: `fillGradient` / `strokeGradient` settings, handed to bullets (the series' own fills, lines and columns don't use them: set gradients on `fills.template` / `columns.template` / `strokes.template`). A bullet `Graphics` with no paint of its own (`fill`, `fillGradient`, `fillPattern`, `stroke`, `strokeGradient`) now inherits all of them from its series — and on pie, funnel, flow and hierarchy charts, from its own slice/node (5.20.0–5.20.1).
1318
+ - Palette themes: `Midnight`, `Ember`, `Nord`, `Pastel`, `Colorblind`, `Patterns`, `Petroleum`, `Savanna`, plus `*Dark` variants of most palettes. Two parameterized factory themes, `Monochrome` and `Adaptive` — see "Parameterized themes" above.
1319
+ - Fill patterns `am5.StarPattern` (`radius`, `innerRadius`, `spikes`, `gap`, `checkered`) and `am5.TrianglePattern` (`maxWidth`, `maxHeight`, `gap`, `checkered`).
1320
+ - `rotateShapes` on `RectanglePattern`/`StarPattern`/`TrianglePattern`: `rotation` then spins each shape around its own center instead of the whole grid — tiles seamlessly and is much faster. Prefer it over a whole-pattern `rotation` on large tiles.
1321
+ - `Series`: `fillGradient` / `strokeGradient` settings, handed to bullets (the series' own fills, lines and columns don't use them: set gradients on `fills.template` / `columns.template` / `strokes.template`). A bullet `Graphics` with no paint of its own (`fill`, `fillGradient`, `fillPattern`, `stroke`, `strokeGradient`) inherits all of them from its series — and on pie, funnel, flow and hierarchy charts, from its own slice/node.
1419
1322
 
1420
1323
  *XY charts*
1421
1324
  - `XYChart`: `strokeWidths` (array of pixel widths) and `strokeDasharrays` (array of dash arrays) — cycled across line series as they are added, exactly like `colors`. Lets series be told apart without relying on color, e.g. with the `Patterns` theme.
1422
1325
  - `XYCursor`: `clickTolerance` (default `0`) — how many pixels outside the plot area a press may start and still begin a zoom/selection. The selection itself still starts at the plot edge.
1423
- - `XYSeries`: a value field (`valueYField`, `openValueYField`, …) can now be changed after creation — re-set the series data afterwards for it to take effect. A series can also be reassigned to a different `xAxis`/`yAxis` after creation.
1424
- - Column series (`ColumnSeries`, `CandlestickSeries`, `OHLCSeries`, …) (5.20.4): `colorByDataItem: true` (default `false`) gives each column its own color from the series' new `colors` (`ColorSet`) setting — the series makes its own `ColorSet` if none is given. The color lands on the data item's `fill` field. Prefer this over the old "adapter on `columns.template` `fill`" recipe: it is declarative and survives JSON serialization.
1425
- - `Scrollbar` (5.20.2): `opposite: true` (default `false`) puts a chart's `scrollbarX` **below** the plot and `scrollbarY` to the **left**, instead of above / right. Only affects scrollbars set via `chart.set("scrollbarX"/"scrollbarY", …)`. This is a **different** setting from the long-standing `opposite` on `AxisRendererX`/`AxisRendererY`.
1326
+ - `XYSeries`: a value field (`valueYField`, `openValueYField`, …) can be changed after creation — re-set the series data afterwards for it to take effect. A series can also be reassigned to a different `xAxis`/`yAxis` after creation.
1327
+ - Column series (`ColumnSeries`, `CandlestickSeries`, `OHLCSeries`, …): `colorByDataItem: true` (default `false`) gives each column its own color from the series' `colors` (`ColorSet`) setting — the series makes its own `ColorSet` if none is given. The color lands on the data item's `fill` field. Prefer this over an adapter on `columns.template` `fill`: it is declarative and survives JSON serialization.
1328
+ - `Scrollbar`: `opposite: true` (default `false`) puts a chart's `scrollbarX` **below** the plot and `scrollbarY` to the **left**, instead of above / right. Only affects scrollbars set via `chart.set("scrollbarX"/"scrollbarY", …)`. This is a **different** setting from `opposite` on `AxisRendererX`/`AxisRendererY`.
1426
1329
 
1427
- *WordCloud (5.20.1)*
1330
+ *WordCloud*
1428
1331
  - `svgPath` arranges words into a shape (experimental), with `maskByShape` to clip them to the outline and `shapeTolerance` to control spill (negative = padding inside). See `references/wordcloud.md`.
1429
1332
  - `randomizeAngles: false` cycles `angles` in order for a reproducible layout; `allowNesting: false` packs words as non-overlapping bounding boxes (use it when labels have opaque backgrounds).
1430
- - `angles` now accepts **any** angle (e.g. `[0, -30, -45]`). Before 5.20.1 only `0`/`±90` were handled, and the old docs said so explicitly — that restriction is gone.
1333
+ - `angles` accepts **any** angle (e.g. `[0, -30, -45]`).
1431
1334
 
1432
1335
  *Core / events*
1433
- - New `globalpointerdown` event on all elements — fires on a press anywhere on the chart surface, mirroring `globalpointermove`/`globalpointerup`.
1434
- - `Root`: `sanitizeHTML` (5.19.0, default `true`) — dynamically-set HTML (`html`/`labelHTML`, HTML tooltips, modal content) is sanitized; set `false` in code to opt out. Since 5.22.0 a JSON config's `root` section can't turn it off unless parsed with `trusted: true`. Exports gained `escapeFormulas` (default `true`) to guard CSV/XLSX against formula injection.
1435
- - `Root`: `ariaLabel` is now applied to the `<div>` holding the chart's focusable elements (5.20.0).
1436
- - `Label`: `oversizedBehavior: "truncate"` now ignores `maxHeight` (there is no way to truncate text vertically).
1437
- - A `Container`'s `Rectangle`/`RoundedRectangle` background now defaults `crisp` to `true` unless set explicitly (5.20.0).
1438
- - `Root` (5.20.2): `fontFamily`, `fontSize` (number or string) and `fontWeight` (`"normal" | "bold" | "bolder" | "lighter"`, or `"100"` … `"900"`) settings — defaults for **all** text elements unless overridden on an element. Set them in `am5.Root.new("chartdiv", { fontFamily: "Inter" })` or `root.setAll({...})` instead of a custom theme rule on `Label`.
1439
- - `am5.SerialChartContainer` (5.20.2) — a directly usable `SerialChart` whose `seriesContainer` sits inside a `ZoomableContainer` (exposed as `chart.zoomableContainer`), so series such as `ForceDirected` can be zoomed and panned. Exported from the **`am5` root module**, not a chart package. Optional `zoomTools` setting takes a `ZoomTools` instance whose `target` is pointed at the series container automatically. Bullets added to its series are drawn (5.20.4) and flow-chart bullets are placed correctly inside it (5.20.5). See `references/hierarchy.md`.
1440
-
1441
- *JSON config / serialization (5.20.2 – 5.20.8)*
1442
- - `ChartSerializer` now emits **only user-set settings** (5.20.3) — theme and library defaults are left out. Anything diffing or post-processing serializer output must expect much smaller configs.
1443
- - A JSON config may carry a top-level **`root`** section (5.20.2) that applies settings and properties to the `Root` object before the chart is parsed; `ChartSerializer` writes it when `includeRoot: true` (default `false`). A `Root`'s `interfaceColors`, `utc`, `fps`, formatters and `tabindex` round-trip through it (5.20.3). Since 5.22.0 a parsed `root` section sets only those properties, a named locale and Root settings, and sets `sanitizeHTML: false` only with `trusted: true`.
1444
- - `JsonParser.parse(config, { updateTargets: "soft" })` (5.20.3) — an option on the **second argument of `parse()`**, not a parser setting. `"soft"` applies settings onto an existing object of the same `type` instead of replacing it; default `"strict"` replaces. `parse()` is async and returns a Promise.
1445
- - Gantt charts are now serializable/parsable (5.20.3). Cross-references are written as references (`"@series.get('fill')"`) instead of copies; large values (a map's `geoJSON`, a `Root`'s locale) are written as the name of the pack they came from and rebuilt on parse.
1446
- - An adapter whose callback did not survive the JSON round-trip is now **skipped** on parse instead of breaking the chart (5.20.4) — adapters still do not round-trip, see "Serializing to JSON" above.
1447
- - `ChartSerializer` writes user **`themeTags`** (5.20.6) — only tags passed to `.new()`; tags set later with `set("themeTags", …)` and tags the library adds are left out. On parse the tags are merged into an existing element's.
1448
- - `JsonParser` resolves **forward references** (5.20.7): a setting/property naming a ref defined further down the config is resolved after the rest instead of throwing "Could not find ref" — a legend inside an `axisHeader` naming a series now round-trips. Axis-range `axis`/`series` lookups are still immediate, so keep those ordered.
1449
- - Map data rows (5.20.7) no longer carry the geodata's own feature properties (`name`, `CNTRY`, `TYPE`); a row left with only its id is dropped.
1450
- - `animations` round-trip, and an endless code-started loop (`loops: Infinity`, nameable easing) is written as an `animations` entry with its key removed from the settings (5.20.8, `runningAnimations`, default `true`). A loop started on a data item in code is **not** saved in 5.20.8 (it is since 5.21.0).
1451
-
1452
- *Bullets on non-XY charts (5.20.2)*
1453
- - `ArcDiagram`: bullets on nodes are now placed on the node circle, `locationX`/`locationY` being fractions of it (before 5.20.2 they were created but never positioned). Flow charts (`Sankey`/`Chord`): node bullets are children of the node, drawn above its shape and below its label, positioned relative to the node. `FunnelSeries`/`PyramidSeries`: bullet `locationX`/`locationY` follow the slice's sloping edges instead of its bounding box.
1336
+ - `globalpointerdown` event on all elements — fires on a press anywhere on the chart surface, mirroring `globalpointermove`/`globalpointerup`.
1337
+ - `Root`: `sanitizeHTML` (default `true`) — dynamically-set HTML (`html`/`labelHTML`, HTML tooltips, modal content) is sanitized; set `false` in code to opt out. A JSON config's `root` section can't turn it off unless parsed with `trusted: true`. Exports have `escapeFormulas` (default `true`) to guard CSV/XLSX against formula injection.
1338
+ - `Root`: `ariaLabel` is applied to the `<div>` holding the chart's focusable elements.
1339
+ - `Label`: `oversizedBehavior: "truncate"` ignores `maxHeight` (there is no way to truncate text vertically).
1340
+ - A `Container`'s `Rectangle`/`RoundedRectangle` background defaults `crisp` to `true` unless set explicitly.
1341
+ - A `Container`'s `background` with its own `templateField` reads the container's data item, so a per-bullet label background works: `am5.Label.new(root, { text: "{valueY}", populateText: true, background: am5.RoundedRectangle.new(root, { templateField: "labelBg" }) })` with `labelBg: { fill: am5.color(0xff0000) }` in the data row.
1342
+ - `Root`: `fontFamily`, `fontSize` (number or string) and `fontWeight` (`"normal" | "bold" | "bolder" | "lighter"`, or `"100"` … `"900"`) settings — defaults for **all** text elements unless overridden on an element. Set them in `am5.Root.new("chartdiv", { fontFamily: "Inter" })` or `root.setAll({...})` instead of a custom theme rule on `Label`.
1343
+ - `am5.SerialChartContainer` — a directly usable `SerialChart` whose `seriesContainer` sits inside a `ZoomableContainer` (exposed as `chart.zoomableContainer`), so series such as `ForceDirected` can be zoomed and panned. Exported from the **`am5` root module**, not a chart package. Optional `zoomTools` setting takes a `ZoomTools` instance whose `target` is pointed at the series container automatically. Bullets on its series are drawn, flow-chart bullets included. See `references/hierarchy.md`.
1344
+
1345
+ *JSON config / serialization*
1346
+ - Gantt charts serialize and parse. Cross-references are written as references (`"@series.get('fill')"`) instead of copies; large values (a map's `geoJSON`, a `Root`'s locale) are written as the name of the pack they came from and rebuilt on parse.
1347
+ - `JsonParser` resolves **forward references**: a setting/property naming a ref defined further down the config is resolved after the rest instead of throwing "Could not find ref" — a legend inside an `axisHeader` naming a series round-trips. Axis-range `axis`/`series` lookups are immediate, so keep those ordered.
1348
+ - Map data rows written by `ChartSerializer` don't carry the geodata's own feature properties (`name`, `CNTRY`, `TYPE`); a row left with only its id is dropped.
1349
+
1350
+ *Bullets on non-XY charts*
1351
+ - `ArcDiagram`: bullets on nodes are placed on the node circle, `locationX`/`locationY` being fractions of it. Flow charts (`Sankey`/`Chord`): node bullets are children of the node, drawn above its shape and below its label, positioned relative to the node. `FunnelSeries`/`PyramidSeries`: bullet `locationX`/`locationY` follow the slice's sloping edges instead of its bounding box.
1454
1352
  - A bullet `Graphics` with no paint of its own takes the color of **its own slice or node** on pie, funnel, flow and hierarchy charts — so it is the same color as what it sits on and **invisible** unless offset, stroked, or given a contrasting `fill` deliberately. Setting `fill` on the bullet sprite turns the inheritance off.
1455
1353
 
1456
1354
  *Maps*
1457
- - `MapChart` (5.20.2): `doubleClickZoom` (default **`true`** — a behavior change: a double click/tap zooms in, shift + double click zooms out; set `false` to opt out). On maps panned by rotating (`panX: "rotateX"` / `panY: "rotateY"`) the clicked point rotates to the center, otherwise it stays under the pointer. `boxZoom: "none" | "drag" | "shift" | "ctrl" | "alt"` (default `"none"`) is **not a boolean** — it names the key held while dragging a rectangle to zoom into; `"drag"` needs no key, so pair it with `panX`/`panY: "none"`. The rectangle is the readonly `chart.boxZoomSelection` element (a `Rectangle`). There are no keyboard-navigation settings on `MapChart`.
1458
- - `MapLineSeries` (5.20.3): `pointIds` data field (`{ pointIds: ["JFK", "LAX"] }`) names the `MapPointSeries` points a line connects, looked up in the series given by the new `pointSeries` setting; `pointIdsField` (default `"pointIds"`) renames the field. `pointsToConnect` wins if both are set. See `references/map.md`.
1459
- - `MapChart`: `projectionName` (5.19.0) — string alternative to `projection`, e.g. `"geoOrthographic"`, mainly for JSON config. Register extra ones with `am5map.registerProjection()`. Bundled projections are no longer eagerly imported, so unused ones tree-shake away.
1460
- - `MapSankeySeries` (5.17.0) — Sankey overlaid on a map; auto-resolves `sourceId`/`targetId` once `polygonSeries` geoJSON loads (5.17.1), so no `datavalidated` wrapper needed. See `references/map.md`.
1461
- - `MapPointSeries` defaults changed to `longitudeField: "longitude"`, `latitudeField: "latitude"` (5.16.1).
1355
+ - `MapChart`: `doubleClickZoom` (default **`true`**: a double click/tap zooms in, shift + double click zooms out; set `false` to opt out). On maps panned by rotating (`panX: "rotateX"` / `panY: "rotateY"`) the clicked point rotates to the center, otherwise it stays under the pointer. `boxZoom: "none" | "drag" | "shift" | "ctrl" | "alt"` (default `"none"`) is **not a boolean** — it names the key held while dragging a rectangle to zoom into; `"drag"` needs no key, so pair it with `panX`/`panY: "none"`. The rectangle is the readonly `chart.boxZoomSelection` element (a `Rectangle`). There are no keyboard-navigation settings on `MapChart`.
1356
+ - `MapLineSeries`: `pointIds` data field (`{ pointIds: ["JFK", "LAX"] }`) names the `MapPointSeries` points a line connects, looked up in the series given by the `pointSeries` setting; `pointIdsField` (default `"pointIds"`) renames the field. `pointsToConnect` wins if both are set. See `references/map.md`.
1357
+ - `MapChart`: `projectionName` — string alternative to `projection`, e.g. `"geoOrthographic"`, mainly for JSON config. Register extra ones with `am5map.registerProjection()`. Unused bundled projections tree-shake away.
1358
+ - `MapSankeySeries` — Sankey overlaid on a map; it resolves `sourceId`/`targetId` once the `polygonSeries` geoJSON loads, so no `datavalidated` wrapper is needed. See `references/map.md`.
1462
1359
 
1463
1360
  *Hierarchy & axes*
1464
- - `Tree`: `fitNodes` (5.18.0, exclude hidden nodes from layout), `nodeSeparation` (5.16.2, custom node-spacing fn), `clustered` (5.16.2, dendrogram layout — leaves at same depth).
1465
- - `ValueAxis`: `syncZeros` (5.16.2, align zero across synced axes — needs `syncWithAxis`).
1466
- - `Hierarchy`: `parentIdField` setting + `setFlatData(data)` method (5.16.2) — feed flat `{id, parentId}` data instead of nested `children`.
1361
+ - `Tree`: `fitNodes` (exclude hidden nodes from layout), `nodeSeparation` (custom node-spacing fn), `clustered` (dendrogram layout — leaves at same depth).
1362
+ - `ValueAxis`: `syncZeros` (align zero across synced axes — needs `syncWithAxis`).
1363
+ - `Hierarchy`: `parentIdField` setting + `setFlatData(data)` method — feed flat `{id, parentId}` data instead of nested `children`.
1467
1364
 
1468
1365
  *Stock*
1469
- - Indicator numeric settings now enforce min/max limits, so extreme values can no longer freeze the page. `IIndicatorEditableSetting` gained `scale`, `maxValue` and `step` (5.20.0).
1470
- - Volume Profile now spreads each bar's volume across its full high/low range instead of placing it all at the close. Several indicator math fixes (Williams %R, Momentum, RSI, Moving Average Cross defaults, Commodity Channel Index) landed in 5.19.0–5.20.0 — see `references/stock.md`.
1366
+ - Indicator numeric settings enforce min/max limits. `IIndicatorEditableSetting` has `scale`, `maxValue` and `step`.
1367
+ - Volume Profile spreads each bar's volume across its full high/low range. See `references/stock.md`.
1471
1368
 
1472
1369
  *All entities*
1473
- - `onDebounced(key, cb, delay)` / `offDebounced(key, cb?)` and `onPrivateDebounced` / `offDebouncedPrivate` (5.17.3) — fire once after rapid changes settle.
1474
- - `once(key, cb)` and `onceDebounced(key, cb, delay)` (5.20.4) — like `on()`/`onDebounced()` for a **settings** key, but the callback fires only the first time that setting changes, then removes itself. Both return an `IDisposer`. (Distinct from `events.once("eventName", …)`, which has existed for events all along.)
1475
- - `Label`: `fontFamily: "inherit"` (5.17.3) uses the chart container's computed font.
1370
+ - `onDebounced(key, cb, delay)` / `offDebounced(key, cb?)` and `onPrivateDebounced` / `offDebouncedPrivate` — fire once after rapid changes settle.
1371
+ - `once(key, cb)` and `onceDebounced(key, cb, delay)` — like `on()`/`onDebounced()` for a **settings** key, but the callback fires only the first time that setting changes, then removes itself. Both return an `IDisposer`. (Distinct from `events.once("eventName", …)` for events.)
1372
+ - `Label`: `fontFamily: "inherit"` uses the chart container's computed font.
1476
1373
 
1477
1374
  ## Verify unfamiliar API before using it
1478
1375