eurostat-map 4.3.58 → 4.4.1

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

@@ -0,0 +1,74 @@
+import { LegendConfig } from '../LegendConfig'
+
+/**
+ * Configuration for size legend in waffle chart maps.
+ */
+export interface WaffleSizeLegendConfig {
+    /** Title for the size legend. */
+    title?: string | null
+
+    /** Padding between title and legend content in pixels. @default 10 */
+    titlePadding?: number
+
+    /** Custom values to display in the size legend. If not specified, values are auto-generated. */
+    values?: number[] | null
+
+    /** Custom formatter function for legend labels. */
+    labelFormatter?: ((value: number) => string) | undefined
+
+    /** Simplified grid size for size legend examples (e.g., 5 means 5x5 = 25 cells). @default 5 */
+    gridSize?: number
+
+    /** Padding between cells in size legend in pixels. @default 0.5 */
+    cellPadding?: number
+
+    /** Whether to show a "no data" item. @default false */
+    noData?: boolean
+
+    /** Text label for "no data" item. @default 'No data' */
+    noDataText?: string
+}
+
+/**
+ * Configuration for color legend in waffle chart maps.
+ */
+export interface WaffleColorLegendConfig {
+    /** Title for the color legend. */
+    title?: string | null
+
+    /** Padding between title and legend content in pixels. @default 10 */
+    titlePadding?: number
+
+    /** Top margin (distance from size legend) in pixels. @default 33 */
+    marginTop?: number
+
+    /** Offset adjustments for labels. @default { x: 5, y: 5 } */
+    labelOffsets?: { x: number; y: number }
+
+    /** Width of color swatches in pixels. @default 25 */
+    shapeWidth?: number
+
+    /** Height of color swatches in pixels. @default 20 */
+    shapeHeight?: number
+
+    /** Padding between swatches in pixels. @default 1 */
+    shapePadding?: number
+
+    /** Whether to show a "no data" item. @default true */
+    noData?: boolean
+
+    /** Text label for "no data" item. @default 'No data' */
+    noDataText?: string
+}
+
+/**
+ * Configuration for waffle chart map legends.
+ * Waffle charts display data as grids of small squares, with colors representing categories.
+ */
+export interface WaffleLegendConfig extends LegendConfig {
+    /** Configuration for the waffle size legend. */
+    sizeLegend?: Partial<WaffleSizeLegendConfig>
+
+    /** Configuration for the color/category legend. Set to false to hide. */
+    colorLegend?: Partial<WaffleColorLegendConfig> | false
+}

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

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

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

