@amcharts/amcharts5-mcp 1.9.0 → 1.9.2

package/extended/examples/json-configs/hierarchy-treemap.md

@@ -0,0 +1,159 @@
+---
+title: "Treemap with Breadcrumbs (JSON config)"
+category: "json-configs"
+source: "@amcharts/amcharts5@5.21.4: examples/hierarchy-treemap/config.json"
+---
+
+# Treemap with Breadcrumbs (JSON config)
+
+A treemap that drills into a branch on click, with a breadcrumb bar to go back up.
+
+Chart family: hierarchy · Tags: treemap, hierarchy, breadcrumbs, drill-down
+
+A complete amCharts 5 JSON config, as shipped in the `@amcharts/amcharts5` npm package (examples/hierarchy-treemap/config.json, version 5.21.4). It works with `am5plugins_json.JsonParser`, the `<am5-chart>` element, the framework packages' `config` prop, and Chart Maker links. The rules for writing one are in the skill's JSON reference (get_chart_reference("json")).
+
+Themes are not part of a config. The example is meant for: Animated, set with `root.setThemes()`, the element's `themes` attribute, or a Chart Maker link's `theme`.
+
+## Required resources
+
+- https://cdn.amcharts.com/lib/5/index.js
+- https://cdn.amcharts.com/lib/5/plugins/json.js
+- https://cdn.amcharts.com/lib/5/hierarchy.js
+- https://cdn.amcharts.com/lib/5/themes/Animated.js (theme, applied separately)
+
+## JSON config
+
+```json
+{
+  "type": "Container",
+  "settings": {
+    "width": {
+      "type": "Percent",
+      "value": 100
+    },
+    "height": {
+      "type": "Percent",
+      "value": 100
+    },
+    "layout": {
+      "type": "VerticalLayout"
+    }
+  },
+  "children": [
+    "#series-0",
+    {
+      "type": "BreadcrumbBar",
+      "settings": {
+        "series": "#series-0"
+      },
+      "index": 0
+    }
+  ],
+  "refs": [
+    {
+      "data-0": [
+        {
+          "name": "Sales",
+          "children": [
+            {
+              "name": "Electronics",
+              "children": [
+                {
+                  "name": "Phones",
+                  "value": 86
+                },
+                {
+                  "name": "Laptops",
+                  "value": 64
+                },
+                {
+                  "name": "Audio",
+                  "children": [
+                    {
+                      "name": "Headphones",
+                      "value": 31
+                    },
+                    {
+                      "name": "Speakers",
+                      "value": 18
+                    }
+                  ],
+                  "__parse": true
+                }
+              ],
+              "__parse": true
+            },
+            {
+              "name": "Home",
+              "children": [
+                {
+                  "name": "Furniture",
+                  "value": 52
+                },
+                {
+                  "name": "Lighting",
+                  "value": 15
+                },
+                {
+                  "name": "Kitchen",
+                  "children": [
+                    {
+                      "name": "Cookware",
+                      "value": 22
+                    },
+                    {
+                      "name": "Appliances",
+                      "value": 37
+                    }
+                  ],
+                  "__parse": true
+                }
+              ],
+              "__parse": true
+            },
+            {
+              "name": "Sports",
+              "children": [
+                {
+                  "name": "Cycling",
+                  "value": 41
+                },
+                {
+                  "name": "Fitness",
+                  "value": 28
+                },
+                {
+                  "name": "Outdoor",
+                  "value": 23
+                }
+              ],
+              "__parse": true
+            }
+          ],
+          "__parse": true
+        }
+      ]
+    },
+    {
+      "series-0": {
+        "type": "Treemap",
+        "settings": {
+          "downDepth": 1,
+          "upDepth": 1,
+          "initialDepth": 2,
+          "valueField": "value",
+          "categoryField": "name",
+          "childDataField": "children",
+          "selectedDataItem": "@self.dataItems.0",
+          "autoAppear": true,
+          "appearDuration": 1000,
+          "appearDelay": 100
+        },
+        "properties": {
+          "data": "#data-0"
+        }
+      }
+    }
+  ]
+}
+```

