eurostat-map 4.4.0 → 4.4.2

package/README.md

@@ -1,38 +1,63 @@
+# eurostat-map: Data-Driven Maps
+
 <div align="center">
   <img src="https://img.shields.io/bundlephobia/min/eurostat-map" alt="npm bundle size">
   <img src="https://img.shields.io/npm/v/eurostat-map" alt="npm">
   <img src="https://img.shields.io/badge/license-EUPL-success" alt="license">
   <a href="http://www.awesomeofficialstatistics.org"><img src="https://awesome.re/mentioned-badge.svg" alt="Mentioned in Awesome Official Statistics"></a>
 </div>
+
 <br>
 <div align="center">
   <img src="https://raw.githubusercontent.com/eurostat/eurostat-map/master/docs/img/eurostat-map-logo-cropped.png" alt="examples" width="400"/>
 </div>
 <div align="center">
-  <em>Customizable thematic maps. See <strong><a href="docs/reference.md">documentation</a></strong>.</em>
+  <em>Build publication-ready statistical maps of Europe in minutes.</em>
 </div>
 
-<hr>
-
 <div align="center">
-Based on D3 and designed for Eurostat data but compatible with custom geometries and stats. 
+  D3-based mapping library for Eurostat and custom data - the engine that powers <a href="https://gisco-services.ec.europa.eu/image/" target="_blank"><strong>IMAGE</strong></a>.
 </div>
+
 <div align="center">
-    Check out <a href="https://observablehq.com/collection/@eurostat-ws/eurostatmap-js" target="_blank">this observable notebook</a> for a quickstart guide.
+  <a href="docs/reference.md" target="_blank"><strong>Documentation</strong></a> ·
+  <a href="https://eurostat.github.io/eurostat-map/examples/index.html" target="_blank"><strong>Live examples</strong></a> ·
+  <a href="https://observablehq.com/collection/@eurostat-ws/eurostatmap-js" target="_blank"><strong>Quickstart notebook</strong></a>
 </div>
+<hr>
+
+- **Interactive SVG maps** rendered using **D3.js**.
+- **TypeScript support** with built-in definition typings.
+- **NUTS geometries** fetched dynamically via the **Nuts2json API** (TopoJSON format).
+- **Eurostat API integration** using the **JSON-stat** standard.
+
+<hr>
 <br>
 <div align="center">
-<a href="https://eurostat.github.io/eurostat-map/examples/population-density.html" target="_blank"> <img src="https://raw.githubusercontent.com/eurostat/eurostat-map/master/docs/img/examples.gif" alt="examples" width="600"/> </a>
+
+  <table>
+    <tr>
+      <td><a href="https://eurostat.github.io/eurostat-map/examples/population-density.html" target="_blank"><img src="examples/img/previews/population-density.png" alt="Population density example"  /></a></td>
+      <td><a href="https://eurostat.github.io/eurostat-map/examples/prop-circles.html" target="_blank"><img src="examples/img/previews/prop-circles.png" alt="Proportional circles example"  /></a></td>
+      <td><a href="https://eurostat.github.io/eurostat-map/examples/flowmap.html" target="_blank"><img src="examples/img/previews/flowmap.png" alt="Flow map example"  /></a></td>
+      <td><a href="https://eurostat.github.io/eurostat-map/examples/mushroom.html" target="_blank"><img src="examples/img/previews/mushroom.png" alt="Mushroom map example"  /></a></td>
+    </tr>
+    <tr>
+      <td><a href="https://eurostat.github.io/eurostat-map/examples/sparklines-grid-cartogram.html" target="_blank"><img src="examples/img/previews/sparklines-grid-cartogram.png" alt="Sparklines map example"  /></a></td>
+      <td><a href="https://eurostat.github.io/eurostat-map/examples/pop-unemploy-bivariate.html" target="_blank"><img src="examples/img/previews/pop-unemploy-bivariate.png" alt="Bivariate map example"  /></a></td>
+      <td><a href="https://eurostat.github.io/eurostat-map/examples/trivariate.html" target="_blank"><img src="examples/img/previews/trivariate.png" alt="Trivariate map example"  /></a></td>
+            <td><a href="https://eurostat.github.io/eurostat-map/examples/livestock_composition.html" target="_blank"><img src="examples/img/previews/livestock_composition.png" alt="Trivariate map example"  /></a></td>
+    </tr>
+  </table>
 </div>
 
 ---
 
-## Table of Contents
+## Resources
 
