eurostat-map 4.3.57 → 4.4.0

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,18 @@
+import type { MapConfig } from '../../core/MapConfig'
+
+/**
+ * Configuration for trivariate choropleth maps.
+ */
+export interface TrivariateChoroplethConfig extends MapConfig {
+    ternaryCodes?: [string, string, string]
+    noDataFillStyle?: string
+    ternarySettings?: {
+        hue?: number
+        chroma?: number
+        lightness?: number
+        contrast?: number
+        spread?: number
+        breaks?: number
+        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

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

@@ -0,0 +1,47 @@
+import type { MapInstance } from '../../core/MapInstance'
+
+/**
+ * Configuration for choropleth map
+ */
+export interface ChoroplethMapConfig {
+    /** Number of classes for classification. @default 7 */
+    numberOfClasses?: number
+    /** Classification method: 'quantile', 'ckmeans', 'jenks', 'equinter', 'threshold'. @default 'quantile' */
+    classificationMethod?: 'quantile' | 'ckmeans' | 'jenks' | 'equinter' | 'threshold'
+    /** Threshold values when classificationMethod is 'threshold'. @default [0] */
+    thresholds?: number[]
+    /** Array of colors for classes */
+    colors?: string[]
+    /** Ensure nice rounded threshold values. @default true */
+    makeClassifNice?: boolean
+    /** Color function mapping [0,1] to color */
+    colorFunction?: (t: number) => string
+    /** Function returning color from class index */
+    classToFillStyle?: (i: number) => string
+    /** Classifier function returning class number from stat value */
+    classifier?: (value: number) => number
+    /** Fill style for regions with no data. @default '#bcbcbc' */
+    noDataFillStyle?: string
+}
+
+/**
+ * Creates a choropleth map instance.
+ * @param config - Map configuration
+ * @returns Map instance with choropleth-specific methods
+ */
+export function map(config?: ChoroplethMapConfig): MapInstance
+
+/**
+ * Gets a color function from interpolator and color array.
+ * @param colorFunction - D3 color interpolator function
+ * @param colorArray - Array of colors to interpolate
+ * @param schemeType - 'discrete' or 'continuous'. @default 'discrete'
+ * @returns Color function
+ */
+export function getColorFunction(colorFunction: any, colorArray: string[], schemeType?: 'discrete' | 'continuous'): (t: number) => string
+
+/**
+ * Gets a fill pattern legend function.
+ * @returns Function that returns pattern for a region
+ */
+export function getFillPatternLegend(): (ecl: string) => any

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

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

package/build/types/map-types/composition/BarMap.d.ts

@@ -0,0 +1,86 @@
+import type { MapInstance } from '../../core/MapInstance'
+import type { CompositionStatConfig } from './CompositionStatConfig'
+
+/**
+ * Bar map type.
+ */
+export interface BarMap extends MapInstance {
+    barType(): 'stacked' | 'grouped'
+    barType(v: 'stacked' | 'grouped'): this
+
+    catColors(): any
+    catColors(v: any): this
+
+    catLabels(): any
+    catLabels(v: any): this
+
+    showOnlyWhenComplete(): boolean
+    showOnlyWhenComplete(v: boolean): this
+
+    noDataFillStyle(): string
+    noDataFillStyle(v: string): this
+
+    barMaxWidth(): number
+    barMaxWidth(v: number): this
+
+    barMinWidth(): number
+    barMinWidth(v: number): this
+
+    barHeight(): number
+    barHeight(v: number): this
+
+    barGroupWidth(): number
+    barGroupWidth(v: number): this
+
+    barGroupGap(): number
+    barGroupGap(v: number): this
+
+    barGroupMinHeight(): number
+    barGroupMinHeight(v: number): this
+
+    barGroupMaxHeight(): number
+    barGroupMaxHeight(v: number): this
+
+    barStrokeFill(): string
+    barStrokeFill(v: string): this
+
+    barStrokeWidth(): number
+    barStrokeWidth(v: number): this
+
+    barCornerRadius(): number
+    barCornerRadius(v: number): this
+
+    barOtherColor(): string
+    barOtherColor(v: string): this
+
+    barOtherText(): string
+    barOtherText(v: string): this
+
+    barTooltipWidth(): number
+    barTooltipWidth(v: number): this
+
+    barTooltipHeight(): number
+    barTooltipHeight(v: number): this
+
+    dorling(): boolean
+    dorling(v: boolean): this
+
+    animateDorling(): boolean
+    animateDorling(v: boolean): this
+
+    barTotalCode(): string | undefined
+    barTotalCode(v: string | undefined): this
+
+    statCodes(): string[] | undefined
+    statCodes(v: string[] | undefined): this
+
+    statBar(config: CompositionStatConfig): this
+    statBar(
+        config: CompositionStatConfig,
+        categoryParameter?: string,
+        categoryCodes?: string[],
+        categoryLabels?: string[],
+        categoryColors?: string[],
+        totalCode?: string
+    ): this
+}

package/build/types/map-types/composition/BarMapConfig.d.ts

@@ -0,0 +1,30 @@
+import type { MapConfig } from '../../core/MapConfig'
+
+/**
+ * Configuration for bar chart composition maps.
+ */
+export interface BarMapConfig extends MapConfig {
+    barType?: 'stacked' | 'grouped'
+    catColors?: Record<string, string>
+    catLabels?: Record<string, string>
+    showOnlyWhenComplete?: boolean
+    noDataFillStyle?: string
+    barMinWidth?: number
+    barMaxWidth?: number
+    barHeight?: number
+    barGroupWidth?: number
+    barGroupGap?: number
+    barGroupMinHeight?: number
+    barGroupMaxHeight?: number
+    barStrokeFill?: string
+    barStrokeWidth?: number
+    barCornerRadius?: number
+    barOtherColor?: string
+    barOtherText?: string
+    barTooltipWidth?: number
+    barTooltipHeight?: number
+    dorling?: boolean
+    animateDorling?: boolean
+    barTotalCode?: string
+    statCodes?: string[]
+}

package/build/types/map-types/composition/CompositionStatConfig.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Statistical configuration for composition maps (pie, bar, waffle, stripe).
+ */
+export interface CompositionStatConfig {
+    eurostatDatasetCode?: string
+    filters?: Record<string, any>
+    unitText?: string
+
+    categoryParameter?: string
+    categoryCodes?: string[]
+    categoryLabels?: string[]
+    categoryColors?: string[]
+    totalCode?: string
+
+    // Legacy nested API supported by buildStatCompositionMethod
+    stat?: {
+        eurostatDatasetCode?: string
+        filters?: Record<string, any>
+        unitText?: string
+    }
+}

package/build/types/map-types/composition/CoxcombMap.d.ts

@@ -0,0 +1,42 @@
+import type { MapInstance } from '../../core/MapInstance'
+import type { CoxcombStatConfig } from './CompositionStatConfig'
+
+/**
+ * Coxcomb map type.
+ */
+export interface CoxcombMap extends MapInstance {
+    catColors(): any
+    catColors(v: any): this
+
+    catLabels(): any
+    catLabels(v: any): this
+
+    noDataFillStyle(): string
+    noDataFillStyle(v: string): this
+
+    coxcombMaxRadius(): number
+    coxcombMaxRadius(v: number): this
+
+    coxcombMinRadius(): number
+    coxcombMinRadius(v: number): this
+
+    coxcombRings(): boolean
+    coxcombRings(v: boolean): this
+
+    coxcombStrokeFill(): string
+    coxcombStrokeFill(v: string): this
+
+    coxcombStrokeWidth(): number
+    coxcombStrokeWidth(v: number): this
+
+    hoverColor(): string
+    hoverColor(v: string): this
+
+    classifierSize(): any
+    classifierSize(v: any): this
+
+    coxcombOffsets(): { x: number; y: number }
+    coxcombOffsets(v: { x: number; y: number }): this
+
+    statCoxcomb(config: CoxcombStatConfig): this
+}

package/build/types/map-types/composition/CoxcombMapConfig.d.ts

@@ -0,0 +1,18 @@
+import type { MapConfig } from '../../core/MapConfig'
+
+/**
+ * Configuration for coxcomb (polar area) chart maps.
+ */
+export interface CoxcombMapConfig extends MapConfig {
+    coxcombMinRadius?: number
+    coxcombMaxRadius?: number
+    coxcombStrokeFill?: string
+    coxcombStrokeWidth?: number
+    coxcombRings?: boolean
+    coxcombOffsets?: { x: number; y: number }
+    hoverColor?: string
+    catColors?: Record<string, string>
+    catLabels?: Record<string, string>
+    noDataFillStyle?: string
+    classifierSize?: any
+}

package/build/types/map-types/composition/PieMap.d.ts

@@ -0,0 +1,62 @@
+import type { MapInstance } from '../../core/MapInstance'
+import type { CompositionStatConfig } from './CompositionStatConfig'
+
+/**
+ * Pie map type.
+ */
+export interface PieMap extends MapInstance {
+    catColors(): any
+    catColors(v: any): this
+
+    catLabels(): any
+    catLabels(v: any): this
+
+    showOnlyWhenComplete(): boolean
+    showOnlyWhenComplete(v: boolean): this
+
+    noDataFillStyle(): string
+    noDataFillStyle(v: string): this
+
+    pieMaxRadius(): number
+    pieMaxRadius(v: number): this
+
+    pieMinRadius(): number
+    pieMinRadius(v: number): this
+
+    pieChartInnerRadius(): number
+    pieChartInnerRadius(v: number): this
+
+    pieOtherColor(): string
+    pieOtherColor(v: string): this
+
+    pieOtherText(): string
+    pieOtherText(v: string): this
+
+    pieStrokeFill(): string
+    pieStrokeFill(v: string): this
+
+    pieStrokeWidth(): number
+    pieStrokeWidth(v: number): this
+
+    dorling(): boolean
+    dorling(v: boolean): this
+
+    animateDorling(): boolean
+    animateDorling(v: boolean): this
+
+    pieTotalCode(): string | undefined
+    pieTotalCode(v: string | undefined): this
+
+    statCodes(): string[] | undefined
+    statCodes(v: string[] | undefined): this
+
+    statPie(config: CompositionStatConfig): this
+    statPie(
+        config: CompositionStatConfig,
+        categoryParameter?: string,
+        categoryCodes?: string[],
+        categoryLabels?: string[],
+        categoryColors?: string[],
+        totalCode?: string
+    ): this
+}

package/build/types/map-types/composition/PieMapConfig.d.ts

@@ -0,0 +1,24 @@
+import type { MapConfig } from '../../core/MapConfig'
+
+/**
+ * Configuration for pie chart composition maps.
+ */
+export interface PieMapConfig extends MapConfig {
+    pieMinRadius?: number
+    pieMaxRadius?: number
+    pieChartInnerRadius?: number
+    pieStrokeFill?: string
+    pieStrokeWidth?: number
+    tooltipPieRadius?: number
+    tooltipPieInnerRadius?: number
+    catColors?: Record<string, string>
+    catLabels?: Record<string, string>
+    pieOtherColor?: string
+    pieOtherText?: string
+    showOnlyWhenComplete?: boolean
+    noDataFillStyle?: string
+    dorling?: boolean
+    animateDorling?: boolean
+    pieTotalCode?: string
+    statCodes?: string[]
+}

package/build/types/map-types/composition/SparkMap.d.ts

@@ -0,0 +1,46 @@
+import type { MapInstance } from '../../core/MapInstance'
+import type { SparkStatConfig } from './CompositionStatConfig'
+
+/**
+ * Spark map type.
+ */
+export interface SparkMap extends MapInstance {
+    sparkLineColor(): any
+    sparkLineColor(v: any): this
+
+    showOnlyWhenComplete(): boolean
+    showOnlyWhenComplete(v: boolean): this
+
+    sparkType(): 'line' | 'area' | 'bar'
+    sparkType(v: 'line' | 'area' | 'bar'): this
+
+    sparkLineWidth(): number
+    sparkLineWidth(v: number): this
+
+    sparkLineHeight(): number
+    sparkLineHeight(v: number): this
+
+    sparkLineStrokeWidth(): number
+    sparkLineStrokeWidth(v: number): this
+
+    sparkLineOpacity(): number
+    sparkLineOpacity(v: number): this
+
+    sparkLineCircleRadius(): number
+    sparkLineCircleRadius(v: number): this
+
+    sparkLineAreaColor(): any
+    sparkLineAreaColor(v: any): this
+
+    sparkTooltipChart(): any
+    sparkTooltipChart(v: any): this
+
+    sparkLineChartFunction(): any
+    sparkLineChartFunction(v: any): this
+
+    sparkLineOffsets(): { x: number; y: number }
+    sparkLineOffsets(v: { x: number; y: number }): this
+
+    sparklineData(dataObject: Record<string, Record<string, number>>): this
+    statSpark(config: SparkStatConfig): this
+}

package/build/types/map-types/composition/SparkMapConfig.d.ts

@@ -0,0 +1,25 @@
+import type { MapConfig } from '../../core/MapConfig'
+
+/**
+ * Configuration for sparkline maps.
+ */
+export interface SparkMapConfig extends MapConfig {
+    sparkType?: 'line' | 'area' | 'bar'
+    sparkLineColor?: string | ((value: number, index: number, data: any[]) => string)
+    sparkAreaColor?: string | ((value: number, index: number, data: any[]) => string)
+    sparkLineWidth?: number
+    sparkLineHeight?: number
+    sparkLineStrokeWidth?: number
+    sparkLineOpacity?: number
+    sparkLineCircleRadius?: number
+    sparkTooltipChart?: {
+        width: number
+        height: number
+        margin: { left: number; right: number; top: number; bottom: number }
+        circleRadius: number
+    }
+    sparkLineOffsets?: { x: number; y: number }
+    showOnlyWhenComplete?: boolean
+    sparkLineChartFunction?: (node: any, data: any[], width: number, height: number, isForTooltip?: boolean) => void
+    sparkYScale?: any
+}

package/build/types/map-types/composition/StripeMap.d.ts

@@ -0,0 +1,43 @@
+import type { MapInstance } from '../../core/MapInstance'
+import type { CompositionStatConfig } from './CompositionStatConfig'
+
+/**
+ * Stripe map type.
+ */
+export interface StripeMap extends MapInstance {
+    stripeWidth(): number
+    stripeWidth(v: number): this
+
+    stripeOrientation(): number
+    stripeOrientation(v: number): this
+
+    catColors(): any
+    catColors(v: any): this
+
+    catLabels(): any
+    catLabels(v: any): this
+
+    showOnlyWhenComplete(): boolean
+    showOnlyWhenComplete(v: boolean): this
+
+    noDataFillStyle(): string
+    noDataFillStyle(v: string): this
+
+    pieChartRadius(): number
+    pieChartRadius(v: number): this
+
+    pieChartInnerRadius(): number
+    pieChartInnerRadius(v: number): this
+
+    statCodes(): string[] | undefined
+    statCodes(v: string[] | undefined): this
+
+    statComp(config: CompositionStatConfig): this
+    statComp(
+        config: CompositionStatConfig,
+        categoryParameter?: string,
+        categoryCodes?: string[],
+        categoryLabels?: string[],
+        categoryColors?: string[]
+    ): this
+}

package/build/types/map-types/composition/StripeMapConfig.d.ts

@@ -0,0 +1,16 @@
+import type { MapConfig } from '../../core/MapConfig'
+
+/**
+ * Configuration for stripe composition maps.
+ */
+export interface StripeMapConfig extends MapConfig {
+    stripeWidth?: number
+    stripeOrientation?: number
+    catColors?: Record<string, string>
+    catLabels?: Record<string, string>
+    showOnlyWhenComplete?: boolean
+    noDataFillStyle?: string
+    pieChartRadius?: number
+    pieChartInnerRadius?: number
+    statCodes?: string[]
+}

package/build/types/map-types/composition/WaffleMap.d.ts

@@ -0,0 +1,71 @@
+import type { MapInstance } from '../../core/MapInstance'
+import type { CompositionStatConfig } from './CompositionStatConfig'
+
+/**
+ * Waffle map type.
+ */
+export interface WaffleMap extends MapInstance {
+    catColors(): any
+    catColors(v: any): this
+
+    catLabels(): any
+    catLabels(v: any): this
+
+    showOnlyWhenComplete(): boolean
+    showOnlyWhenComplete(v: boolean): this
+
+    noDataFillStyle(): string
+    noDataFillStyle(v: string): this
+
+    waffleMaxSize(): number
+    waffleMaxSize(v: number): this
+
+    waffleMinSize(): number
+    waffleMinSize(v: number): this
+
+    waffleGridSize(): number
+    waffleGridSize(v: number): this
+
+    waffleCellPadding(): number
+    waffleCellPadding(v: number): this
+
+    waffleOtherColor(): string
+    waffleOtherColor(v: string): this
+
+    waffleOtherText(): string
+    waffleOtherText(v: string): this
+
+    waffleStrokeFill(): string
+    waffleStrokeFill(v: string): this
+
+    waffleStrokeWidth(): number
+    waffleStrokeWidth(v: number): this
+
+    waffleRoundedCorners(): number
+    waffleRoundedCorners(v: number): this
+
+    waffleTooltipSize(): number
+    waffleTooltipSize(v: number): this
+
+    dorling(): boolean
+    dorling(v: boolean): this
+
+    animateDorling(): boolean
+    animateDorling(v: boolean): this
+
+    waffleTotalCode(): string | undefined
+    waffleTotalCode(v: string | undefined): this
+
+    statCodes(): string[] | undefined
+    statCodes(v: string[] | undefined): this
+
+    statWaffle(config: CompositionStatConfig): this
+    statWaffle(
+        config: CompositionStatConfig,
+        categoryParameter?: string,
+        categoryCodes?: string[],
+        categoryLabels?: string[],
+        categoryColors?: string[],
+        totalCode?: string
+    ): this
+}