package/extended/examples/json-configs/hierarchy-voronoi-treemap.md

@@ -0,0 +1,533 @@
+---
+title: "Voronoi Treemap (JSON config)"
+category: "json-configs"
+source: "@amcharts/amcharts5@5.21.4: examples/hierarchy-voronoi-treemap/config.json"
+---
+
+# Voronoi Treemap (JSON config)
+
+World population as a Voronoi treemap, with theme rules that style each level and a click that zooms to a continent.
+
+Chart family: hierarchy · Tags: voronoi treemap, hierarchy, theme rules, adapter, drill-down
+
+A complete amCharts 5 JSON config, as shipped in the `@amcharts/amcharts5` npm package (examples/hierarchy-voronoi-treemap/config.json, version 5.21.4). It works with `am5plugins_json.JsonParser`, the `<am5-chart>` element, the framework packages' `config` prop, and Chart Maker links. The rules for writing one are in the skill's JSON reference (get_chart_reference("json")).
+
+Themes are not part of a config. The example is meant for: Animated, set with `root.setThemes()`, the element's `themes` attribute, or a Chart Maker link's `theme`.
+
+## Required resources
+
+- https://cdn.amcharts.com/lib/5/index.js
+- https://cdn.amcharts.com/lib/5/plugins/json.js
+- https://cdn.amcharts.com/lib/5/hierarchy.js
+- https://cdn.amcharts.com/lib/5/themes/Animated.js (theme, applied separately)
+
+## JSON config
+
+```json
+{
+  "type": "VoronoiTreemap",
+  "settings": {
+    "paddingLeft": 5,
+    "paddingRight": 5,
+    "paddingTop": 5,
+    "paddingBottom": 5,
+    "singleBranchOnly": true,
+    "downDepth": 2,
+    "upDepth": 0,
+    "initialDepth": 2,
+    "valueField": "population",
+    "categoryField": "name",
+    "idField": "id",
+    "childDataField": "children",
+    "selectedDataItem": "@self.dataItems.0",
+    "autoAppear": true,
+    "appearDuration": 1000,
+    "appearDelay": 100
+  },
+  "properties": {
+    "data": "#data-0",
+    "labels": {
+      "properties": {
+        "template": {
+          "settings": {
+            "text": "{id}",
+            "fontSize": 11,
+            "minScale": 0.7
+          }
+        }
+      }
+    }
+  },
+  "refs": [
+    {
+      "data-0": [
+        {
+          "children": [
+            {
+              "name": "Africa",
+              "children": [
+                {
+                  "id": "DZ",
+                  "name": "Algeria",
+                  "population": 40400000
+                },
+                {
+                  "id": "AO",
+                  "name": "Angola",
+                  "population": 25868000
+                },
+                {
+                  "id": "BF",
+                  "name": "Burkina Faso",
+                  "population": 19034397
+                },
+                {
+                  "id": "CM",
+                  "name": "Cameroon",
+                  "population": 22709892
+                },
+                {
+                  "id": "TD",
+                  "name": "Chad",
+                  "population": 14497000
+                },
+                {
+                  "id": "CD",
+                  "name": "Congo (Kinshasa)",
+                  "population": 85026000
+                },
+                {
+                  "id": "EG",
+                  "name": "Egypt",
+                  "population": 91251890
+                },
+                {
+                  "id": "ET",
+                  "name": "Ethiopia",
+                  "population": 102403196
+                },
+                {
+                  "id": "GH",
+                  "name": "Ghana",
+                  "population": 27670174
+                },
+                {
+                  "id": "GN",
+                  "name": "Guinea",
+                  "population": 12947000
+                },
+                {
+                  "id": "KE",
+                  "name": "Kenya",
+                  "population": 47251000
+                },
+                {
+                  "id": "MG",
+                  "name": "Madagascar",
+                  "population": 22434363
+                },
+                {
+                  "id": "MW",
+                  "name": "Malawi",
+                  "population": 18622104
+                },
+                {
+                  "id": "ML",
+                  "name": "Mali",
+                  "population": 17994837
+                },
+                {
+                  "id": "MA",
+                  "name": "Morocco",
+                  "population": 34224455
+                },
+                {
+                  "id": "MZ",
+                  "name": "Mozambique",
+                  "population": 28829476
+                },
+                {
+                  "id": "NE",
+                  "name": "Niger",
+                  "population": 21477348
+                },
+                {
+                  "id": "NG",
+                  "name": "Nigeria",
+                  "population": 186988000
+                },
+                {
+                  "id": "RW",
+                  "name": "Rwanda",
+                  "population": 11553188
+                },
+                {
+                  "id": "SN",
+                  "name": "Senegal",
+                  "population": 14799859
+                },
+                {
+                  "id": "SO",
+                  "name": "Somalia",
+                  "population": 11079000
+                },
+                {
+                  "id": "ZA",
+                  "name": "South Africa",
+                  "population": 55653654
+                },
+                {
+                  "id": "SS",
+                  "name": "South Sudan",
+                  "population": 12131000
+                },
+                {
+                  "id": "SD",
+                  "name": "Sudan",
+                  "population": 39598700
+                },
+                {
+                  "id": "TZ",
+                  "name": "Tanzania",
+                  "population": 55155000
+                },
+                {
+                  "id": "TN",
+                  "name": "Tunisia",
+                  "population": 11154400
+                },
+                {
+                  "id": "UG",
+                  "name": "Uganda",
+                  "population": 39570125
+                },
+                {
+                  "id": "ZM",
+                  "name": "Zambia",
+                  "population": 15933883
+                },
+                {
+                  "id": "ZW",
+                  "name": "Zimbabwe",
+                  "population": 14240168
+                },
+                {
+                  "name": "Others",
+                  "population": 83693146
+                }
+              ],
+              "__parse": true
+            },
+            {
+              "name": "Asia",
+              "children": [
+                {
+                  "id": "AF",
+                  "name": "Afghanistan",
+                  "population": 27657145
+                },
+                {
+                  "id": "BD",
+                  "name": "Bangladesh",
+                  "population": 161006790
+                },
+                {
+                  "id": "KH",
+                  "name": "Cambodia",
+                  "population": 15626444
+                },
+                {
+                  "id": "CN",
+                  "name": "China",
+                  "population": 1373540000
+                },
+                {
+                  "id": "IN",
+                  "name": "India",
+                  "population": 1324171354
+                },
+                {
+                  "id": "ID",
+                  "name": "Indonesia",
+                  "population": 261115456
+                },
+                {
+                  "id": "IR",
+                  "name": "Iran",
+                  "population": 79369900
+                },
+                {
+                  "id": "IQ",
+                  "name": "Iraq",
+                  "population": 37883543
+                },
+                {
+                  "id": "JP",
+                  "name": "Japan",
+                  "population": 126672000
+                },
+                {
+                  "id": "KZ",
+                  "name": "Kazakhstan",
+                  "population": 17753200
+                },
+                {
+                  "id": "MY",
+                  "name": "Malaysia",
+                  "population": 31187265
+                },
+                {
+                  "id": "MM",
+                  "name": "Myanmar",
+                  "population": 51419420
+                },
+                {
+                  "id": "NP",
+                  "name": "Nepal",
+                  "population": 28431500
+                },
+                {
+                  "id": "KP",
+                  "name": "North Korea",
+                  "population": 25000000
+                },
+                {
+                  "id": "PK",
+                  "name": "Pakistan",
+                  "population": 193203476
+                },
+                {
+                  "id": "PH",
+                  "name": "Philippines",
+                  "population": 103320222
+                },
+                {
+                  "id": "RU",
+                  "name": "Russia",
+                  "population": 146599183
+                },
+                {
+                  "id": "SA",
+                  "name": "Saudi Arabia",
+                  "population": 32248200
+                },
+                {
+                  "id": "KR",
+                  "name": "South Korea",
+                  "population": 50982212
+                },
+                {
+                  "id": "LK",
+                  "name": "Sri Lanka",
+                  "population": 20950000
+                },
+                {
+                  "id": "SY",
+                  "name": "Syria",
+                  "population": 18564000
+                },
+                {
+                  "id": "TW",
+                  "name": "Taiwan",
+                  "population": 23503349
+                },
+                {
+                  "id": "TH",
+                  "name": "Thailand",
+                  "population": 65327652
+                },
+                {
+                  "id": "TR",
+                  "name": "Turkey",
+                  "population": 78741053
+                },
+                {
+                  "id": "UZ",
+                  "name": "Uzbekistan",
+                  "population": 31910641
+                },
+                {
+                  "id": "VN",
+                  "name": "Vietnam",
+                  "population": 92700000
+                },
+                {
+                  "id": "YE",
+                  "name": "Yemen",
+                  "population": 27478000
+                },
+                {
+                  "name": "Others",
+                  "population": 99125003
+                }
+              ],
+              "__parse": true
+            },
+            {
+              "name": "Europe",
+              "children": [
+                {
+                  "id": "BE",
+                  "name": "Belgium",
+                  "population": 11319511
+                },
+                {
+                  "id": "FR",
+                  "name": "France",
+                  "population": 66710000
+                },
+                {
+                  "id": "DE",
+                  "name": "Germany",
+                  "population": 82667685
+                },
+                {
+                  "id": "IT",
+                  "name": "Italy",
+                  "population": 60665551
+                },
+                {
+                  "id": "NL",
+                  "name": "Netherlands",
+                  "population": 17019800
+                },
+                {
+                  "id": "PL",
+                  "name": "Poland",
+                  "population": 38437239
+                },
+                {
+                  "id": "RO",
+                  "name": "Romania",
+                  "population": 19861408
+                },
+                {
+                  "id": "RU",
+                  "name": "Russia",
+                  "population": 146599183
+                },
+                {
+                  "id": "ES",
+                  "name": "Spain",
+                  "population": 46438422
+                },
+                {
+                  "id": "UA",
+                  "name": "Ukraine",
+                  "population": 42692393
+                },
+                {
+                  "id": "GB",
+                  "name": "United Kingdom",
+                  "population": 65110000
+                },
+                {
+                  "name": "Others",
+                  "population": 148353430
+                }
+              ],
+              "__parse": true
+            },
+            {
+              "name": "North America",
+              "children": [
+                {
+                  "id": "CA",
+                  "name": "Canada",
+                  "population": 36155487
+                },
+                {
+                  "id": "CU",
+                  "name": "Cuba",
+                  "population": 11239004
+                },
+                {
+                  "id": "GT",
+                  "name": "Guatemala",
+                  "population": 16176133
+                },
+                {
+                  "id": "MX",
+                  "name": "Mexico",
+                  "population": 122273473
+                },
+                {
+                  "id": "US",
+                  "name": "United States",
+                  "population": 326766748
+                },
+                {
+                  "name": "Others",
+                  "population": 60717922
+                }
+              ],
+              "__parse": true
+            },
+            {
+              "name": "South America",
+              "children": [
+                {
+                  "id": "AR",
+                  "name": "Argentina",
+                  "population": 43847430
+                },
+                {
+                  "id": "BR",
+                  "name": "Brazil",
+                  "population": 209288278
+                },
+                {
+                  "id": "CL",
+                  "name": "Chile",
+                  "population": 18191900
+                },
+                {
+                  "id": "CO",
+                  "name": "Colombia",
+                  "population": 49065615
+                },
+                {
+                  "id": "EC",
+                  "name": "Ecuador",
+                  "population": 16624858
+                },
+                {
+                  "id": "PE",
+                  "name": "Peru",
+                  "population": 32165485
+                },
+                {
+                  "id": "VE",
+                  "name": "Venezuela",
+                  "population": 31977065
+                },
+                {
+                  "name": "Others",
+                  "population": 22912396
+                }
+              ],
+              "__parse": true
+            },
+            {
+              "name": "Oceania",
+              "children": [
+                {
+                  "id": "AU",
+                  "name": "Australia",
+                  "population": 24450561
+                },
+                {
+                  "name": "Others",
+                  "population": 16213347
+                }
+              ],
+              "__parse": true
+            }
+          ],
+          "__parse": true
+        }
+      ]
+    }
+  ]
+}
+```