eurostat-map 4.4.5 → 4.5.0

package/build/package.json

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

@@ -12,6 +12,14 @@ export interface GridCartogramMargins {
     left: number
 }
 
+/** Shared chart offset for symbols drawn inside each grid cell. */
+export interface GridCartogramChartOffset {
+    /** Horizontal offset in pixels. Positive moves right. */
+    x: number
+    /** Vertical offset in pixels. Positive moves down. */
+    y: number
+}
+
 /**
  * Settings for grid cartogram layout and geometry.
  */
@@ -22,6 +30,31 @@ export interface GridCartogramSettings {
     margins: GridCartogramMargins
     /** Extra spacing between grid cells in pixels. */
     cellPadding: number
+    /** Country-label rendering settings for grid cartograms. */
+    countryLabelSettings?: {
+        /** Show country labels as codes, names, or a custom string. */
+        countryLabels?: 'code' | 'name' | ((id: string, name: string | undefined, region?: any) => string)
+        /** Base font size for country labels in grid cartograms. */
+        countryLabelFontSize?: number
+        /** Minimum font size allowed when shrinking labels to avoid overlap. */
+        countryLabelMinFontSize?: number
+        /** Extra padding subtracted from the available label width before fitting. */
+        countryLabelPadding?: { x: number; y: number }
+        /** Disable automatic label shrinking/stretching to avoid overlap. @default false */
+        countryLabelAvoidOverlap?: boolean
+    }
+    /** @deprecated Use countryLabelSettings.countryLabels instead. */
+    countryLabels?: 'code' | 'name' | ((id: string, name: string | undefined, region?: any) => string)
+    /** @deprecated Use countryLabelSettings.countryLabelFontSize instead. */
+    countryLabelFontSize?: number
+    /** @deprecated Use countryLabelSettings.countryLabelMinFontSize instead. */
+    countryLabelMinFontSize?: number
+    /** @deprecated Use countryLabelSettings.countryLabelPadding instead. */
+    countryLabelPadding?: { x: number; y: number }
+    /** @deprecated Use countryLabelSettings.countryLabelAvoidOverlap instead. */
+    countryLabelAvoidOverlap?: boolean
+    /** Shared chart offset in grid cells for chart-based map types. */
+    chartOffset: GridCartogramChartOffset
     /**
      * Custom grid layout CSV string.
      * If undefined, the built-in layout for the selected shape is used.

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

@@ -1,4 +1,5 @@
 import type { StatConfig } from './stat/StatConfig'
+import type { CompositionStatConfig } from '../layers/composition/CompositionStatConfig'
 import type { LegendConfig } from '../legend/LegendConfig'
 import type { TooltipConfig } from './TooltipConfig'
 import type { InsetConfig } from './InsetConfig'
@@ -7,6 +8,7 @@ import type { CoastalMarginSettings } from './decoration/CoastalMarginSettings'
 import type { GridCartogramSettings } from './GridCartogramSettings'
 import type { DorlingSettings } from './DorlingSettings'
 import type { ScalebarConfig } from './decoration/ScalebarConfig'
+import type { EncodingConfig } from './encoding/EncodingConfig'
 
 /**
  * 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.
@@ -56,8 +58,17 @@ export interface MapConfig {
     /** Data source text. */
     source?: string
 
-    /** Statistical data configuration. */
-    stat?: StatConfig
+    /**
+     * Statistical data configuration.
+     *
+     * Preferred for multi-dataset maps:
+     *  - set named datasets via `stat` dictionary
+     *  - bind channels via `encoding`
+     */
+    stat?: StatConfig | CompositionStatConfig | Record<string, StatConfig | CompositionStatConfig>
+
+    /** Optional visual encoding configuration by channel (size, color, fill, composition, etc.). */
+    encoding?: Record<string, EncodingConfig>
 
     /** Legend configuration. */
     legend?: LegendConfig | false

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

@@ -1,5 +1,8 @@
 import type { StatConfig } from './stat/StatConfig'
 import type { StatData } from './stat/StatData'
+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 { TooltipConfig } from './TooltipConfig'
 import type { InsetConfig } from './InsetConfig'
@@ -7,6 +10,8 @@ import type { CoastalMarginSettings } from './decoration/CoastalMarginSettings'
 import type { GridCartogramSettings } from './GridCartogramSettings'
 import type { DorlingSettings } from './DorlingSettings'
 import type { ScalebarConfig } from './decoration/ScalebarConfig'
+import type { EncodingConfig } from './encoding/EncodingConfig'
+import type { LocationConfig } from './locations'
 
 /**
  * A eurostat-map instance. Created by eurostatmap.map() and extended
@@ -117,10 +122,50 @@ export interface MapInstance {
      * - `map.stat('v1', config)` → sets the stat config for key 'v1'
      * @example map.stat({ eurostatDatasetCode: 'demo_r_d3dens', filters: { TIME: '2024' } })
      */
-    stat(): StatConfig
-    stat(config: StatConfig): this
-    stat(key: string): StatConfig
-    stat(key: string, config: StatConfig): this
+    stat(): StatConfig | CompositionStatConfig | undefined
+    stat(config: StatConfig | CompositionStatConfig): this
+    stat(key: string): StatConfig | CompositionStatConfig | undefined
+    stat(key: string, config: StatConfig | CompositionStatConfig): this
+    /**
+     * Legacy compatibility overload for composition channels.
+     * Preferred: pass category fields directly inside config.
+     */
+    stat(
+        key: string,
+        config: StatConfig | CompositionStatConfig,
+        categoryParameter: string,
+        categoryCodes?: string[],
+        categoryLabels?: string[],
+        categoryColors?: string[],
+        totalCode?: string
+    ): this
+
+    /**
+     * Get or set visual encodings that map named stats to visual variables.
+     * @example map.encoding('size', { stat: 'population', scale: 'sqrt', range: [4, 30] })
+     */
+    encoding(): Record<string, EncodingConfig>
+    encoding(channel: string): EncodingConfig | undefined
+    encoding(channel: string, config: EncodingConfig): this
+    encoding(configs: Record<string, EncodingConfig>): this
+
+    /** Returns the stat name for an encoding channel, or fallback when unset. */
+    getEncodingStat(channel: string, fallback?: string): string | undefined
+
+    /** Returns stat names for an encoding channel (`stats` or single `stat`). */
+    getEncodingStats(channel: string, fallback?: string[]): string[] | undefined
+
+    /** Returns the concrete statData key for a channel/category combination. */
+    getEncodingStatKey(channel: string, categoryCode?: string, fallbackStat?: string): string | undefined
+
+    /** Returns the StatData source bound to a channel/category. */
+    getEncodingStatData(channel: string, categoryCode?: string, fallbackStat?: string): StatData | undefined
+
+    /** Returns a region value through encoding lookup. */
+    getEncodingValue(channel: string, regionId: string, categoryCode?: string, fallbackStat?: string): number | string | undefined
+
+    /** Returns unit text through encoding lookup. */
+    getEncodingUnitText(channel: string, categoryCode?: string, fallbackStat?: string): string
 
     /**
      * Get or set the StatData instance for a given key.
@@ -246,6 +291,22 @@ export interface MapInstance {
     svg(): any
     svg(s: any): this
 
+    /** Add or replace a custom point location marker. */
+    addLocation(config: LocationConfig): this
+
+    /** Remove a custom point location marker by id. */
+    removeLocation(id: string): this
+
+    /** Remove all custom point location markers. */
+    clearLocations(): this
+
+    /** Get or replace all custom point location markers. */
+    locations(): LocationConfig[]
+    locations(configs: LocationConfig[] | null | undefined): this
+
+    /** Redraw custom point location markers. */
+    updateLocations(): this
+
     /** Custom geometry filtering function. */
     filterGeometriesFunction(): ((geometry: any) => boolean) | undefined
     filterGeometriesFunction(fn: (geometry: any) => boolean): this
@@ -445,6 +506,21 @@ export interface MapInstance {
     /** Returns region centroids as an array of projected coordinate pairs. */
     regionCentroids(): Array<{ id: string; x: number; y: number }>
 
+    /** Ordered thematic layer stack (bottom → top). */
+    layers_: Layer[]
+    activeLayerIndex_: number
+
+    activeLayer(): Layer
+    layer(ref?: number | string): Layer | undefined
+    layers(): Layer[]
+    layers(configs: LayerConfig[]): this
+    addLayer(type: string, config?: LayerConfig): Layer
+    addLayer(config: LayerConfig): Layer
+    removeLayer(ref: number | string): this
+    activeLayerIndex(): number
+    activeLayerIndex(i: number): this
+    updateAllLayers(): this
+
     /** Allow additional map-type-specific properties and methods. */
     [key: string]: any
 }

package/build/types/core/encoding/EncodingConfig.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Configuration for mapping a named stat dataset to a visual channel.
+ */
+export interface EncodingConfig {
+    /** Name of a dataset registered with map.stat(name, config). */
+    stat?: string
+    /** Names of datasets for multi-stat encodings such as bivariate color. */
+    stats?: string[]
+    /** Whether the encoding is based on raw values or category codes. */
+    by?: 'value' | 'category'
+    /** Encoding type. */
+    type?: 'linear' | 'sqrt' | 'threshold' | 'quantile' | 'categorical' | 'bivariate' | 'trivariate'
+    /** Scale type. */
+    scale?: 'linear' | 'sqrt' | 'quantile' | 'threshold'
+    /** Numeric or color output range. */
+    range?: [number, number] | string[]
+    /** Explicit encoded values, for example category colors. */
+    values?: Record<string, string | number> | Array<string | number>
+    /** Labels keyed by category code or value. */
+    labels?: Record<string, string> | string[]
+    /** Category codes when using array-based values or labels. */
+    categoryCodes?: string[]
+    /** Number of classes for classified encodings. */
+    classes?: number
+    /** Threshold values for threshold encodings. */
+    thresholds?: number[]
+    /** Color scheme name or function. */
+    scheme?: string | Function
+    /** Optional unit override for this encoding. */
+    unitText?: string
+}

package/build/types/core/layer/Layer.d.ts

@@ -0,0 +1,31 @@
+import type { MapInstance } from '../MapInstance'
+import type { EncodingConfig } from '../encoding/EncodingConfig'
+import type { StatData } from '../stat/StatData'
+import type { LayerRole } from './LayerRole'
+
+export interface Layer {
+    map: MapInstance
+    isLayer: true
+    id: string
+    type: string
+    role: LayerRole
+
+    encodings_: Record<string, EncodingConfig>
+
+    encoding(): Record<string, EncodingConfig>
+    encoding(channel: string): EncodingConfig | undefined
+    encoding(channel: string, config: EncodingConfig): Layer
+    encoding(map: Record<string, EncodingConfig>): Layer
+
+    getEncodingStat(channel: string, fallback?: string): string | undefined
+    getEncodingStats(channel: string, fallback?: string[]): string[] | undefined
+    getEncodingStatKey(channel: string, categoryCode?: string, fallbackStat?: string): string
+    getEncodingStatData(channel: string, categoryCode?: string, fallbackStat?: string): StatData
+    getEncodingValue(channel: string, regionId: string, categoryCode?: string, fallbackStat?: string): number | string | undefined
+    getEncodingUnitText(channel: string, categoryCode?: string, fallbackStat?: string): string
+
+    updateClassification(): Layer
+    updateStyle(): Layer
+    getLegendConstructor(): (map: MapInstance, config?: any) => any
+    group(): any // d3 selection
+}

package/build/types/core/layer/LayerConfig.d.ts

@@ -0,0 +1,19 @@
+import type { MapType } from '../../layers/MapType'
+import type { EncodingConfig } from '../encoding/EncodingConfig'
+import type { LegendConfig } from '../../legend/LegendConfig'
+import type { LayerRole } from './LayerRole'
+
+export interface LayerConfig {
+    /** Stable id; auto-generated if omitted. */
+    id?: string
+    /** Layer type (same identifiers as map types). */
+    type: MapType
+    /** Explicit role; defaults from the type. */
+    role?: LayerRole
+    /** Keyed visual encodings: fill, size, color, stroke, … */
+    encoding?: Record<string, EncodingConfig>
+    /** Per-layer legend config. */
+    legend?: LegendConfig
+    /** Type-specific settings are also accepted. */
+    [key: string]: any
+}

package/build/types/core/layer/LayerRole.d.ts

@@ -0,0 +1 @@
+export type LayerRole = 'base' | 'overlay'

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

@@ -6,11 +6,37 @@ import type { MapInstance } from './MapInstance'
 export const LOCATION_SHAPES: {
     CIRCLE: 'circle'
     SQUARE: 'square'
+    PIN: 'pin'
     DIAMOND: 'diamond'
-    TRIANGLE: 'triangle'
     STAR: 'star'
     CROSS: 'cross'
-    PLUS: 'plus'
+}
+
+/**
+ * Available location marker shapes
+ */
+export type LocationShape = 'circle' | 'square' | 'pin' | 'diamond' | 'cross' | 'star'
+
+/**
+ * Text label style for a location marker
+ */
+export interface LocationLabelStyle {
+    /** CSS font size. @default '12px' */
+    fontSize?: string
+    /** CSS font family. @default 'inherit' */
+    fontFamily?: string
+    /** CSS font weight. @default 'normal' */
+    fontWeight?: string | number
+    /** Text fill color. @default '#222' */
+    fill?: string
+    /** Text opacity. @default 1 */
+    opacity?: number
+    /** Label halo color. @default '#fff' */
+    haloColor?: string
+    /** Label halo width in pixels. @default 3 */
+    haloWidth?: number
+    /** SVG text-anchor value. @default 'start' */
+    textAnchor?: 'start' | 'middle' | 'end'
 }
 
 /**
@@ -19,26 +45,28 @@ export const LOCATION_SHAPES: {
 export interface LocationConfig {
     /** Unique identifier for the location */
     id?: string
-    /** Longitude coordinate */
-    lon: number
-    /** Latitude coordinate */
-    lat: number
+    /** Geographic X coordinate (longitude / easting) */
+    x: number
+    /** Geographic Y coordinate (latitude / northing) */
+    y: number
     /** Label text to display */
     label?: string
     /** Marker shape. @default 'circle' */
-    shape?: 'circle' | 'square' | 'diamond' | 'triangle' | 'star' | 'cross' | 'plus'
-    /** Marker size in pixels. @default 8 */
-    size?: number
-    /** Fill color. @default '#e74c3c' */
-    color?: string
+    shape?: LocationShape
+    /** Marker radius in pixels. @default 6 */
+    radius?: number
+    /** Fill color. @default '#e84040' */
+    fill?: string
+    /** Fill opacity. @default 1 */
+    opacity?: number
     /** Stroke color. @default '#fff' */
     stroke?: string
-    /** Stroke width in pixels. @default 1 */
+    /** Stroke width in pixels. @default 1.5 */
     strokeWidth?: number
-    /** Custom CSS class */
-    class?: string
-    /** Custom data attached to the location */
-    data?: any
+    /** Label offset from projected point in pixels. @default [7, -6] */
+    labelOffset?: [number, number]
+    /** Label text style overrides */
+    labelStyle?: LocationLabelStyle
 }
 
 /**

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

@@ -1,8 +1,13 @@
 /**
  * Configuration for a statistical data source.
  * Pass this to map.stat() or as the config argument to statData().
+ *
+ * Preferred for multi-channel maps: register named datasets with
+ * `map.stat('datasetName', config)` and map them with `map.encoding(...)`.
  */
 export interface StatConfig {
+    /** Custom data keyed by region ID. Use instead of a remote data source. */
+    customData?: Record<string, number | string | { value: number | string; status?: string }>
     /** Eurostat dataset code. e.g. 'demo_r_d3dens' */
     eurostatDatasetCode?: string
     /**
@@ -20,6 +25,8 @@ export interface StatConfig {
     valueCol?: string
     /** Unit of measure label shown in tooltips. e.g. 'people/km²' */
     unitText?: string
+    /** Optional preprocessing hook called with (regionId, value) before transform. Return null/undefined/false to filter out the region. */
+    preprocess?: (regionId: string, value: any) => any
     /** Optional transform function applied to raw values after data loads. e.g. v => v * 1000 */
     transform?: (value: number) => number
     /** Dataset label/name from the Eurostat API response. */

package/build/types/index.d.ts

@@ -5,51 +5,51 @@
 // ==================== Core Type Imports (needed for local use in function signatures) ====================
 
 import type { MapConfig } from './core/MapConfig'
-import type { MapType } from './map-types/MapType'
+import type { MapType } from './layers/MapType'
 import type { MapInstance } from './core/MapInstance'
 
 // Choropleth map types
-import type { ChoroplethConfig } from './map-types/choropleth/ChoroplethConfig'
-import type { ChoroplethMap } from './map-types/choropleth/ChoroplethMap'
-import type { ValueByAlphaConfig } from './map-types/choropleth/ValueByAlphaConfig'
-import type { ValueByAlphaMap } from './map-types/choropleth/ValueByAlphaMap'
-import type { BivariateChoroplethConfig } from './map-types/choropleth/BivariateChoroplethConfig'
-import type { BivariateChoroplethMap } from './map-types/choropleth/BivariateChoroplethMap'
-import type { TrivariateChoroplethConfig, TrivariateTernarySettings } from './map-types/choropleth/TrivariateChoroplethConfig'
-import type { TrivariateChoroplethMap } from './map-types/choropleth/TrivariateChoroplethMap'
+import type { ChoroplethConfig } from './layers/choropleth/ChoroplethConfig'
+import type { ChoroplethMap } from './layers/choropleth/ChoroplethMap'
+import type { ValueByAlphaConfig } from './layers/choropleth/ValueByAlphaConfig'
+import type { ValueByAlphaMap } from './layers/choropleth/ValueByAlphaMap'
+import type { BivariateChoroplethConfig } from './layers/choropleth/BivariateChoroplethConfig'
+import type { BivariateChoroplethMap } from './layers/choropleth/BivariateChoroplethMap'
+import type { TrivariateChoroplethConfig, TrivariateTernarySettings } from './layers/choropleth/TrivariateChoroplethConfig'
+import type { TrivariateChoroplethMap } from './layers/choropleth/TrivariateChoroplethMap'
 
 // Categorical map types
-import type { CategoricalMapConfig } from './map-types/CategoricalMapConfig'
-import type { CategoricalMap } from './map-types/CategoricalMap'
+import type { CategoricalMapConfig } from './layers/CategoricalMapConfig'
+import type { CategoricalMap } from './layers/CategoricalMap'
 
 // Proportional symbol map types
-import type { ProportionalSymbolConfig } from './map-types/proportional-symbol/ProportionalSymbolConfig'
-import type { ProportionalSymbolMap } from './map-types/proportional-symbol/ProportionalSymbolMap'
-import type { MushroomMapConfig } from './map-types/proportional-symbol/mushroom/MushroomMapConfig'
-import type { MushroomMap } from './map-types/proportional-symbol/mushroom/MushroomMap'
+import type { ProportionalSymbolConfig } from './layers/proportional-symbol/ProportionalSymbolConfig'
+import type { ProportionalSymbolMap } from './layers/proportional-symbol/ProportionalSymbolMap'
+import type { MushroomMapConfig } from './layers/proportional-symbol/mushroom/MushroomMapConfig'
+import type { MushroomMap } from './layers/proportional-symbol/mushroom/MushroomMap'
 
 // Composition map types
-import type { CompositionStatConfig } from './map-types/composition/CompositionStatConfig'
-import type { CoxcombMapConfig } from './map-types/composition/coxcomb/CoxcombMapConfig'
-import type { CoxcombMap } from './map-types/composition/coxcomb/CoxcombMap'
-import type { CoxcombStatConfig } from './map-types/composition/coxcomb/CoxcombStatConfig'
-import type { BarMapConfig } from './map-types/composition/bar/BarMapConfig'
-import type { BarMap } from './map-types/composition/bar/BarMap'
-import type { PieMapConfig } from './map-types/composition/pie/PieMapConfig'
-import type { PieMap } from './map-types/composition/pie/PieMap'
-import type { StripeMapConfig } from './map-types/composition/stripe/StripeMapConfig'
-import type { StripeMap } from './map-types/composition/stripe/StripeMap'
-import type { WaffleMapConfig } from './map-types/composition/waffle/WaffleMapConfig'
-import type { WaffleMap } from './map-types/composition/waffle/WaffleMap'
+import type { CompositionStatConfig } from './layers/composition/CompositionStatConfig'
+import type { CoxcombMapConfig } from './layers/composition/coxcomb/CoxcombMapConfig'
+import type { CoxcombMap } from './layers/composition/coxcomb/CoxcombMap'
+import type { CoxcombStatConfig } from './layers/composition/coxcomb/CoxcombStatConfig'
+import type { BarMapConfig } from './layers/composition/bar/BarMapConfig'
+import type { BarMap } from './layers/composition/bar/BarMap'
+import type { PieMapConfig } from './layers/composition/pie/PieMapConfig'
+import type { PieMap } from './layers/composition/pie/PieMap'
+import type { StripeMapConfig } from './layers/composition/stripe/StripeMapConfig'
+import type { StripeMap } from './layers/composition/stripe/StripeMap'
+import type { WaffleMapConfig } from './layers/composition/waffle/WaffleMapConfig'
+import type { WaffleMap } from './layers/composition/waffle/WaffleMap'
 
 // Spark map types
-import type { SparkMapConfig } from './map-types/spark/SparkMapConfig'
-import type { SparkMap } from './map-types/spark/SparkMap'
-import type { SparkStatConfig } from './map-types/spark/SparkStatConfig'
+import type { SparkMapConfig } from './layers/spark/SparkMapConfig'
+import type { SparkMap } from './layers/spark/SparkMap'
+import type { SparkStatConfig } from './layers/spark/SparkStatConfig'
 
 // Flow map types
-import type { FlowMapConfig } from './map-types/flow/FlowMapConfig'
-import type { FlowMap } from './map-types/flow/FlowMap'
+import type { FlowMapConfig } from './layers/flow/FlowMapConfig'
+import type { FlowMap } from './layers/flow/FlowMap'
 
 // ==================== Core Type Exports ====================
 
@@ -58,6 +58,7 @@ export type EurostatMap = MapInstance
 export type { TooltipConfig } from './core/TooltipConfig'
 export type { LegendConfig } from './legend/LegendConfig'
 export type { StatConfig } from './core/stat/StatConfig'
+export type { EncodingConfig } from './core/encoding/EncodingConfig'
 export type { StatData } from './core/stat/StatData'
 export type { InsetConfig } from './core/InsetConfig'
 export type { CoastalMarginSettings } from './core/decoration/CoastalMarginSettings'
@@ -68,6 +69,9 @@ export type { DorlingSettings, DorlingStrength } from './core/DorlingSettings'
 export type { MinimapConfig } from './core/minimaps'
 export type { LocationConfig } from './core/locations'
 export type { GeometriesClass } from './core/geo/geometries'
+export type { Layer } from './core/layer/Layer'
+export type { LayerConfig } from './core/layer/LayerConfig'
+export type { LayerRole } from './core/layer/LayerRole'
 
 // ==================== Legend Configuration Type Exports ====================
 
@@ -160,7 +164,7 @@ export type {
     FlowCurvatureSettings,
     FlowWidthGradientSettings,
     FlowBundleSettings,
-} from './map-types/flow/FlowMapConfig'
+} from './layers/flow/FlowMapConfig'
 
 // ==================== Pattern Fill Options ====================
 
