eurostat-map 4.11.3 → 4.12.0

package/build/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eurostat-map",
-  "version": "4.11.3",
+  "version": "4.12.0",
   "description": "Reusable library to quickly create and customise web maps showing Eurostat data directly retrieved from Eurostat database.",
   "keywords": [
     "eurostat",

package/build/types/core/InsetConfig.d.ts

@@ -37,6 +37,8 @@ export interface InsetConfig {
     zoomButtons?: boolean
     /** Custom base URL for this inset's nuts2json boundary data. */
     nuts2jsonBaseURL?: string
+    /** Custom URL for this inset's world boundaries topojson (only relevant if the inset's `geo` is 'WORLD'). */
+    worldTopojsonURL?: string
     /** Custom D3 projection function for this inset. */
     projectionFunction?: Function | boolean
 

package/build/types/core/MapConfig.d.ts

@@ -38,6 +38,24 @@ export interface MapConfig {
     nutsLevel?: number | 'mixed'
     /** NUTS boundary year. */
     nutsYear?: number | string
+
+    /**
+     * Base URL used to fetch NUTS2JSON boundary geometries. Applies to the top-level map and
+     * (unless a given inset overrides it via `InsetConfig.nuts2jsonBaseURL`) all of its insets.
+     * @default 'https://raw.githubusercontent.com/eurostat/Nuts2json/master/pub/v2' (or the
+     * ec.europa.eu cache when running on an ec.europa.eu host)
+     */
+    nuts2jsonBaseURL?: string
+
+    /**
+     * URL of the world boundaries topojson file used by `geo: 'WORLD'` maps. Not part of
+     * Nuts2json (a separate, bundled eurostat-map asset), so it is independent of
+     * `nuts2jsonBaseURL`. Applies to the top-level map and all of its insets.
+     * @default 'https://raw.githubusercontent.com/eurostat/eurostat-map/master/src/assets/topojson/WORLD_4326.json'
+     * (or the ec.europa.eu asset host when running on an ec.europa.eu host)
+     */
+    worldTopojsonURL?: string
+
     /** Geographic center as [longitude, latitude]. */
     geoCenter?: [number, number]
 
@@ -130,6 +148,14 @@ export interface MapConfig {
     /** Zoom and pan settings. */
     zoomExtent?: [number, number]
 
+    /**
+     * Divides the exact bbox-fit pixel size used when position().z is left unset, so the
+     * default view is zoomed in tighter than an exact fit (which tends to look too zoomed
+     * out). Higher = more zoomed in by default; 1 = exact fit.
+     * @default 1.27
+     */
+    defaultFitZoom?: number
+
     /** D3 zoom translate extent (pan boundaries), as [[x0, y0], [x1, y1]]. */
     translateExtent?: [[number, number], [number, number]]
 

package/build/types/core/MapInstance.d.ts

@@ -77,6 +77,26 @@ export interface MapInstance {
     nutsYear(): number
     nutsYear(year: number): this
 
+    /**
+     * Base URL used to fetch NUTS2JSON boundary geometries (and, for insets, whatever
+     * base URL is set on the owning map, unless overridden per-inset). Setting this on the
+     * top-level map also propagates it to all insets.
+     * @default 'https://raw.githubusercontent.com/eurostat/Nuts2json/master/pub/v2' (or the
+     * ec.europa.eu cache when running on an ec.europa.eu host)
+     */
+    nuts2jsonBaseURL(): string
+    nuts2jsonBaseURL(url: string): this
+
+    /**
+     * URL of the world boundaries topojson file used by `geo('WORLD')` maps. Not part of
+     * Nuts2json (a separate, bundled eurostat-map asset), so it is independent of
+     * `nuts2jsonBaseURL`. Setting this on the top-level map also propagates it to all insets.
+     * @default 'https://raw.githubusercontent.com/eurostat/eurostat-map/master/src/assets/topojson/WORLD_4326.json'
+     * (or the ec.europa.eu asset host when running on an ec.europa.eu host)
+     */
+    worldTopojsonURL(): string
+    worldTopojsonURL(url: string): this
+
     /**
      * Initial map viewport. x/y in projected coordinates, z is pixel size
      * (map units per screen pixel — smaller = more zoomed in).
@@ -85,6 +105,16 @@ export interface MapInstance {
     position(v: { x?: number; y?: number; z?: number }): this
     position(): { x: number; y: number; z: number }
 
+    /**
+     * Divides the exact bbox-fit pixel size used when position().z is left unset, so the
+     * default view is zoomed in tighter than an exact fit (which tends to look too zoomed
+     * out). Higher = more zoomed in by default; 1 = exact fit.
+     * @default 1.27
+     * @example map.defaultFitZoom(1.5)
+     */
+    defaultFitZoom(): number
+    defaultFitZoom(factor: number): this
+
     /**
      * Custom D3 projection function. When set, also call proj('4326').
      * @example map.projectionFunction(d3.geoAzimuthalEquidistant().rotate([-10, -52]))
@@ -398,6 +428,13 @@ export interface MapInstance {
     backgroundMap(): boolean
     backgroundMap(show: boolean): this
 
+    /**
+     * Shows or hides the background map on an already-built instance to match the current
+     * backgroundMap() value, without a full rebuild - draws it on demand if it wasn't already
+     * built. No-op for grid cartograms.
+     */
+    updateBackgroundMap(): this
+
     /** Minimap (globe inset showing current viewport) configuration. */
     minimap(): MinimapConfig | undefined
     minimap(config: MinimapConfig): this

package/build/types/legend/choropleth/BivariateLegendConfig.d.ts

@@ -48,6 +48,9 @@ export interface BivariateLegendConfig extends LegendConfig {
     /** Whether to show arrows at the end of both axes, or for each axis independently. @default true */
     axisArrows?: boolean | { x?: boolean; y?: boolean }
 
+    /** Whether axis arrows are bidirectional (arrowhead at both ends), for both axes or each axis independently. Has no effect on an axis where `axisArrows` is disabled. @default false */
+    axisArrowsBidirectional?: boolean | { x?: boolean; y?: boolean }
+
     /** Height of axis arrows in pixels. @default 5 */
     arrowHeight?: number
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "eurostat-map",
-    "version": "4.11.3",
+    "version": "4.12.0",
     "description": "Reusable library to quickly create and customise web maps showing Eurostat data directly retrieved from Eurostat database.",
     "keywords": [
         "cartography",