eurostat-map 4.9.1 → 4.9.3

package/build/types/layers/composition/bar/BarMapConfig.d.ts

@@ -1,76 +1,76 @@
-import type { MapConfig } from '../../../core/MapConfig'
-import type { BarChartLegendConfig } from '../../../legend/composition/BarChartLegendConfig'
-
-/**
- * Configuration for bar chart composition maps.
- */
-export interface BarMapConfig extends MapConfig {
-    /** Bar type. */
-    barType?: 'stacked' | 'grouped'
-    /** Cat colors. */
-    catColors?: Record<string, string>
-    /** Cat labels. */
-    catLabels?: Record<string, string>
-    /** Show only when complete. */
-    showOnlyWhenComplete?: boolean
-    /** No data fill style. */
-    noDataFillStyle?: string
-    /** Bar min width. */
-    barMinWidth?: number
-    /** Bar max width. */
-    barMaxWidth?: number
-    /** Bar height. */
-    barHeight?: number
-    /** Bar group width. */
-    barGroupWidth?: number
-    /** Grouped bar settings object. */
-    barSettings?: {
-        type?: 'stacked' | 'grouped'
-        minWidth?: number
-        maxWidth?: number
-        height?: number
-        groupWidth?: number
-        groupMinWidth?: number
-        groupMaxWidth?: number
-        groupGap?: number
-        groupMinHeight?: number
-        groupMaxHeight?: number
-        groupMaxValue?: number
-        groupMaxWidthValue?: number
-        strokeFill?: string
-        strokeWidth?: number
-        cornerRadius?: number
-        otherColor?: string
-        otherText?: string
-        tooltipWidth?: number
-        tooltipHeight?: number
-    }
-    /** Bar group gap. */
-    barGroupGap?: number
-    /** Bar group min height. */
-    barGroupMinHeight?: number
-    /** Bar group max height. */
-    barGroupMaxHeight?: number
-    /** Bar stroke fill. */
-    barStrokeFill?: string
-    /** Bar stroke width. */
-    barStrokeWidth?: number
-    /** Bar corner radius. */
-    barCornerRadius?: number
-    /** Bar other color. */
-    barOtherColor?: string
-    /** Bar other text. */
-    barOtherText?: string
-    /** Bar tooltip width. */
-    barTooltipWidth?: number
-    /** Bar tooltip height. */
-    barTooltipHeight?: number
-    /** Dorling. */
-    dorling?: boolean
-    /** Bar total code. */
-    barTotalCode?: string
-    /** Stat codes. */
-    statCodes?: string[]
-    /** Legend. */
-    legend?: BarChartLegendConfig | false
-}
+import type { MapConfig } from '../../../core/MapConfig'
+import type { BarChartLegendConfig } from '../../../legend/composition/BarChartLegendConfig'
+
+/**
+ * Configuration for bar chart composition maps.
+ */
+export interface BarMapConfig extends MapConfig {
+    /** Bar type. */
+    barType?: 'stacked' | 'grouped'
+    /** Cat colors. */
+    catColors?: Record<string, string>
+    /** Cat labels. */
+    catLabels?: Record<string, string>
+    /** Show only when complete. */
+    showOnlyWhenComplete?: boolean
+    /** No data fill style. */
+    noDataFillStyle?: string
+    /** Bar min width. */
+    barMinWidth?: number
+    /** Bar max width. */
+    barMaxWidth?: number
+    /** Bar height. */
+    barHeight?: number
+    /** Bar group width. */
+    barGroupWidth?: number
+    /** Grouped bar settings object. */
+    barSettings?: {
+        type?: 'stacked' | 'grouped'
+        minWidth?: number
+        maxWidth?: number
+        height?: number
+        groupWidth?: number
+        groupMinWidth?: number
+        groupMaxWidth?: number
+        groupGap?: number
+        groupMinHeight?: number
+        groupMaxHeight?: number
+        groupMaxValue?: number
+        groupMaxWidthValue?: number
+        strokeFill?: string
+        strokeWidth?: number
+        cornerRadius?: number
+        otherColor?: string
+        otherText?: string
+        tooltipWidth?: number
+        tooltipHeight?: number
+    }
+    /** Bar group gap. */
+    barGroupGap?: number
+    /** Bar group min height. */
+    barGroupMinHeight?: number
+    /** Bar group max height. */
+    barGroupMaxHeight?: number
+    /** Bar stroke fill. */
+    barStrokeFill?: string
+    /** Bar stroke width. */
+    barStrokeWidth?: number
+    /** Bar corner radius. */
+    barCornerRadius?: number
+    /** Bar other color. */
+    barOtherColor?: string
+    /** Bar other text. */
+    barOtherText?: string
+    /** Bar tooltip width. */
+    barTooltipWidth?: number
+    /** Bar tooltip height. */
+    barTooltipHeight?: number
+    /** Dorling. */
+    dorling?: boolean
+    /** Bar total code. */
+    barTotalCode?: string
+    /** Stat codes. */
+    statCodes?: string[]
+    /** Legend. */
+    legend?: BarChartLegendConfig | false
+}

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 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
-}
+/**
+ * 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

@@ -123,4 +123,4 @@ export interface BivariateLegendConfig extends LegendConfig {
               topLeft?: { x?: number; y?: number }
           }
 
-}
+}

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

@@ -1,22 +1,64 @@
-import type { LegendConfig } from '../LegendConfig'
-
-/**
- * Configuration for the ranked bar chart element on choropleth-classified maps: one horizontal
- * bar per region, sorted by value, colored by the region's own class color, labeled with its id
- * and value. Above an internal region-count threshold, falls back automatically to the histogram
- * distribution view instead of drawing one bar per region.
- *
- * Independent of the legend - has its own positioning (inherited from LegendConfig's x/y/
- * position/width fields) and can render into an entirely different container/SVG to the
- * legend's, rather than being a sub-feature of it. Set via `map.rankedBarChart(config)`,
- * separately from `map.legend(config)`.
- */
-export interface RankedBarChartConfig extends LegendConfig {
-    /**
-     * Limit which regions appear to a political grouping: EU member states, EU + EFTA, or
-     * EU + EFTA + EU candidate countries. Applied before the region-count threshold that
-     * triggers the histogram distribution fallback. Omit (default) to show every region with
-     * a value, unfiltered.
-     */
-    countryGroup?: 'eu' | 'euEfta' | 'euEftaCc'
-}
+/**
+ * Configuration for the ranked bar chart element on choropleth-classified maps: one horizontal
+ * bar per region, sorted by value, colored by the region's own class color, labeled with its id
+ * and value. Above an internal region-count threshold, falls back automatically to the histogram
+ * distribution view instead of drawing one bar per region.
+ *
+ * A standalone element, independent of the legend - not a sub-feature of it, and deliberately not
+ * an extension of LegendConfig: it has its own container/positioning and doesn't carry the
+ * legend-only concepts (no-data swatch, max/min labels, etc.) that don't apply to it. Set via
+ * `map.rankedBarChart(config)`, separately from `map.legend(config)`.
+ */
+export interface RankedBarChartConfig {
+    /** Id of the SVG element to render the chart into. Can be a completely different container/
+     * SVG to the legend's. @default an internally-generated id */
+    svgId?: string
+    /** Chart origin x-coordinate in pixels. */
+    x?: number
+    /** Chart origin y-coordinate in pixels. */
+    y?: number
+    /** Automatically position the chart in a map corner. Manual x/y coordinates take precedence. */
+    position?: 'top right' | 'bottom right' | 'top left' | 'bottom left'
+    /** Approximate box width in pixels, used only as a fallback when auto-positioning in a corner
+     * without explicit x/y. @default 150 */
+    width?: number
+    /** Maximum total height in pixels for the rendered chart (title/subtitle + bars). When the
+     * natural height of all bars would exceed this, bar height and label font size are both
+     * scaled down proportionally so the chart never grows taller than this budget. Omit to let
+     * the chart grow to fit its content - its natural height with ~35 EU/EFTA/CC regions can
+     * easily exceed a map's own height. */
+    height?: number
+
+    /** Chart title text. */
+    title?: string
+    /** Chart subtitle text. */
+    subtitle?: string
+
+    /** Inner spacing around the chart content in pixels. @default 7 */
+    boxPadding?: number
+    /** Background opacity of the chart's box. @default 0.9 */
+    boxOpacity?: number
+    /** Apply the chart box's background opacity (boxOpacity) only while the map is currently
+     * zoomed in (scale != 1). Purely a box-opacity concern - does not affect hover interactions
+     * (e.g. hover-to-highlight), which always work regardless of zoom state. */
+    onlyApplyOpacityWhileZoomed?: boolean
+
+    /** Bar height in pixels, before any height-based scaling (see height). @default 20 */
+    shapeHeight?: number
+    /** Label font size in pixels, before any height-based scaling (see height).
+     * @default read from the .em-legend-label CSS class */
+    labelFontSize?: number
+    /** Custom formatter for each region's value label. */
+    labelFormatter?: ((value: number, index?: number) => string) | null
+    /** Number of decimal places for auto-formatted value labels. Auto-detected when undefined. */
+    decimals?: number
+
+    /** Sort bars in ascending order of value when true, descending when false. @default true */
+    ascending?: boolean
+
+    /** Limit which regions appear to a political grouping: EU member states, EU + EFTA, or
+     * EU + EFTA + EU candidate countries. Applied before the region-count threshold that
+     * triggers the histogram distribution fallback. Omit (default) to show every region with
+     * a value, unfiltered. */
+    countryGroup?: 'eu' | 'euEfta' | 'euEftaCc'
+}

