eurostat-map 4.4.0 → 4.4.2

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

@@ -0,0 +1,29 @@
+/**
+ * Strength settings for Dorling force simulation.
+ */
+export interface DorlingStrength {
+    /** X-axis attraction strength. */
+    x: number
+    /** Y-axis attraction strength. */
+    y: number
+}
+
+/**
+ * Settings for Dorling cartogram simulation behavior.
+ */
+export interface DorlingSettings {
+    /** Animate simulation ticks in real time. */
+    animate: boolean
+    /** Gravity strength toward original centroids. */
+    strength: DorlingStrength
+    /** Collision force iterations per tick. */
+    iterations: number
+    /** Extra collision padding between symbols. */
+    padding: number
+    /** Progress callback used by worker-based simulation. */
+    onProgress?: (progress: number, map: any) => void
+    /** Run non-animated simulation in a Web Worker. */
+    worker: boolean
+    /** URL of the D3 bundle used by Dorling worker mode. */
+    workerD3URL?: string
+}

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

@@ -0,0 +1,30 @@
+/**
+ * Margins used to place and center grid cartograms.
+ */
+export interface GridCartogramMargins {
+    /** Top margin in pixels. */
+    top: number
+    /** Right margin in pixels. */
+    right: number
+    /** Bottom margin in pixels. */
+    bottom: number
+    /** Left margin in pixels. */
+    left: number
+}
+
+/**
+ * Settings for grid cartogram layout and geometry.
+ */
+export interface GridCartogramSettings {
+    /** Grid cell shape. */
+    shape: 'square' | 'hexagon'
+    /** Margins around the grid drawing area. */
+    margins: GridCartogramMargins
+    /** Extra spacing between grid cells in pixels. */
+    cellPadding: number
+    /**
+     * Custom grid layout CSV string.
+     * If undefined, the built-in layout for the selected shape is used.
+     */
+    positions?: string
+}

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