@@ -0,0 +1,117 @@
+import { LegendConfig } from '../LegendConfig'
+
+/**
+ * Configuration for flow width legend in flow maps.
+ */
+export interface FlowWidthLegendConfig {
+    /** Title for the flow width legend. */
+    title?: string | null
+
+    /** Padding between title and legend content in pixels. @default 20 */
+    titlePadding?: number
+
+    /** Custom values to display in the flow width legend. If null, values are auto-generated. */
+    values?: number[] | null
+
+    /** Top margin for the flow width legend in pixels. @default 15 */
+    marginTop?: number
+
+    /** Custom formatter function for legend labels. */
+    labelFormatter?: ((value: number) => string) | undefined
+
+    /** Manual override for legend labels. */
+    labels?: string[] | null
+
+    /** Color of the flow lines in the legend. @default '#616161' */
+    color?: string
+
+    /** Orientation of the flow width legend. @default 'horizontal' */
+    orientation?: 'horizontal' | 'vertical'
+
+    /** Number of segments to display. @default 3 */
+    segments?: number
+
+    /** Width of the legend in pixels. @default 150 */
+    width?: number
+
+    /** Whether to show max/min labels. @default false */
+    maxMin?: boolean
+}
+
+/**
+ * Configuration for node size legend in flow maps.
+ */
+export interface NodeSizeLegendConfig {
+    /** Title for the node size legend. */
+    title?: string | null
+
+    /** Padding between title and legend content in pixels. @default 25 */
+    titlePadding?: number
+
+    /** Custom values to display in the node size legend. If null, values are auto-generated. */
+    values?: number[] | null
+
+    /** Manual override for legend labels. */
+    labels?: string[] | null
+
+    /** Top margin for the node size legend in pixels. @default 20 */
+    marginTop?: number
+
+    /** Custom formatter function for legend labels. */
+    labelFormatter?: ((value: number) => string) | undefined
+}
+
+/**
+ * Configuration for flow color legend in flow maps.
+ */
+export interface FlowColorLegendConfig {
+    /** Title for the flow color legend. */
+    title?: string | null
+
+    /** Padding between title and legend content in pixels. @default 0 */
+    titlePadding?: number
+
+    /** Top margin for the flow color legend in pixels. @default 50 */
+    marginTop?: number
+
+    /** User-defined legend items for custom flow color function. */
+    items?: Array<{ label: string; color: string }>
+
+    /** Whether to use labels as ticks. @default false */
+    ticks?: boolean
+}
+
+/**
+ * Configuration for region color legend in flow maps.
+ */
+export interface RegionColorLegendConfig {
+    /** Title for the region color legend. */
+    title?: string | null
+
+    /** Padding between title and legend content in pixels. @default 15 */
+    titlePadding?: number
+
+    /** Top margin for the region color legend in pixels. @default 40 */
+    marginTop?: number
+
+    /** Labels for the region types. @default ['Exporter', 'Importer'] */
+    labels?: string[]
+}
+
+/**
+ * Configuration for flow map legends.
+ * Flow maps can display multiple legend types: flow width, node size, flow color, and region color.
+ */
+export interface FlowMapLegendConfig extends LegendConfig {
+    /** Configuration for the flow width legend. */
+    flowWidthLegend?: Partial<FlowWidthLegendConfig>
+
+    /** Configuration for the node size legend. */
+    nodeSizeLegend?: Partial<NodeSizeLegendConfig>
+
+    /** Configuration for the flow color legend. */
+    flowColorLegend?: Partial<FlowColorLegendConfig>
+
+    /** Configuration for the region color legend. */
+    regionColorLegend?: Partial<RegionColorLegendConfig>
+}

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

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,134 @@
+import { LegendConfig } from '../LegendConfig'
+
+/**
+ * Configuration for size legend in proportional symbol maps.
+ */
+export interface ProportionalSymbolSizeLegendConfig {
+    /** Title for the size legend. */
+    title?: string | null
+
+    /** Padding between title and legend content in pixels. @default 15 */
+    titlePadding?: number
+
+    /** Manually defined raw data values for the size legend. */
+    values?: number[]
+
+    /** Number of elements to display in the legend. @default 3 */
+    cellNb?: number
+
+    /** Vertical distance between consecutive legend shape elements in pixels. @default 15 */
+    shapePadding?: number
+
+    /** Offset adjustments for shapes. @default { x: 0, y: 0 } */
+    shapeOffsets?: { x: number; y: number }
+
+    /** Fill color for shapes in the legend. @default 'white' */
+    shapeFill?: string
+
+    /** Stroke color for shapes in the legend. */
+    shapeStroke?: string | null
+
+    /** Stroke width for shapes in the legend in pixels. */
+    shapeStrokeWidth?: number | null
+
+    /** Offset adjustments for labels. @default { x: 10, y: 0 } */
+    labelOffsets?: { x: number; y: number }
+
+    /** Number of decimal places for legend labels. @default 0 */
+    decimals?: number
+
+    /** Custom formatter function for legend labels. */
+    labelFormatter?: ((value: number) => string) | undefined
+
+    /** User-defined labels for each size. */
+    labels?: string[] | null
+
+    /** Whether to show a "no data" item. @default false */
+    noData?: boolean
+
+    /** Text label for "no data" item. @default 'No data' */
+    noDataText?: string
+}
+
+/**
+ * Configuration for color legend in proportional symbol maps.
+ */
+export interface ProportionalSymbolColorLegendConfig {
+    /** Title for the color legend. */
+    title?: string | null
+
+    /** Padding between title and legend content in pixels. @default 10 */
+    titlePadding?: number
+
+    /** Top margin (distance from size legend) in pixels. @default 30 */
+    marginTop?: number
+
+    /** Width of color swatches in pixels. @default 25 */
+    shapeWidth?: number
+
+    /** Height of color swatches in pixels. @default 20 */
+    shapeHeight?: number
+
+    /** Padding between swatches in pixels. @default 1 */
+    shapePadding?: number
+
+    /** Offset adjustments for labels. @default { x: 5, y: 0 } */
+    labelOffsets?: { x: number; y: number }
+
+    /** Number of decimal places for legend labels. @default 0 */
+    decimals?: number
+
+    /** Custom formatter function for legend labels. */
+    labelFormatter?: ((value: number) => string) | undefined
+
+    /** Type of labels to show. @default 'thresholds' */
+    labelType?: 'thresholds' | 'ranges'
+
+    /** User-defined labels for each class. */
+    labels?: string[] | null
+
+    /** Whether to show a "no data" item. @default true */
+    noData?: boolean
+
+    /** Text label for "no data" item. @default 'No data' */
+    noDataText?: string
+
+    /** Length of separation line in pixels. @default 24 */
+    sepLineLength?: number
+
+    /** Color of separation line. @default 'black' */
+    sepLineStroke?: string
+
+    /** Width of separation line in pixels. @default 1 */
+    sepLineStrokeWidth?: number
+
+    /** Length of threshold ticks in pixels. @default 5 */
+    tickLength?: number
+
+    /** Label for the point of divergence in diverging legends. */
+    pointOfDivergenceLabel?: string
+
+    /** Value at the point of divergence in diverging legends. */
+    pointOfDivergence?: number
+
+    /** Padding around divergence point in pixels. @default 7 */
+    pointOfDivergencePadding?: number
+
+    /** Length of diverging line in pixels. */
+    divergingLineLength?: number
+
+    /** Length of diverging arrows in pixels. */
+    divergingArrowLength?: number
+}
+
+/**
+ * Configuration for proportional symbol map legends.
+ * Shows both symbol size and color classifications.
+ */
+export interface ProportionalSymbolsLegendConfig extends LegendConfig {
+    /** Configuration for the symbol size legend. */
+    sizeLegend?: Partial<ProportionalSymbolSizeLegendConfig>
+
+    /** Configuration for the color classification legend. Set to false to hide. */
+    colorLegend?: Partial<ProportionalSymbolColorLegendConfig> | false
+}

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

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