package/build/types/legend/choropleth/legend-choropleth-bivariate.d.ts

@@ -1,2 +1,2 @@
-/** Creates a bivariate choropleth legend */
-export function legend(config?: any): any
+/** Creates a bivariate choropleth legend */
+export function legend(config?: any): any

package/build/types/legend/choropleth/legend-choropleth-trivariate.d.ts

@@ -1,2 +1,2 @@
-/** Creates a trivariate choropleth legend */
-export function legend(config?: any): any
+/** Creates a trivariate choropleth legend */
+export function legend(config?: any): any

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

@@ -1,2 +1,2 @@
-/** Creates a choropleth legend */
-export function legend(config?: any): any
+/** Creates a choropleth legend */
+export function legend(config?: any): any

package/build/types/legend/composition/legend-bar-chart.d.ts

@@ -1,2 +1,2 @@
-/** Creates a bar chart legend */
-export function legend(config?: any): any
+/** Creates a bar chart legend */
+export function legend(config?: any): any

package/build/types/legend/flow/legend-flow.d.ts

@@ -1,2 +1,2 @@
-/** Creates a flow map legend */
-export function legend(config?: any): any
+/** Creates a flow map legend */
+export function legend(config?: any): any

package/build/types/legend/legend-categorical.d.ts

@@ -1,2 +1,2 @@
-/** Creates a categorical legend */
-export function legend(config?: any): any
+/** Creates a categorical legend */
+export function legend(config?: any): any