@@ -2,13 +2,21 @@
  * Configuration for map insets (smaller additional maps)
  */
 export interface InsetConfig {
-    geo?: string // Geographic code (e.g., 'MT', 'PT20', 'CARIB')
+    /** Geographic code (e.g., 'MT', 'PT20', 'CARIB'). */
+    geo?: string
+    /** Title. */
     title?: string
+    /** Scale. */
     scale?: string | number
+    /** Width. */
     width?: number
+    /** Height. */
     height?: number
+    /** X. */
     x?: number
+    /** Y. */
     y?: number
+    /** Proj. */
     proj?: string
 
     [key: string]: any

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

@@ -3,83 +3,166 @@ import type { LegendConfig } from '../legend/LegendConfig'
 import type { TooltipConfig } from './TooltipConfig'
 import type { InsetConfig } from './InsetConfig'
 import type { MapInstance as EurostatMap } from './MapInstance'
+import type { CoastalMarginSettings } from './decoration/CoastalMarginSettings'
+import type { GridCartogramSettings } from './GridCartogramSettings'
+import type { DorlingSettings } from './DorlingSettings'
+import type { ScalebarConfig } from './decoration/ScalebarConfig'
 
 /**
  * Base configuration for all map types. Each specific map type will extend this with its own properties, but these are the common ones that apply to all maps.
  */
 export interface MapConfig {
-    // Container settings
+    /** Container settings. */
     svgId?: string
+    /** ID of the container element used to host the map. */
     containerId?: string
 
-    // Geographic settings
-    proj?: string // NUTS2json geometries projection: '3035', '3857', '4326'. For custom projections use 4326, then set the desired projection with projectionFunction()
-    projectionFunction?: () => any // Function to set a custom projection. See d3-geo projections for examples.
-    scale?: '60M' | '20M' | '10M' | '03M' | '01M' // Scale of the map, for NUTSjson geometries
-    nutsLevel?: number // 0, 1, 2, 3
+    /** Geographic settings. */
+    /**
+     * NUTS2json geometries projection: '3035', '3857', '4326'.
+     * For custom projections, use 4326 and then set projectionFunction().
+     */
+    proj?: string
+    /** Function to set a custom projection. See d3-geo projections for examples. */
+    projectionFunction?: () => any
+    /** Scale of the map, for NUTSjson geometries. */
+    scale?: '60M' | '20M' | '10M' | '03M' | '01M'
+    /** NUTS level (0, 1, 2, 3). */
+    nutsLevel?: number
+    /** NUTS boundary year. */
     nutsYear?: number | string
+    /** Geographic center as [longitude, latitude]. */
     geoCenter?: [number, number]
-    pixSize?: number
 
-    // Geometry settings
-    geo?: string // NUTS2JSON Geographic focus (e.g., 'EUR', 'WORLD', 'IC', 'GF') see https://github.com/eurostat/Nuts2json#overseas-territories---map-insets
+    /** Geometry settings. */
+    /**
+     * NUTS2JSON geographic focus (e.g., 'EUR', 'WORLD', 'IC', 'GF').
+     * See https://github.com/eurostat/Nuts2json#overseas-territories---map-insets
+     */
+    geo?: string
 
-    // Map dimensions
+    /** Map dimensions. */
     width?: number
+    /** Map height in pixels. */
     height?: number
 
-    // map texts
+    /** Map texts. */
+    /** Map title. */
     title?: string
+    /** Map subtitle. */
     subtitle?: string
-    bottomText?: string
-    botTxtFontSize?: number
-    botTxtPadding?: number
-    botTxtTooltipMessage?: string
+    /** Footnote text shown below the map. */
     footnote?: string
+    /** Data source text. */
     source?: string
 
-    // Statistical data configuration
+    /** Statistical data configuration. */
     stat?: StatConfig
 
-    // Legend configuration
-    legend?: LegendConfig
+    /** Legend configuration. */
+    legend?: LegendConfig | false
 
-    // Tooltip configuration
+    /** Tooltip configuration. */
     tooltip?: TooltipConfig
 
-    // Insets (small additional maps)
+    /** Insets (small additional maps). */
     insets?: InsetConfig[]
 
-    // Zoom and pan settings
+    /** Zoom and pan settings. */
     zoomExtent?: [number, number]
 
-    // UI Controls
-    showBtns?: boolean // Show zoom buttons
+    /** Grid cartogram layout settings. */
+    gridCartogramSettings?: Partial<GridCartogramSettings>
 
-    // Coastal margin
-    coastal?: boolean
-    coastalMarginWidth?: number
-    coastalMarginColor?: string
+    /** Dorling simulation settings. */
+    dorlingSettings?: Partial<DorlingSettings>
 
-    // Graticule
-    drawGraticule?: boolean
-    graticuleStyle?: any
+    /** Show or hide the coastal margin effect. */
+    drawCoastalMargin?: boolean
+    /** Coastal margin settings to override defaults. */
+    coastalMarginSettings?: Partial<CoastalMarginSettings>
 
-    // Borders
-    borderWidth?: number
-    borderColor?: string
+    /** Graticule. */
+    drawGraticule?: boolean
 
-    // Labels
+    /** Labels. */
     labelling?: boolean
-    labelSizeThreshold?: number
-    labelOpacity?: number
 
-    // Logo
-    logoURL?: string
-
-    // Callbacks
+    /** Fires once the map is built. */
     onBuild?: (map: EurostatMap) => void
 
-    // Allow additional properties for extensibility
+    /** Scalebar configuration. Can be boolean or configuration object. */
+    scalebar?: ScalebarConfig | boolean
+
+    /** Grid cartogram enabled or disabled. */
+    gridCartogram?: boolean
+
+    /** Custom geometry filtering function. */
+    filterGeometriesFunction?: (geometry: any) => boolean
+
+    /** Toggle background map rendering (sea, country boundaries, etc.). */
+    backgroundMap?: boolean
+
+    /** Minimap configuration. */
+    minimap?: any
+
+    /** Show/hide zoom +/- buttons. */
+    zoomButtons?: boolean
+
+    /** Show/hide inset map toggle button. */
+    insetsButton?: boolean
+
+    /** Show/hide placename labels. */
+    placenames?: boolean
+
+    /** Filter function for placename labels. */
+    placenamesFilter?: (name: any) => boolean
+
+    /** Use a separate header section for titles. */
+    header?: boolean
+
+    /** Use a separate footer section for footnotes. */
+    footer?: boolean
+
+    /** Padding between the map and footer in pixels. */
+    footerPadding?: number
+
+    /** Padding between the header and map in pixels. */
+    headerPadding?: number
+
+    /** Position adjustment for map title: [x, y] */
+    titlePosition?: [number, number]
+
+    /** Position adjustment for map subtitle: [x, y] */
+    subtitlePosition?: [number, number]
+
+    /** Position adjustment for footnote text: [x, y] */
+    footnotePosition?: [number, number]
+
+    /** Position adjustment for Eurostat logo: [x, y] */
+    logoPosition?: [number, number]
+
+    /** Position adjustment for ribbon banner: [x, y] */
+    ribbonPosition?: [number, number]
+
+    /** Position adjustment for zoom buttons: [x, y] */
+    zoomButtonsPosition?: [number, number]
+
+    /** Position adjustment for insets button: [x, y] */
+    insetsButtonPosition?: [number, number]
+
+    /** Pointer hover color for NUTS regions. */
+    hoverColor?: string
+
+    /** Base fill color for regions with no statistical data. */
+    noDataFillStyle?: string
+
+    /** Show the link to the remote Eurostat statistical dataset. */
+    showSourceLink?: boolean
+
+    /** Pattern fill configurations. */
+    patternFill?: any
+
+    /** Allow additional properties for extensibility. */
     [key: string]: any
 }

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

@@ -3,6 +3,10 @@ import type { StatData } from './stat/StatData'
 import type { LegendConfig } from '../legend/LegendConfig'
 import type { TooltipConfig } from './TooltipConfig'
 import type { InsetConfig } from './InsetConfig'
+import type { CoastalMarginSettings } from './decoration/CoastalMarginSettings'
+import type { GridCartogramSettings } from './GridCartogramSettings'
+import type { DorlingSettings } from './DorlingSettings'
+import type { ScalebarConfig } from './decoration/ScalebarConfig'
 
 /**
  * A eurostat-map instance. Created by eurostatmap.map() and extended
@@ -11,7 +15,7 @@ import type { InsetConfig } from './InsetConfig'
  * return the instance for chaining.
  */
 export interface MapInstance {
-    // ==================== Container ====================
+    /** Container. */
 
     /** ID of the target SVG element. @default 'map' */
     svgId(): string
@@ -21,7 +25,7 @@ export interface MapInstance {
     containerId(): string
     containerId(id: string): this
 
-    // ==================== Dimensions ====================
+    /** Dimensions. */
 
     /** Map width in pixels. @default min(795, window.innerWidth) */
     width(): number
@@ -31,7 +35,7 @@ export interface MapInstance {
     height(): number
     height(h: number): this
 
-    // ==================== Geography ====================
+    /** Geography. */
 
     /**
      * NUTS2JSON geographic focus area.
@@ -78,7 +82,7 @@ export interface MapInstance {
     projectionFunction(): any
     projectionFunction(fn: any): this
 
-    // ==================== Text & Labels ====================
+    /** Text and labels. */
 
     /** Map title. */
     title(): string
@@ -103,7 +107,7 @@ export interface MapInstance {
     footnoteWrap(): number | false
     footnoteWrap(chars: number | false): this
 
-    // ==================== Statistical Data ====================
+    /** Statistical data. */
 
     /**
      * Get or set statistical data configuration.
@@ -142,7 +146,7 @@ export interface MapInstance {
     language(): string
     language(lang: string): this
 
-    // ==================== Legend ====================
+    /** Legend. */
 
     /**
      * Get or set legend configuration. Pass false to remove the legend.
@@ -154,13 +158,13 @@ export interface MapInstance {
     /** Force-update the legend after data or style changes. */
     updateLegend(): this
 
-    // ==================== Tooltip ====================
+    /** Tooltip. */
 
     /** Get or set tooltip configuration. */
     tooltip(): TooltipConfig
     tooltip(config: TooltipConfig): this
 
-    // ==================== Zoom & Pan ====================
+    /** Zoom and pan. */
 
     /**
      * D3 zoom scale extent [min, max].
@@ -173,7 +177,11 @@ export interface MapInstance {
     zoomButtons(): boolean
     zoomButtons(show: boolean): this
 
-    // ==================== Insets ====================
+    /** Grid cartogram settings (shape, margins, cell padding, layout positions). */
+    gridCartogramSettings(): GridCartogramSettings
+    gridCartogramSettings(settings: Partial<GridCartogramSettings>): this
+
+    /** Insets. */
 
     /**
      * Inset map configurations. Pass 'default' for the standard
@@ -184,7 +192,7 @@ export interface MapInstance {
     insets(): InsetConfig[] | 'default' | false
     insets(config: InsetConfig[] | 'default' | false): this
 
-    // ==================== Decoration ====================
+    /** Decoration. */
 
     /** Show/hide the graticule (coordinate grid lines). */
     drawGraticule(): boolean
@@ -195,8 +203,8 @@ export interface MapInstance {
     drawCoastalMargin(show: boolean): this
 
     /** Coastal margin appearance settings. */
-    coastalMarginSettings(): object
-    coastalMarginSettings(settings: object): this
+    coastalMarginSettings(): CoastalMarginSettings
+    coastalMarginSettings(settings: Partial<CoastalMarginSettings>): this
 
     /** Show/hide placename labels loaded from the placenames layer. */
     placenames(): boolean
@@ -214,6 +222,10 @@ export interface MapInstance {
     stamp(): object | undefined
     stamp(config: { x: number; y: number; text: string; size?: number }): this
 
+    /** Scalebar configuration. */
+    scalebar(): ScalebarConfig | null
+    scalebar(config: ScalebarConfig | boolean): this
+
     /** Scalebar visibility. */
     showScalebar(): boolean
     showScalebar(show: boolean): this
@@ -230,29 +242,105 @@ export interface MapInstance {
     showEstatRibbon(): boolean
     showEstatRibbon(show: boolean): this
 
-    // ==================== Dorling ====================
+    /** Returns the D3 selection of the SVG element. */
+    svg(): any
+    svg(s: any): this
 
-    /** Enable Dorling cartogram layout for proportional symbol maps. */
-    dorling(): boolean
-    dorling(enable: boolean): this
+    /** Custom geometry filtering function. */
+    filterGeometriesFunction(): ((geometry: any) => boolean) | undefined
+    filterGeometriesFunction(fn: (geometry: any) => boolean): this
+
+    /** Grid cartogram enabled or disabled. */
+    gridCartogram(): boolean
+    gridCartogram(enable: boolean): this
+
+    /** Toggle background map rendering (sea, country boundaries, etc.). */
+    backgroundMap(): boolean
+    backgroundMap(show: boolean): this
+
+    /** Minimap configuration. */
+    minimap(): any
+    minimap(config: any): this
+
+    /** Show/hide inset map toggle button. */
+    insetsButton(): boolean
+    insetsButton(show: boolean): this
+
+    /** Filter function for placename labels. */
+    placenamesFilter(): ((name: any) => boolean) | undefined
+    placenamesFilter(fn: (name: any) => boolean): this
+
+    /** Use a separate header section for titles. */
+    header(): boolean
+    header(show: boolean): this
+
+    /** Use a separate footer section for footnotes. */
+    footer(): boolean
+    footer(show: boolean): this
+
+    /** Padding between the map and footer in pixels. */
+    footerPadding(): number | undefined
+    footerPadding(padding: number): this
+
+    /** Padding between the header and map in pixels. */
+    headerPadding(): number | undefined
+    headerPadding(padding: number): this
 
-    /** Animate the Dorling simulation. @default true */
-    animateDorling(): boolean
-    animateDorling(animate: boolean): this
+    /** Position adjustment for map title: [x, y] */
+    titlePosition(): [number, number] | undefined
+    titlePosition(pos: [number, number]): this
 
-    /** Dorling simulation gravity strength. @default { x: 1, y: 1 } */
-    dorlingStrength(): { x: number; y: number }
-    dorlingStrength(strength: { x: number; y: number }): this
+    /** Position adjustment for map subtitle: [x, y] */
+    subtitlePosition(): [number, number] | undefined
+    subtitlePosition(pos: [number, number]): this
 
-    /** Number of Dorling collision detection iterations. @default 1 */
-    dorlingIterations(): number
-    dorlingIterations(n: number): this
+    /** Position adjustment for footnote text: [x, y] */
+    footnotePosition(): [number, number] | undefined
+    footnotePosition(pos: [number, number]): this
+
+    /** Position adjustment for Eurostat logo: [x, y] */
+    logoPosition(): [number, number] | undefined
+    logoPosition(pos: [number, number]): this
+
+    /** Position adjustment for ribbon banner: [x, y] */
+    ribbonPosition(): [number, number] | undefined
+    ribbonPosition(pos: [number, number]): this
+
+    /** Position adjustment for zoom buttons: [x, y] */
+    zoomButtonsPosition(): [number, number] | undefined
+    zoomButtonsPosition(pos: [number, number]): this
+
+    /** Position adjustment for insets button: [x, y] */
+    insetsButtonPosition(): [number, number] | undefined
+    insetsButtonPosition(pos: [number, number]): this
+
+    /** Pointer hover color for NUTS regions. */
+    hoverColor(): string
+    hoverColor(color: string): this
+
+    /** Base fill color for regions with no statistical data. */
+    noDataFillStyle(): string
+    noDataFillStyle(style: string): this
+
+    /** Show the link to the remote Eurostat statistical dataset. */
+    showSourceLink(): boolean
+    showSourceLink(show: boolean): this
+
+    /** Pattern fill configurations. */
+    patternFill(): any
+    patternFill(config: any): this
+
+    /** Dorling. */
+
+    /** Enable Dorling cartogram layout for proportional symbol maps. */
+    dorling(): boolean
+    dorling(enable: boolean): this
 
-    /** Minimum distance between Dorling circles. Negative allows overlap. @default 0 */
-    dorlingPadding(): number
-    dorlingPadding(padding: number): this
+    /** Dorling simulation settings. */
+    dorlingSettings(): DorlingSettings
+    dorlingSettings(settings: Partial<DorlingSettings>): this
 
-    // ==================== Events ====================
+    /** Events. */
 
     /** Called when the user finishes a zoom gesture. */
     onZoomEnd(): ((event: any) => void) | undefined
@@ -286,7 +374,7 @@ export interface MapInstance {
     onBuild(): ((map: MapInstance) => void) | undefined
     onBuild(callback: (map: MapInstance) => void): this
 
-    // ==================== Build & Update ====================
+    /** Build and update. */
 
     /**
      * Builds the map from scratch. Call once after initial configuration.
@@ -315,7 +403,7 @@ export interface MapInstance {
     /** Recalculates header/footer layout and resizes the SVG. */
     recalculateLayout(): void
 
-    // ==================== Export ====================
+    /** Export. */
 
     /**
      * Exports the map as an SVG file and triggers a browser download.
@@ -330,7 +418,7 @@ export interface MapInstance {
      */
     exportMapToPNG(width?: number, height?: number): Promise<this>
 
-    // ==================== Misc ====================
+    /** Misc. */
 
     /**
      * Sets map attributes from URL parameters.

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

@@ -5,8 +5,11 @@ import type { MapInstance as EurostatMap } from './MapInstance'
  */
 export interface TooltipConfig {
     textFunction?: (region: any, map: EurostatMap) => string
+    /** Omit regions. */
     omitRegions?: string[]
+    /** Max width. */
     maxWidth?: number
+    /** Font size. */
     fontSize?: number
 
     [key: string]: any

package/build/types/core/decoration/CoastalMarginSettings.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Visual settings for the coastal margin effect.
+ */
+export interface CoastalMarginSettings {
+    /** Gaussian blur standard deviation. */
+    standardDeviation: number
+    /** Filter x bound (SVG filter coordinate space). */
+    x: string
+    /** Filter y bound (SVG filter coordinate space). */
+    y: string
+    /** Filter width (SVG filter coordinate space). */
+    width: string
+    /** Filter height (SVG filter coordinate space). */
+    height: string
+    /** Coastal stroke width. */
+    strokeWidth: number
+    /** Coastal stroke color. */
+    color: string
+    /** Coastal stroke opacity. */
+    opacity: number
+}

package/build/types/core/geo/geometries.d.ts

@@ -13,12 +13,19 @@ export interface GeometriesClass {
     centroidsData: any
     /** Processed GeoJSON features organized by type */
     geoJSONs: {
+        /** Nutsrg. */
         nutsrg?: any[]
+        /** Nutsbn. */
         nutsbn?: any[]
+        /** Cntrg. */
         cntrg?: any[]
+        /** Cntbn. */
         cntbn?: any[]
+        /** Worldrg. */
         worldrg?: any[]
+        /** Graticule. */
         graticule?: any[]
+        /** Mixed. */
         mixed?: any
     }
     /** User-provided custom geometries */
@@ -34,13 +41,21 @@ export interface GeometriesClass {
     setUserGeometries(geometries: any[]): void
     /** Adds default NUTS geometries to the map */
     addDefaultGeometriesToMap(
+        /** Zoom group. */
         zoomGroup: any,
+        /** Draw graticule. */
         drawGraticule: boolean,
+        /** Path function. */
         pathFunction: any,
+        /** Nuts level. */
         nutsLevel: number | string,
+        /** Nuts year. */
         nutsYear: number,
+        /** Geo. */
         geo: string,
+        /** Proj. */
         proj: string,
+        /** Scale. */
         scale: string
     ): void
     /** Adds user-defined geometries to the map */

package/build/types/core/geo/kosovo.d.ts

@@ -4,7 +4,9 @@
  */
 export const kosovoBnFeatures: {
     [year: number]: {
+        /** Type. */
         type: 'FeatureCollection'
+        /** Features. */
         features: any[]
     }
 }

package/build/types/core/stat/StatData.d.ts

@@ -83,11 +83,17 @@ export interface StatData {
 
     /** Metadata from the Eurostat API response or CSV source. */
     metadata?: {
+        /** Label. */
         label?: string
+        /** Href. */
         href?: string
+        /** Source. */
         source?: string
+        /** Updated. */
         updated?: string
+        /** Time. */
         time?: string
+        /** Extension. */
         extension?: any
     }