eurostat-map 4.8.3 → 4.8.6

package/build/package.json

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

package/build/types/legend/LegendConfig.d.ts

@@ -1,73 +1,73 @@
-/**
- * Parent configuration for map legends. Each map type will extend this with its own specific properties, but these are the common ones that apply to all legend types.
- */
-export interface LegendConfig {
-    /** Legend origin x-coordinate in pixels. */
-    x?: number
-    /** Legend origin y-coordinate in pixels. */
-    y?: number
-    /** Automatically position the legend in a map corner. Manual x/y coordinates take precedence. */
-    position?: 'top right' | 'bottom right' | 'top left' | 'bottom left'
-    /** Legend width in pixels. */
-    width?: number
-    /** Legend height in pixels. */
-    height?: number
-
-    /** Legend title text. */
-    title?: string
-    /** Legend subtitle text. */
-    subtitle?: string
-    /** Legend title font size in pixels. */
-    titleFontSize?: number
-
-    /** Box styling. */
-    /** Inner spacing around legend content. */
-    boxPadding?: number
-    /** Background opacity of the legend box. */
-    boxOpacity?: number
-    /** Apply legend hover opacity/highlighting only while the map is currently zoomed in (scale != 1); disabled again once zoomed back out to the initial view. */
-    onlyApplyOpacityWhileZoomed?: boolean
-    /** Padding between the title block and legend body. */
-    titlePadding?: number
-
-    /** Shape styling (for proportional symbol legends). */
-    /** Symbol swatch width in pixels. */
-    shapeWidth?: number
-    /** Symbol swatch height in pixels. */
-    shapeHeight?: number
-    /** Horizontal gap between shape and label. */
-    shapePadding?: number
-    /** Length of separator lines in discrete legends. */
-    sepLineLength?: number
-
-    /** Label styling. */
-    /** Label font size in pixels. */
-    labelFontSize?: number
-    /** Pixel offsets applied to labels. */
-    labelOffsets?: { x: number; y: number }
-    /** Custom formatter for legend labels. */
-    labelFormatter?: ((value: number, index?: number) => string) | null
-    /** Number of decimal places for auto-formatted labels. */
-    decimals?: number
-
-    /** Legend layout direction. */
-    orientation?: 'vertical' | 'horizontal'
-    /** Sort legend entries in ascending order when true. */
-    ascending?: boolean
-    /** Whether to display the no-data legend item. */
-    noData?: boolean
-    /** Label used for no-data legend item. */
-    noDataText?: string
-    /** Vertical gap before the no-data swatch in pixels. */
-    noDataPadding?: number
-    /** Width of the no-data swatch in pixels. */
-    noDataShapeWidth?: number
-    /** Height of the no-data swatch in pixels. */
-    noDataShapeHeight?: number
-
-    /** Whether to show dataset min/max labels when supported. */
-    maxMin?: boolean
-    /** Text affixes for min/max labels as [minSuffix, maxSuffix]. */
-    maxMinLabels?: [string, string]
-    layer?: any
-}
+/**
+ * Parent configuration for map legends. Each map type will extend this with its own specific properties, but these are the common ones that apply to all legend types.
+ */
+export interface LegendConfig {
+    /** Legend origin x-coordinate in pixels. */
+    x?: number
+    /** Legend origin y-coordinate in pixels. */
+    y?: number
+    /** Automatically position the legend in a map corner. Manual x/y coordinates take precedence. */
+    position?: 'top right' | 'bottom right' | 'top left' | 'bottom left'
+    /** Legend width in pixels. */
+    width?: number
+    /** Legend height in pixels. */
+    height?: number
+
+    /** Legend title text. */
+    title?: string
+    /** Legend subtitle text. */
+    subtitle?: string
+    /** Legend title font size in pixels. */
+    titleFontSize?: number
+
+    /** Box styling. */
+    /** Inner spacing around legend content. */
+    boxPadding?: number
+    /** Background opacity of the legend box. */
+    boxOpacity?: number
+    /** Apply the legend box's background opacity (boxOpacity) only while the map is currently zoomed in (scale != 1). The legend box is transparent at the initial view and returns to its configured opacity while zoomed. Purely a box-opacity concern - does not affect legend hover interactions (e.g. hover-to-highlight), which always work regardless of zoom state. */
+    onlyApplyOpacityWhileZoomed?: boolean
+    /** Padding between the title block and legend body. */
+    titlePadding?: number
+
+    /** Shape styling (for proportional symbol legends). */
+    /** Symbol swatch width in pixels. */
+    shapeWidth?: number
+    /** Symbol swatch height in pixels. */
+    shapeHeight?: number
+    /** Horizontal gap between shape and label. */
+    shapePadding?: number
+    /** Length of separator lines in discrete legends. */
+    sepLineLength?: number
+
+    /** Label styling. */
+    /** Label font size in pixels. */
+    labelFontSize?: number
+    /** Pixel offsets applied to labels. */
+    labelOffsets?: { x: number; y: number }
+    /** Custom formatter for legend labels. */
+    labelFormatter?: ((value: number, index?: number) => string) | null
+    /** Number of decimal places for auto-formatted labels. */
+    decimals?: number
+
+    /** Legend layout direction. */
+    orientation?: 'vertical' | 'horizontal'
+    /** Sort legend entries in ascending order when true. */
+    ascending?: boolean
+    /** Whether to display the no-data legend item. */
+    noData?: boolean
+    /** Label used for no-data legend item. */
+    noDataText?: string
+    /** Vertical gap before the no-data swatch in pixels. */
+    noDataPadding?: number
+    /** Width of the no-data swatch in pixels. */
+    noDataShapeWidth?: number
+    /** Height of the no-data swatch in pixels. */
+    noDataShapeHeight?: number
+
+    /** Whether to show dataset min/max labels when supported. */
+    maxMin?: boolean
+    /** Text affixes for min/max labels as [minSuffix, maxSuffix]. */
+    maxMinLabels?: [string, string]
+    layer?: any
+}

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