package/build/types/legend/legend-continuous.d.ts

@@ -1,2 +1,2 @@
-/** Creates a continuous legend */
-export function legend(config?: any): any
+/** Creates a continuous legend */
+export function legend(config?: any): any

package/build/types/legend/legend-discrete.d.ts

@@ -1,2 +1,2 @@
-/** Creates a discrete legend */
-export function legend(config?: any): any
+/** Creates a discrete legend */
+export function legend(config?: any): any

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

@@ -1,13 +1,13 @@
-import type { MapInstance } from '../core/MapInstance'
-
-/** Base legend configuration */
-export interface LegendConfig {
-  title?: string
-  titleFontSize?: number
-  labelFontSize?: number
-  labelDelimiter?: string
-  noDataText?: string
-}
-
-/** Creates a legend instance */
-export function legend(config?: LegendConfig): any
+import type { MapInstance } from '../core/MapInstance'
+
+/** Base legend configuration */
+export interface LegendConfig {
+  title?: string
+  titleFontSize?: number
+  labelFontSize?: number
+  labelDelimiter?: string
+  noDataText?: string
+}
+
+/** Creates a legend instance */
+export function legend(config?: LegendConfig): any

package/build/types/legend/proportional-symbol/legend-proportional-symbols.d.ts

@@ -1,2 +1,2 @@
-/** Creates a proportional symbols legend */
-export function legend(config?: any): any
+/** Creates a proportional symbols legend */
+export function legend(config?: any): any

package/build/types/map-types/CategoricalMapConfig.d.ts

@@ -1,11 +1,11 @@
-import type { MapConfig } from '../core/MapConfig'
-
-/**
- * Configuration for categorical map
- */
-export interface CategoricalMapConfig extends MapConfig {
-    /** Category-to-color mapping */
-    classToFillStyle?: Record<string, string>
-    /** Fill style for regions with no data */
-    noDataFillStyle?: string
-}
+import type { MapConfig } from '../core/MapConfig'
+
+/**
+ * Configuration for categorical map
+ */
+export interface CategoricalMapConfig extends MapConfig {
+    /** Category-to-color mapping */
+    classToFillStyle?: Record<string, string>
+    /** Fill style for regions with no data */
+    noDataFillStyle?: string
+}

package/build/types/map-types/choropleth/map-choropleth-bivariate.d.ts

@@ -1,4 +1,4 @@
-import type { MapInstance } from '../../core/MapInstance'
-
-/** Creates a bivariate choropleth map instance */
-export function map(config?: any): MapInstance
+import type { MapInstance } from '../../core/MapInstance'
+
+/** Creates a bivariate choropleth map instance */
+export function map(config?: any): MapInstance

package/build/types/map-types/choropleth/map-choropleth-trivariate.d.ts

@@ -1,4 +1,4 @@
-import type { MapInstance } from '../../core/MapInstance'
-
-/** Creates a trivariate choropleth map instance */
-export function map(config?: any): MapInstance
+import type { MapInstance } from '../../core/MapInstance'
+
+/** Creates a trivariate choropleth map instance */
+export function map(config?: any): MapInstance

package/build/types/map-types/choropleth/map-value-by-alpha.d.ts

@@ -1,4 +1,4 @@
-import type { MapInstance } from '../../core/MapInstance'
-
-/** Creates a value-by-alpha map instance */
-export function map(config?: any): MapInstance
+import type { MapInstance } from '../../core/MapInstance'
+
+/** Creates a value-by-alpha map instance */
+export function map(config?: any): MapInstance