-- [Examples](#examples)
-- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [Examples](https://eurostat.github.io/eurostat-map/examples/index.html)
 - [Documentation](#documentation)
-- [Technical details](#technical-details)
 - [About](#about)
 - [Contribute](#contribute)
 - [Copyright](#copyright)
@@ -40,103 +65,54 @@ Based on D3 and designed for Eurostat data but compatible with custom geometries
 
 ---
 
-## Examples
-
-You can build an interactive statistical map with just a few lines of code:
-
-```javascript
-const map = eurostatmap
-    .map('choropleth') // Specify the map type
-    .title('Population density in Europe') // Add a title
-    .stat({ eurostatDatasetCode: 'demo_r_d3dens', unitText: 'people/km²' }) // Configure dataset
-    .legend({ x: 500, y: 180, title: 'Density, people/km²' }) // Add a legend
-    .build() // Build the map
-
-// Or you can use your own statistics like so:
-map.statData().setData({ ES: 3, FR: 2, DE: 5 })
-```
-
-For a quick tutorial check out this notebook:
-https://observablehq.com/@joewdavies/eurostat-map-js
+## Quick Start
 
-- [Population density](https://eurostat.github.io/eurostat-map/examples/population-density.html) (see [the code](https://github.com/eurostat/eurostat-map/blob/master/examples/population-density.html))
-- [Population map with proportional circles](https://eurostat.github.io/eurostat-map/examples/prop-circles.html) (see [the code](https://github.com/eurostat/eurostat-map/blob/master/examples/prop-circles.html))
-- [Causes of death with proportional pie charts](https://eurostat.github.io/eurostat-map/examples/prop-piecharts.html) (see [the code](https://github.com/eurostat/eurostat-map/blob/master/examples/prop-piecharts.html))
-- [Population change ](https://eurostat.github.io/eurostat-map/examples/population-change.html) (see [the code](https://github.com/eurostat/eurostat-map/blob/master/examples/population-change.html))
-- [NUTS typology as a categorical map](https://eurostat.github.io/eurostat-map/examples/categorical.html) (see [the code](https://github.com/eurostat/eurostat-map/blob/master/examples/categorical.html))
-- [Focus on Spain](https://eurostat.github.io/eurostat-map/examples/spain.html) (see [the code](https://github.com/eurostat/eurostat-map/blob/master/examples/spain.html))
-- [20 years of GDP change in Europe](https://eurostat.github.io/eurostat-map/examples/small_multiple.html) (see [the code](https://github.com/eurostat/eurostat-map/blob/master/examples/small_multiple.html))
-- [Unemployment/population relation](https://eurostat.github.io/eurostat-map/examples/pop-unemploy-bivariate.html) (see [the code](https://github.com/eurostat/eurostat-map/blob/master/examples/pop-unemploy-bivariate.html))
-- [Farm sizes composition](https://eurostat.github.io/eurostat-map/examples/farm_size.html) (see [the code](https://github.com/eurostat/eurostat-map/blob/master/examples/farm_size.html))
-- [Livestock composition](https://eurostat.github.io/eurostat-map/examples/livestock_composition.html) (see [the code](https://github.com/eurostat/eurostat-map/blob/master/examples/livestock_composition.html))
-- [Sparklines: Population in Europe since 2012](https://eurostat.github.io/eurostat-map/examples/sparklines.html) (see [the code](https://github.com/eurostat/eurostat-map/blob/master/examples/sparklines.html))
-- [World map](https://eurostat.github.io/eurostat-map/examples/world.html) (see [the code](https://github.com/eurostat/eurostat-map/blob/master/examples/world.html))
-- [Flow map](https://eurostat.github.io/eurostat-map/examples/flowmap.html) (see [the code](https://github.com/eurostat/eurostat-map/blob/master/examples/flowmap.html))
-
-## Installation
-
-### Node.js
-
-```npm
+```bash
 npm install eurostat-map
 ```
 
-then
-
 ```javascript
-import eurostatmap from 'eurostatmap'
+import eurostatmap from 'eurostat-map'
 ```
 
 or
 
 ```javascript
-eurostatmap = require('eurostatmap')
+const eurostatmap = require('eurostat-map')
 ```
 
-### Standalone
-
-For the latest version, use:
+or
 
 ```html
 <script src="https://unpkg.com/eurostat-map"></script>
 ```
 
-For a fixed version, use:
+then
 
-```html
-<script src="https://unpkg.com/eurostat-map@X.Y.Z"></script>
+```javascript
+eurostatmap
+    .map('choropleth')
+    .title('Population density in Europe')
+    .stat({ eurostatDatasetCode: 'demo_r_d3dens', unitText: 'people/km²' })
+    .legend({ x: 500, y: 180, title: 'Density, people/km²' })
+    .build()
 ```
 
-where X.Y.Z is a [version number](https://www.npmjs.com/package/eurostat-map?activeTab=versions).
+Want a guided setup? Try the notebook:
+https://observablehq.com/@joewdavies/eurostat-map-js
 
 ## Documentation
 
-For detailed documentation see the **[API reference page](docs/reference.md)**.
-
-Code examples:
+For detailed documentation on what eurostat-map can do, see the **[documentation page](docs/reference.md)**.
 
-- [Choropleth map](docs/reference.md#choropleth-map).
-- [Proportional symbol map](docs/reference.md#proportional-symbol-map).
-- [Pie chart map](docs/reference.md#proportional-pie-chart-map).
-- [Categorical map](docs/reference.md#categorical-map).
-- [Bivariate choropleth map](docs/reference.md#bivariate-choropleth-map).
-- [Stripe composition map](docs/reference.md#stripe-composition-map).
-- [Sparkline map](docs/reference.md#sparkline-map).
-- [Flow map](docs/reference.md#flow-map).
-- [Ternary choropleth](docs/reference.md#trivariate-choropleth-map).
-- [Coxcomb map](docs/reference.md#coxcomb-map).
-- [Mushroom map](docs/reference.md#mushroom-map).
-- [Waffle map](docs/reference.md#waffle-map).
-- [Cartograms](docs/reference.md#cartograms).
+For generated, signature-accurate API docs from TypeScript/JSDoc, see [the API docs](https://eurostat.github.io/eurostat-map/docs/api/index.html).
 
 Anything unclear or missing? Feel free to [ask](https://github.com/eurostat/eurostat.js/issues/new)!
 
-## Technical details
-
-Maps based on [NUTS regions](http://ec.europa.eu/eurostat/web/nuts/overview) rely on [Nuts2json API](https://github.com/eurostat/Nuts2json) and [TopoJSON](https://github.com/mbostock/topojson/wiki) format. Statistical data are accessed using [Eurostat STATISTICS API](https://wikis.ec.europa.eu/display/EUROSTATHELP/API+-+Getting+started+with+statistics+API) for [JSON-stat](https://json-stat.org/) data. The data are decoded and queried using [JSON-stat library](https://json-stat.com/). Custom data can also be used with `map.statData().setData({ES:3,FR:2,DE:5})`. Maps are rendered as SVG maps using [D3.js library](https://d3js.org/).
-
 ## About
 
+eurostat-map is an open-source JavaScript library for building interactive, publication-ready statistical maps focused on Europe. It combines D3-based SVG rendering with direct support for Eurostat datasets (JSON-stat), NUTS geographies from Nuts2json, and custom data workflows, and includes map types such as choropleth, proportional symbols, cartograms, flow maps, and composition charts. The project is designed for analysts, journalists, and institutions that need reproducible, configurable map visualizations for both exploratory analysis and official communication.
+
 |                |                                                                                                                                                                                       |
 | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | _contributors_ | [<img src="https://github.com/jgaffuri.png" height="40" />](https://github.com/jgaffuri) [<img src="https://github.com/JoeWDavies.png" height="40" />](https://github.com/JoeWDavies) |

package/build/215.eurostatmap.min.js

@@ -1,3 +1,3 @@
-/*! /*! eurostat-map v4.4.0 | 2026 Eurostat | EUPL License. See https://github.com/eurostat/eurostat-map/blob/master/LICENSE * / */
+/*! /*! eurostat-map v4.4.1 | 2026 Eurostat | EUPL License. See https://github.com/eurostat/eurostat-map/blob/master/LICENSE * / */
 !function webpackUniversalModuleDefinition(e,t){"object"==typeof exports&&"object"==typeof module?module.exports=t():"function"==typeof define&&define.amd?define([],t):"object"==typeof exports?exports.eurostatmap=t():e.eurostatmap=t()}(self,()=>(onmessage=function onmessage(e){var t=e.data,o=t.nodes,r=t.radii,n=t.strengthX,s=t.strengthY,i=t.iterations,p=t.d3URL;importScripts(p||"https://unpkg.com/d3@7/dist/d3.min.js");for(var a=o.map(function(e,t){return e.x=e.properties.centroid[0],e.y=e.properties.centroid[1],e.r=r[t],e}),c=d3.forceSimulation(a).force("x",d3.forceX(function(e){return e.properties.centroid[0]}).strength(n)).force("y",d3.forceY(function(e){return e.properties.centroid[1]}).strength(s)).force("collide",d3.forceCollide(function(e){return e.r}).iterations(i)).stop(),d=Math.ceil(Math.log(c.alphaMin())/Math.log(1-c.alphaDecay())),f=0;f<d;f++)c.tick(),f%10==0&&postMessage({type:"progress",progress:f,total:d});postMessage({type:"end",nodes:a}),self.close()},{}));
 //# sourceMappingURL=215.eurostatmap.min.js.map