package/build/types/map-types/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/map-types/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/map-types/CateogricalMapConfig.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/map-types/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/map-types/choropleth/BivariateChoroplethConfig.d.ts

@@ -0,0 +1,23 @@
+import type { MapConfig } from '../../core/MapConfig'
+
+/**
+ * Configuration for bivariate choropleth maps.
+ */
+export interface BivariateChoroplethConfig extends MapConfig {
+    /** 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/map-types/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
+}

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

@@ -0,0 +1,35 @@
+import { MapConfig } from '../../core/MapConfig'
+
+/**
+ * Configuration specific to choropleth maps
+ */
+export interface ChoroplethConfig extends MapConfig {
+    /** Classification. */
+    numberOfClasses?: number
+    /** Classification method. */
+    classificationMethod?: 'quantile' | 'ckmeans' | 'jenks' | 'equinter' | 'threshold'
+    /** Thresholds. */
+    thresholds?: number[]
+    /** Make classif nice. */
+    makeClassifNice?: boolean
+
+    /** Colors. */
+    colors?: string[]
+    colorFunction?: (t: number) => string
+    /** Color scheme type. */
+    colorSchemeType?: 'discrete' | 'continuous'
+    /** Class to fill style. */
+    classToFillStyle?: { [classIndex: number]: string }
+
+    /** No-data styling. */
+    noDataFillStyle?: string
+
+    /** Value transformation (for continuous schemes). */
+    valueTransform?: (x: number) => number
+    valueUntransform?: (x: number) => number
+    /** Skip normalization. */
+    skipNormalization?: boolean
+
+    /** Diverging schemes. */
+    pointOfDivergence?: number
+}

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

@@ -0,0 +1,48 @@
+import { MapInstance } from '../../core/MapInstance'
+
+/**
+ * Choropleth map object
+ */
+export interface ChoroplethMap extends MapInstance {
+    numberOfClasses(): number
+    numberOfClasses(n: number): this
+
+    classificationMethod(): string
+    classificationMethod(method: 'quantile' | 'ckmeans' | 'jenks' | 'equinter' | 'threshold'): this
+
+    thresholds(): number[]
+    thresholds(t: number[]): this
+
+    colors(): string[]
+    colors(c: string[]): this
+
+    colorFunction(): (t: number) => string
+    colorFunction(fn: (t: number) => string): this
+
+    makeClassifNice(): boolean
+    makeClassifNice(v: boolean): this
+
+    classToFillStyle(): any
+    classToFillStyle(v: any): this
+
+    classifier(): any
+    classifier(v: any): this
+
+    colorSchemeType(): string
+    colorSchemeType(type: 'discrete' | 'continuous'): this
+
+    valueTransform(): (x: number) => number
+    valueTransform(v: (x: number) => number): this
+
+    valueUntransform(): (x: number) => number
+    valueUntransform(v: (x: number) => number): this
+
+    pointOfDivergence(): number | null
+    pointOfDivergence(v: number | null): this
+
+    skipNormalization(): boolean
+    skipNormalization(v: boolean): this
+
+    noDataFillStyle(): string
+    noDataFillStyle(style: string): this
+}

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

@@ -0,0 +1,28 @@
+import type { MapConfig } from '../../core/MapConfig'
+
+/**
+ * Configuration for trivariate choropleth maps.
+ */
+export interface TrivariateChoroplethConfig extends MapConfig {
+    /** Ternary codes. */
+    ternaryCodes?: [string, string, string]
+    /** No data fill style. */
+    noDataFillStyle?: string
+    /** Ternary settings. */
+    ternarySettings?: {
+        /** Hue. */
+        hue?: number
+        /** Chroma. */
+        chroma?: number
+        /** Lightness. */
+        lightness?: number
+        /** Contrast. */
+        contrast?: number
+        /** Spread. */
+        spread?: number
+        /** Breaks. */
+        breaks?: number
+        /** Mean centering. */
+        meanCentering?: boolean
+    }
+}

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

@@ -0,0 +1,15 @@
+import type { MapInstance } from '../../core/MapInstance'
+
+/**
+ * Trivariate choropleth map type.
+ */
+export interface TrivariateChoroplethMap extends MapInstance {
+    ternaryCodes(): string[]
+    ternaryCodes(v: string[]): this
+
+    noDataFillStyle(): string
+    noDataFillStyle(v: string): this
+
+    ternarySettings(): any
+    ternarySettings(v: any): this
+}

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

@@ -0,0 +1,8 @@
+import type { ChoroplethConfig } from './ChoroplethConfig'
+
+/**
+ * Configuration for value-by-alpha choropleth maps.
+ */
+export interface ValueByAlphaConfig extends ChoroplethConfig {
+    opacityScale?: (value: number) => number
+}

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

@@ -0,0 +1,9 @@
+import type { MapInstance } from '../../core/MapInstance'
+
+/**
+ * Value-by-alpha choropleth map type.
+ */
+export interface ValueByAlphaMap extends MapInstance {
+    opacityScale(): ((value: number) => number) | null
+    opacityScale(v: ((value: number) => number) | null): this
+}

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

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

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