eurostat-map 4.8.5 → 4.9.0

package/build/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eurostat-map",
-  "version": "4.8.5",
+  "version": "4.9.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/MapConfig.d.ts

@@ -1,6 +1,7 @@
 import type { StatConfig } from './stat/StatConfig'
 import type { CompositionStatConfig } from '../layers/composition/CompositionStatConfig'
 import type { LegendConfig } from '../legend/LegendConfig'
+import type { RankedBarChartConfig } from '../legend/choropleth/RankedBarChartConfig'
 import type { TooltipConfig } from './TooltipConfig'
 import type { InsetConfig } from './InsetConfig'
 import type { MapInstance as EurostatMap } from './MapInstance'
@@ -73,6 +74,13 @@ export interface MapConfig {
     /** Legend configuration. */
     legend?: LegendConfig | false
 
+    /**
+     * Ranked bar chart configuration (choropleth-classified map types only). Independent of the
+     * legend - has its own positioning and can render into an entirely different container/SVG
+     * to the legend's, rather than being a sub-feature of it.
+     */
+    rankedBarChart?: RankedBarChartConfig | false
+
     /** Tooltip configuration. */
     tooltip?: TooltipConfig
 

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

@@ -4,6 +4,7 @@ import type { Layer } from './layer/Layer'
 import type { LayerConfig } from './layer/LayerConfig'
 import type { CompositionStatConfig } from '../layers/composition/CompositionStatConfig'
 import type { LegendConfig } from '../legend/LegendConfig'
+import type { RankedBarChartConfig } from '../legend/choropleth/RankedBarChartConfig'
 import type { TooltipConfig } from './TooltipConfig'
 import type { InsetConfig } from './InsetConfig'
 import type { CoastalMarginSettings } from './decoration/CoastalMarginSettings'
@@ -204,6 +205,20 @@ export interface MapInstance {
     /** Force-update the legend after data or style changes. */
     updateLegend(): this
 
+    /** Ranked bar chart. */
+
+    /**
+     * Get or set ranked bar chart configuration (choropleth-classified map types only). Pass
+     * false to remove it. Independent of the legend - has its own positioning and can render
+     * into an entirely different container/SVG to the legend's.
+     * @example map.rankedBarChart({ svgId: 'my-bar-chart-container' })
+     */
+    rankedBarChart(): RankedBarChartConfig | false
+    rankedBarChart(config: RankedBarChartConfig | false): this
+
+    /** Force-update the ranked bar chart after data or style changes. */
+    updateRankedBarChart(): this
+
     /** Tooltip. */
 
     /** Get or set tooltip configuration. */

package/build/types/index.d.ts

@@ -87,6 +87,7 @@ export type { ChoroplethLegendConfig } from './legend/choropleth/ChoroplethLegen
 export type { BivariateLegendConfig } from './legend/choropleth/BivariateLegendConfig'
 export type { HistogramLegendConfig } from './legend/choropleth/HistogramLegendConfig'
 export type { TrivariateLegendConfig } from './legend/choropleth/TrivariateLegendConfig'
+export type { RankedBarChartConfig } from './legend/choropleth/RankedBarChartConfig'
 
 // Composition legend types
 export type { BarChartLegendConfig } from './legend/composition/BarChartLegendConfig'

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

@@ -25,7 +25,7 @@ export interface LegendConfig {
     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). The legend box is transparent at the initial view and returns to its configured opacity while zoomed. */
+    /** 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

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

@@ -0,0 +1,22 @@
+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'
+}

package/package.json

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