@@ -202,6 +206,7 @@ export interface FillPatternOptions {
  * map.build();
  * ```
  */
+export function map(): MapInstance
 export function map(type: 'choropleth' | 'ch', config?: ChoroplethConfig): ChoroplethMap
 export function map(type: 'proportionalSymbol' | 'proportionalSymbols' | 'ps', config?: ProportionalSymbolConfig): ProportionalSymbolMap
 export function map(type: 'categorical' | 'ct', config?: CategoricalMapConfig): CategoricalMap

package/build/types/layers/CategoricalMap.d.ts

@@ -0,0 +1,21 @@
+import type { MapInstance } from '../core/MapInstance'
+
+/**
+ * Categorical map type.
+ */
+export interface CategoricalMap extends MapInstance {
+    classToFillStyle(): any
+    classToFillStyle(v: any): this
+
+    classToText(): any
+    classToText(v: any): this
+
+    noDataFillStyle(): string
+    noDataFillStyle(v: string): this
+
+    tooltipText(): any
+    tooltipText(v: any): this
+
+    classifier(): any
+    classifier(v: any): this
+}

package/build/types/layers/CategoricalMapConfig.d.ts

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

package/build/types/layers/MapType.d.ts

@@ -0,0 +1,34 @@
+/**
+ * All supported map types
+ */
+export type MapType =
+    | 'choropleth'
+    | 'ch'
+    | 'proportionalSymbol'
+    | 'proportionalSymbols'
+    | 'ps'
+    | 'categorical'
+    | 'ct'
+    | 'bivariateChoropleth'
+    | 'chbi'
+    | 'trivariateChoropleth'
+    | 'ternary'
+    | 'chtri'
+    | 'stripeComposition'
+    | 'scomp'
+    | 'stripe'
+    | 'pieChart'
+    | 'pie'
+    | 'sparkline'
+    | 'spark'
+    | 'sparklines'
+    | 'flow'
+    | 'flowmap'
+    | 'coxcomb'
+    | 'polar'
+    | 'alpha'
+    | 'valueByAlpha'
+    | 'mushroom'
+    | 'waffle'
+    | 'bar'
+    | 'barComposition'

package/build/types/layers/choropleth/BivariateChoroplethConfig.d.ts

@@ -0,0 +1,27 @@
+import type { MapConfig } from '../../core/MapConfig'
+import type { BivariateLegendConfig } from '../../legend/choropleth/BivariateLegendConfig'
+
+/**
+ * Configuration for bivariate choropleth maps.
+ */
+export interface BivariateChoroplethConfig extends MapConfig {
+    /** Bivariate choropleth legend configuration. */
+    legend?: BivariateLegendConfig | false
+
+    /** Number of classes. */
+    numberOfClasses?: number
+    /** Breaks1. */
+    breaks1?: number[]
+    /** Breaks2. */
+    breaks2?: number[]
+    /** Start color. */
+    startColor?: string
+    /** Color1. */
+    color1?: string
+    /** Color2. */
+    color2?: string
+    /** End color. */
+    endColor?: string
+    /** No data fill style. */
+    noDataFillStyle?: string
+}

package/build/types/layers/choropleth/BivariateChoroplethMap.d.ts

@@ -0,0 +1,39 @@
+import type { MapInstance } from '../../core/MapInstance'
+
+/**
+ * Bivariate choropleth map type.
+ */
+export interface BivariateChoroplethMap extends MapInstance {
+    numberOfClasses(): number
+    numberOfClasses(v: number): this
+
+    breaks1(): number[] | undefined
+    breaks1(v: number[] | undefined): this
+
+    breaks2(): number[] | undefined
+    breaks2(v: number[] | undefined): this
+
+    startColor(): string
+    startColor(v: string): this
+
+    color1(): string
+    color1(v: string): this
+
+    color2(): string
+    color2(v: string): this
+
+    endColor(): string
+    endColor(v: string): this
+
+    classToFillStyle(): any
+    classToFillStyle(v: any): this
+
+    noDataFillStyle(): string
+    noDataFillStyle(v: string): this
+
+    classifier1(): any
+    classifier1(v: any): this
+
+    classifier2(): any
+    classifier2(v: any): this
+}