@@ -1,135 +1,126 @@
-import { LegendConfig } from '../LegendConfig'
-
-/**
- * Configuration for bivariate choropleth map legends.
- * Displays a 2D grid showing the relationship between two variables,
- * with color squares representing different class combinations.
- */
-export interface BivariateLegendConfig extends LegendConfig {
-    /** Size of the legend square grid in pixels. @default 100 */
-    squareSize?: number
-
-    /** Rotation angle of the legend in degrees. @default 0 */
-    rotation?: number
-
-    /** Label for the first variable (x-axis). Supports `\\n` and `<br>` line breaks. @default 'Variable 1' */
-    label1?: string
-
-    /** Label for the second variable (y-axis). Supports `\\n` and `<br>` line breaks. @default 'Variable 2' */
-    label2?: string
-
-    /** Break labels for the first variable. Omit to hide first-axis break labels. */
-    breaks1?: Array<number | string>
-
-    /** Break labels for the second variable. Omit to hide second-axis break labels. */
-    breaks2?: Array<number | string>
-
-    /** Length of axis tick marks in pixels. @default 5 */
-    tickLength?: number
-
-    /** Offset adjustments for y-axis labels. @default { x: 0, y: 0 } */
-    yAxisLabelsOffset?: { x: number; y: number }
-
-    /** Offset adjustments for x-axis labels. @default { x: 0, y: 0 } */
-    xAxisLabelsOffset?: { x: number; y: number }
-
-    /** Offset adjustments for y-axis title. @default { x: 0, y: 0 } */
-    yAxisTitleOffset?: { x: number; y: number }
-
-    /** Offset adjustments for x-axis title. @default { x: 0, y: 0 } */
-    xAxisTitleOffset?: { x: number; y: number }
-
-    /** Extra vertical offset for the "no data" legend item in pixels. @default 30 */
-    noDataYOffset?: number
-
-    /** Whether to show arrows at the end of both axes, or for each axis independently. @default true */
-    axisArrows?: boolean | { x?: boolean; y?: boolean }
-
-    /** Height of axis arrows in pixels. @default 15 */
-    arrowHeight?: number
-
-    /** Width of axis arrows in pixels. @default 14 */
-    arrowWidth?: number
-
-    /** Padding between arrow and axis label in pixels. @default 10 */
-    arrowPadding?: number
-
-    /**
-     * Labels displayed at low/high ends of each axis.
-     * @default { x: { low: 'Low', high: 'High' }, y: { low: 'Low', high: 'High' } }
-     */
-    axisExtremes?: {
-        x?: { low?: string; high?: string }
-        y?: { low?: string; high?: string }
-    }
-
-    /** Whether to show low/high endpoint labels on both axes, or for each axis independently. @default true */
-    showAxisExtremes?: boolean | { x?: boolean; y?: boolean }
-
-    /**
-     * Optional text annotations for each corner of the bivariate square.
-     * Add text for any combination of topRight, bottomRight, bottomLeft, topLeft.
-     * Supports line breaks using '<br>'/'<br/>' or '\\n'.
-     */
-    annotations?: {
-        topRight?: string
-        bottomRight?: string
-        bottomLeft?: string
-        topLeft?: string
-    }
-
-    /**
-     * Length of corner annotation callout lines in pixels.
-     * Can be a single number for all corners, or per-corner values.
-     * @default 18
-     */
-    annotationLineLength?:
-        | number
-        | {
-              topRight?: number
-              bottomRight?: number
-              bottomLeft?: number
-              topLeft?: number
-          }
-
-    /**
-     * Annotation text offsets in pixels.
-     * Use global `{ x, y }` or per-corner values.
-     * @default auto (based on corner direction)
-     */
-    annotationOffsets?:
-        | { x?: number; y?: number }
-        | {
-              topRight?: { x?: number; y?: number }
-              bottomRight?: { x?: number; y?: number }
-              bottomLeft?: { x?: number; y?: number }
-              topLeft?: { x?: number; y?: number }
-          }
-
-    /**
-     * Extra offset applied to the leader-line endpoint where it meets the annotation label.
-     * Use global `{ x, y }` or per-corner values.
-     * @default { x: 0, y: 0 }
-     */
-    annotationLineEndOffset?:
-        | { x?: number; y?: number }
-        | {
-              topRight?: { x?: number; y?: number }
-              bottomRight?: { x?: number; y?: number }
-              bottomLeft?: { x?: number; y?: number }
-              topLeft?: { x?: number; y?: number }
-          }
-
-    /**
-     * @deprecated Use annotationOffsets instead.
-     * Radial padding between corner annotation callout line end and text in pixels.
-     */
-    annotationPadding?:
-        | number
-        | {
-              topRight?: number
-              bottomRight?: number
-              bottomLeft?: number
-              topLeft?: number
-          }
+import { LegendConfig } from '../LegendConfig'
+
+/**
+ * Configuration for bivariate choropleth map legends.
+ * Displays a 2D grid showing the relationship between two variables,
+ * with color squares representing different class combinations.
+ */
+export interface BivariateLegendConfig extends LegendConfig {
+    /** Size of the legend square grid in pixels. @default 100 */
+    squareSize?: number
+
+    /** Rotation angle of the legend in degrees. @default 0 */
+    rotation?: number
+
+    /** Label for the first variable (x-axis). Supports `\\n` and `<br>` line breaks. @default 'Variable 1' */
+    label1?: string
+
+    /** Label for the second variable (y-axis). Supports `\\n` and `<br>` line breaks. @default 'Variable 2' */
+    label2?: string
+
+    /** Break labels for the first variable. Omit to hide first-axis break labels. */
+    breaks1?: Array<number | string>
+
+    /** Break labels for the second variable. Omit to hide second-axis break labels. */
+    breaks2?: Array<number | string>
+
+    /** Length of axis tick marks in pixels. @default 5 */
+    tickLength?: number
+
+    /** Offset adjustments for y-axis labels. @default { x: 0, y: 0 } */
+    yAxisLabelsOffset?: { x: number; y: number }
+
+    /** Offset adjustments for x-axis labels. @default { x: 0, y: 0 } */
+    xAxisLabelsOffset?: { x: number; y: number }
+
+    /** Offset adjustments for y-axis title. @default { x: 0, y: 0 } */
+    yAxisTitleOffset?: { x: number; y: number }
+
+    /** Offset adjustments for x-axis title. @default { x: 0, y: 0 } */
+    xAxisTitleOffset?: { x: number; y: number }
+
+    /** Font size of the axis titles in pixels. Defaults to the value defined by the legend CSS. */
+    axisTitleFontSize?: number
+
+    /** Extra vertical offset for the "no data" legend item in pixels. @default 30 */
+    noDataYOffset?: number
+
+    /** Whether to show arrows at the end of both axes, or for each axis independently. @default true */
+    axisArrows?: boolean | { x?: boolean; y?: boolean }
+
+    /** Height of axis arrows in pixels. @default 15 */
+    arrowHeight?: number
+
+    /** Width of axis arrows in pixels. @default 14 */
+    arrowWidth?: number
+
+    /** Padding between arrow and axis label in pixels. @default 10 */
+    arrowPadding?: number
+
+    /**
+     * Labels displayed at low/high ends of each axis.
+     * @default { x: { low: 'Low', high: 'High' }, y: { low: 'Low', high: 'High' } }
+     */
+    axisExtremes?: {
+        x?: { low?: string; high?: string }
+        y?: { low?: string; high?: string }
+    }
+
+    /** Whether to show low/high endpoint labels on both axes, or for each axis independently. @default true */
+    showAxisExtremes?: boolean | { x?: boolean; y?: boolean }
+
+    /**
+     * Optional text annotations for each corner of the bivariate square.
+     * Add text for any combination of topRight, bottomRight, bottomLeft, topLeft.
+     * Supports line breaks using '<br>'/'<br/>' or '\\n'.
+     */
+    annotations?: {
+        topRight?: string
+        bottomRight?: string
+        bottomLeft?: string
+        topLeft?: string
+    }
+
+    /**
+     * Length of corner annotation callout lines in pixels.
+     * Can be a single number for all corners, or per-corner values.
+     * @default 18
+     */
+    annotationLineLength?:
+        | number
+        | {
+              topRight?: number
+              bottomRight?: number
+              bottomLeft?: number
+              topLeft?: number
+          }
+
+    /**
+     * Annotation text offsets in pixels.
+     * Use global `{ x, y }` or per-corner values.
+     * @default auto (based on corner direction)
+     */
+    annotationOffsets?:
+        | { x?: number; y?: number }
+        | {
+              topRight?: { x?: number; y?: number }
+              bottomRight?: { x?: number; y?: number }
+              bottomLeft?: { x?: number; y?: number }
+              topLeft?: { x?: number; y?: number }
+          }
+
+    /**
+     * Extra offset applied to the leader-line endpoint where it meets the annotation label.
+     * Use global `{ x, y }` or per-corner values.
+     * @default { x: 0, y: 0 }
+     */
+    annotationLineEndOffsets?:
+        | { x?: number; y?: number }
+        | {
+              topRight?: { x?: number; y?: number }
+              bottomRight?: { x?: number; y?: number }
+              bottomLeft?: { x?: number; y?: number }
+              topLeft?: { x?: number; y?: number }
+          }
+
 }

package/package.json

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