@amcharts/amcharts5 5.16.2 → 5.17.1

package/CHANGELOG.md

@@ -5,16 +5,31 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/).
 Please note, that this project, while following numbering syntax, it DOES NOT
 adhere to [Semantic Versioning](http://semver.org/spec/v2.0.0.html) rules.
 
+## [5.17.1] - 2026-04-07
+
+### Changed
+- `MapSankeySeries` now automatically resolves `sourceId`/`targetId` endpoints once the referenced `polygonSeries` finishes loading its geoJSON. Users no longer need to wrap `sankeySeries.data.setAll()` in a `polygonSeries.events.once("datavalidated", ...)` callback.
+
+
+## [5.17.0] - 2026-04-06
+
+### Added
+- `MapSankeySeries` added. [More info](https://www.amcharts.com/docs/v5/charts/map-chart/map-sankey-series/)
+
+### Fixed
+- Added safeguards to avoid floating point errors when animating values.
+
+
 ## [5.16.2] - 2026-03-17
 
-## Added
+### Added
 - `syncZeros` added to `ValueAxis`. It will work only if `syncWithAxis` is set and zero is within min/max of axis.
 - Exposing standalone functions via `index`/`am5`: `populateString()`, `getTagValue()`, `getCustomDataValue()`.
 - `nodeSeparation` setting added to `Tree`. Allows custom separation function between nodes, receiving two data items and returning a numeric value.
 - `setFlatData()` method added to `Hierarchy`. Accepts flat array data with parent ID references and converts it to nested hierarchy format. Works with new `parentIdField` setting.
 - `clustered` setting added to `Tree`. When set to `true`, uses cluster layout (dendrogram) where all leaf nodes are placed at the same depth.
 
-## Fixed
+### Fixed
 - `minBulletDistance` was not showing/hiding bullets if set dynamically after series was already initialized.
 - Axis syncing algorithm fixed, performance of syncing  improved.
 - `Tree` and `ForceDirected` charts with very deep structures were having performance issues.
@@ -22,29 +37,29 @@ adhere to [Semantic Versioning](http://semver.org/spec/v2.0.0.html) rules.
 
 ## [5.16.1] - 2026-03-03
 
-## Changed
+### Changed
 - Performance optimization: `ClusteredPointSeries`, `WordCloud`, `GaplessDateAxis`, `Treemap`, `Chord`, `DateAxis`, and others.
 - New defaults for `MapPointSeries`: `longitudeField: "longitude"` and `latitudeField: "latitude"`.
 
 
 ## [5.16.0] - 2026-02-18
 
-## Added
+### Added
 - `animateProjection` method added to `MapChart`. Allows changing map projection using animation.
 
 ### Changed
 - Performance: No longer using `Object.defineProperty` in compiled library.
 
-## Fixed
+### Fixed
 - In some cases, logarithmic scale of `ValueAxis` was ignoring `minGridDistance`, resulting in label overlap.
 
 
 ## [5.15.6] - 2026-02-05
 
-## Added 
+### Added 
 - `ignoreThemes` added to `Entity`. If set to `true`, no themes will be applied to the element. Set it to `true` on an elements (e.g. candles) of which there are many for improved performance. Required setting will need to be set directly on the element or its template.
 
-## Fixed
+### Fixed
 - Perdormance of `turboMode` increased significantly.
 
 
@@ -59,7 +74,7 @@ adhere to [Semantic Versioning](http://semver.org/spec/v2.0.0.html) rules.
 
 ## [5.15.4] - 2026-01-23
 
-## Fixed
+### Fixed
 - Adding bullets to series in some setups with React could result JS error since `5.15.0`.
 
 

package/examples/javascript/flow-arc-horizontal/package.json

@@ -3,7 +3,7 @@
   "name": "amcharts5-example-flow-arc-horizontal",
   "version": "0.1.0",
   "devDependencies": {
-    "@amcharts/amcharts5": "^5.16.2",
+    "@amcharts/amcharts5": "^5.17.1",
     "source-map-loader": "^4.0.1",
     "webpack": "^5.1.3",
     "webpack-cli": "^5.1.1",

package/examples/javascript/flow-arc-vertical/package.json

@@ -3,7 +3,7 @@
   "name": "amcharts5-example-flow-arc-vertical",
   "version": "0.1.0",
   "devDependencies": {
-    "@amcharts/amcharts5": "^5.16.2",
+    "@amcharts/amcharts5": "^5.17.1",
     "source-map-loader": "^4.0.1",
     "webpack": "^5.1.3",
     "webpack-cli": "^5.1.1",

package/examples/javascript/flow-chord/package.json

@@ -3,7 +3,7 @@
   "name": "amcharts5-example-flow-chord",
   "version": "0.1.0",
   "devDependencies": {
-    "@amcharts/amcharts5": "^5.16.2",
+    "@amcharts/amcharts5": "^5.17.1",
     "source-map-loader": "^4.0.1",
     "webpack": "^5.1.3",
     "webpack-cli": "^5.1.1",

package/examples/javascript/flow-chord-directed/package.json

@@ -3,7 +3,7 @@
   "name": "amcharts5-example-flow-chord-directed",
   "version": "0.1.0",
   "devDependencies": {
-    "@amcharts/amcharts5": "^5.16.2",
+    "@amcharts/amcharts5": "^5.17.1",
     "source-map-loader": "^4.0.1",
     "webpack": "^5.1.3",
     "webpack-cli": "^5.1.1",

package/examples/javascript/flow-chord-non-ribbon/package.json

@@ -3,7 +3,7 @@
   "name": "amcharts5-example-flow-chord-non-ribbon",
   "version": "0.1.0",
   "devDependencies": {
-    "@amcharts/amcharts5": "^5.16.2",
+    "@amcharts/amcharts5": "^5.17.1",
     "source-map-loader": "^4.0.1",
     "webpack": "^5.1.3",
     "webpack-cli": "^5.1.1",

package/examples/javascript/flow-sankey/package.json

@@ -3,7 +3,7 @@
   "name": "amcharts5-example-flow-sankey",
   "version": "0.1.0",
   "devDependencies": {
-    "@amcharts/amcharts5": "^5.16.2",
+    "@amcharts/amcharts5": "^5.17.1",
     "source-map-loader": "^4.0.1",
     "webpack": "^5.1.3",
     "webpack-cli": "^5.1.1",

package/examples/javascript/gantt/package.json

@@ -3,7 +3,7 @@
   "name": "amcharts5-example-gantt",
   "version": "0.1.0",
   "devDependencies": {
-    "@amcharts/amcharts5": "^5.16.2",
+    "@amcharts/amcharts5": "^5.17.1",
     "source-map-loader": "^4.0.1",
     "webpack": "^5.1.3",
     "webpack-cli": "^5.1.1",

package/examples/javascript/gantt-multilevel/package.json

@@ -3,7 +3,7 @@
   "name": "amcharts5-example-gantt-multilevel",
   "version": "0.1.0",
   "devDependencies": {
-    "@amcharts/amcharts5": "^5.16.2",
+    "@amcharts/amcharts5": "^5.17.1",
     "source-map-loader": "^4.0.1",
     "webpack": "^5.1.3",
     "webpack-cli": "^5.1.1",

package/examples/javascript/gantt-simple/package.json

@@ -3,7 +3,7 @@
   "name": "amcharts5-example-gantt-simple",
   "version": "0.1.0",
   "devDependencies": {
-    "@amcharts/amcharts5": "^5.16.2",
+    "@amcharts/amcharts5": "^5.17.1",
     "source-map-loader": "^4.0.1",
     "webpack": "^5.1.3",
     "webpack-cli": "^5.1.1",

package/examples/javascript/gauge/package.json

@@ -3,7 +3,7 @@
   "name": "amcharts5-example-gauge",
   "version": "0.1.0",
   "devDependencies": {
-    "@amcharts/amcharts5": "^5.16.2",
+    "@amcharts/amcharts5": "^5.17.1",
     "source-map-loader": "^4.0.1",
     "webpack": "^5.1.3",
     "webpack-cli": "^5.1.1",

package/examples/javascript/gauge-bands/package.json

@@ -3,7 +3,7 @@
   "name": "amcharts5-example-gauge-bands",
   "version": "0.1.0",
   "devDependencies": {
-    "@amcharts/amcharts5": "^5.16.2",
+    "@amcharts/amcharts5": "^5.17.1",
     "source-map-loader": "^4.0.1",
     "webpack": "^5.1.3",
     "webpack-cli": "^5.1.1",

package/examples/javascript/hierarchy-force-directed/package.json

@@ -3,7 +3,7 @@
   "name": "amcharts5-example-hierarchy-force-directed",
   "version": "0.1.0",
   "devDependencies": {
-    "@amcharts/amcharts5": "^5.16.2",
+    "@amcharts/amcharts5": "^5.17.1",
     "source-map-loader": "^4.0.1",
     "webpack": "^5.1.3",
     "webpack-cli": "^5.1.1",

package/examples/javascript/hierarchy-pack/package.json

@@ -3,7 +3,7 @@
   "name": "amcharts5-example-hierarchy-pack",
   "version": "0.1.0",
   "devDependencies": {
-    "@amcharts/amcharts5": "^5.16.2",
+    "@amcharts/amcharts5": "^5.17.1",
     "source-map-loader": "^4.0.1",
     "webpack": "^5.1.3",
     "webpack-cli": "^5.1.1",

package/examples/javascript/hierarchy-partition/package.json

@@ -3,7 +3,7 @@
   "name": "amcharts5-example-hierarchy-partition",
   "version": "0.1.0",
   "devDependencies": {
-    "@amcharts/amcharts5": "^5.16.2",
+    "@amcharts/amcharts5": "^5.17.1",
     "source-map-loader": "^4.0.1",
     "webpack": "^5.1.3",
     "webpack-cli": "^5.1.1",

package/examples/javascript/hierarchy-sunburst/package.json

@@ -3,7 +3,7 @@
   "name": "amcharts5-example-hierarchy-sunburst",
   "version": "0.1.0",
   "devDependencies": {
-    "@amcharts/amcharts5": "^5.16.2",
+    "@amcharts/amcharts5": "^5.17.1",
     "source-map-loader": "^4.0.1",
     "webpack": "^5.1.3",
     "webpack-cli": "^5.1.1",

package/examples/javascript/hierarchy-tree/package.json

@@ -3,7 +3,7 @@
   "name": "amcharts5-example-hierarchy-tree",
   "version": "0.1.0",
   "devDependencies": {
-    "@amcharts/amcharts5": "^5.16.2",
+    "@amcharts/amcharts5": "^5.17.1",
     "source-map-loader": "^4.0.1",
     "webpack": "^5.1.3",
     "webpack-cli": "^5.1.1",

package/examples/javascript/hierarchy-treemap/package.json

@@ -3,7 +3,7 @@
   "name": "amcharts5-example-hierarchy-treemap",
   "version": "0.1.0",
   "devDependencies": {
-    "@amcharts/amcharts5": "^5.16.2",
+    "@amcharts/amcharts5": "^5.17.1",
     "source-map-loader": "^4.0.1",
     "webpack": "^5.1.3",
     "webpack-cli": "^5.1.1",

package/examples/javascript/hierarchy-voronoi-treemap/package.json

@@ -3,7 +3,7 @@
   "name": "amcharts5-example-hierarchy-voronoi-treemap",
   "version": "0.1.0",
   "devDependencies": {
-    "@amcharts/amcharts5": "^5.16.2",
+    "@amcharts/amcharts5": "^5.17.1",
     "source-map-loader": "^4.0.1",
     "webpack": "^5.1.3",
     "webpack-cli": "^5.1.1",

package/examples/javascript/jest/package.json

@@ -3,7 +3,7 @@
   "name": "amcharts5-example-jest",
   "version": "0.1.0",
   "devDependencies": {
-    "@amcharts/amcharts5": "^5.16.2",
+    "@amcharts/amcharts5": "^5.17.1",
     "source-map-loader": "^4.0.1",
     "webpack": "^5.1.3",
     "webpack-cli": "^5.1.1",

package/examples/javascript/json-pie/package.json

@@ -3,7 +3,7 @@
   "name": "amcharts5-example-json-pie",
   "version": "0.1.0",
   "devDependencies": {
-    "@amcharts/amcharts5": "^5.16.2",
+    "@amcharts/amcharts5": "^5.17.1",
     "source-map-loader": "^4.0.1",
     "webpack": "^5.1.3",
     "webpack-cli": "^5.1.1",

package/examples/javascript/json-xy/package.json

@@ -3,7 +3,7 @@
   "name": "amcharts5-example-json-xy",
   "version": "0.1.0",
   "devDependencies": {
-    "@amcharts/amcharts5": "^5.16.2",
+    "@amcharts/amcharts5": "^5.17.1",
     "source-map-loader": "^4.0.1",
     "webpack": "^5.1.3",
     "webpack-cli": "^5.1.1",

package/examples/javascript/map-animating-along-lines/package.json

@@ -3,7 +3,7 @@
   "name": "amcharts5-example-map-animating-along-lines",
   "version": "0.1.0",
   "devDependencies": {
-    "@amcharts/amcharts5": "^5.16.2",
+    "@amcharts/amcharts5": "^5.17.1",
     "@amcharts/amcharts5-geodata": "^5.1.5",
     "source-map-loader": "^4.0.1",
     "webpack": "^5.1.3",

package/examples/javascript/map-clustered-points/package.json

@@ -3,7 +3,7 @@
   "name": "amcharts5-example-map-clustered-points",
   "version": "0.1.0",
   "devDependencies": {
-    "@amcharts/amcharts5": "^5.16.2",
+    "@amcharts/amcharts5": "^5.17.1",
     "@amcharts/amcharts5-geodata": "^5.1.5",
     "source-map-loader": "^4.0.1",
     "webpack": "^5.1.3",

package/examples/javascript/map-day-and-night/package.json

@@ -3,7 +3,7 @@
   "name": "amcharts5-example-map-day-and-night",
   "version": "0.1.0",
   "devDependencies": {
-    "@amcharts/amcharts5": "^5.16.2",
+    "@amcharts/amcharts5": "^5.17.1",
     "@amcharts/amcharts5-geodata": "^5.1.5",
     "source-map-loader": "^4.0.1",
     "webpack": "^5.1.3",

package/examples/javascript/map-globe-rotate-to-country/package.json

@@ -3,7 +3,7 @@
   "name": "amcharts5-example-map-globe-rotate-to-country",
   "version": "0.1.0",
   "devDependencies": {
-    "@amcharts/amcharts5": "^5.16.2",
+    "@amcharts/amcharts5": "^5.17.1",
     "@amcharts/amcharts5-geodata": "^5.1.5",
     "source-map-loader": "^4.0.1",
     "webpack": "^5.1.3",

package/examples/javascript/map-globe-with-projected-circles/package.json

@@ -3,7 +3,7 @@
   "name": "amcharts5-example-map-globe-with-projected-circles",
   "version": "0.1.0",
   "devDependencies": {
-    "@amcharts/amcharts5": "^5.16.2",
+    "@amcharts/amcharts5": "^5.17.1",
     "@amcharts/amcharts5-geodata": "^5.1.5",
     "source-map-loader": "^4.0.1",
     "webpack": "^5.1.3",

package/examples/javascript/map-sankey/README.md

@@ -0,0 +1,6 @@
+Steps to use
+============
+
+1. Run `yarn`
+
+2. Run `yarn start` for development, or `yarn build` for production

package/examples/javascript/map-sankey/index.css

@@ -0,0 +1,11 @@
+body {
+  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol";
+  padding: 0;
+  margin: 0;
+  background-color: #ffffff;
+}
+
+#chartdiv {
+  width: 100%;
+  height: 80vh;
+}

package/examples/javascript/map-sankey/index.html

@@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta charset="UTF-8" />
+    <title>amCharts 5 Example - map-sankey</title>
+    <link rel="stylesheet" href="index.css" />
+  </head>
+  <body>
+    <style>body { margin: 0; padding: 0; background: #f0e6d6; overflow: hidden; }</style>
+    <div id="chartdiv" style="width: 100%; height: 100vh; background: #f0e6d6;"></div>
+    <script src="dist/index.js"></script>
+  </body>
+</html>