eurostat-map 4.4.3 → 4.4.5

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

@@ -5,16 +5,28 @@ import type { PieChartLegendConfig } from '../../../legend/composition/PieChartL
  * Configuration for pie chart composition maps.
  */
 export interface PieMapConfig extends MapConfig {
-    /** Pie min radius. */
-    pieMinRadius?: number
-    /** Pie max radius. */
-    pieMaxRadius?: number
-    /** Pie chart inner radius. */
-    pieChartInnerRadius?: number
-    /** Pie stroke fill. */
-    pieStrokeFill?: string
-    /** Pie stroke width. */
-    pieStrokeWidth?: number
+    /** Pie-specific rendering settings. */
+    pieSettings?: {
+        innerRadius?: number
+    }
+    /** Consolidated composition symbol settings. */
+    compositionSettings?: {
+        type?: 'flag' | 'pie' | 'ring' | 'segment' | 'radar' | 'agepyramid' | 'halftone'
+        /** Radar wedge radius mode: share within symbol (default) or absolute values across map. */
+        radarValueMode?: 'share' | 'absolute'
+        minSize?: number
+        maxSize?: number
+        strokeFill?: string
+        strokeWidth?: number
+        reverseOrder?: boolean
+        /** Category code order for composition rendering. */
+        order?: string[]
+        stripesOrientation?: number
+        offsetAngle?: number
+        agePyramidHeightFactor?: number
+        otherColor?: string
+        otherText?: string
+    }
     /** Tooltip pie radius. */
     tooltipPieRadius?: number
     /** Tooltip pie inner radius. */
@@ -23,18 +35,14 @@ export interface PieMapConfig extends MapConfig {
     catColors?: Record<string, string>
     /** Cat labels. */
     catLabels?: Record<string, string>
-    /** Pie other color. */
-    pieOtherColor?: string
-    /** Pie other text. */
-    pieOtherText?: string
     /** Show only when complete. */
     showOnlyWhenComplete?: boolean
     /** No data fill style. */
     noDataFillStyle?: string
     /** Dorling. */
     dorling?: boolean
-    /** Pie total code. */
-    pieTotalCode?: string
+    /** Total code used to compute optional 'other' composition share. */
+    compositionTotalCode?: string
     /** Stat codes. */
     statCodes?: string[]
     /** Legend. */

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

@@ -21,6 +21,12 @@ export interface StripeMap extends MapInstance {
     catLabels(): any
     catLabels(v: any): this
 
+    stripeOtherColor(): string
+    stripeOtherColor(v: string): this
+
+    stripeOtherText(): string
+    stripeOtherText(v: string): this
+
     showOnlyWhenComplete(): boolean
     showOnlyWhenComplete(v: boolean): this
 
@@ -33,6 +39,9 @@ export interface StripeMap extends MapInstance {
     pieChartInnerRadius(): number
     pieChartInnerRadius(v: number): this
 
+    stripeTotalCode(): string | undefined
+    stripeTotalCode(v: string | undefined): this
+
     statCodes(): string[] | undefined
     statCodes(v: string[] | undefined): this
 
@@ -47,6 +56,8 @@ export interface StripeMap extends MapInstance {
         /** Category labels. */
         categoryLabels?: string[],
         /** Category colors. */
-        categoryColors?: string[]
+        categoryColors?: string[],
+        /** Total code. */
+        totalCode?: string
     ): this
 }

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

@@ -13,6 +13,10 @@ export interface StripeMapConfig extends MapConfig {
     catColors?: Record<string, string>
     /** Cat labels. */
     catLabels?: Record<string, string>
+    /** Stripe other color. */
+    stripeOtherColor?: string
+    /** Stripe other text. */
+    stripeOtherText?: string
     /** Show only when complete. */
     showOnlyWhenComplete?: boolean
     /** No data fill style. */
@@ -21,6 +25,8 @@ export interface StripeMapConfig extends MapConfig {
     pieChartRadius?: number
     /** Pie chart inner radius. */
     pieChartInnerRadius?: number
+    /** Stripe total code. */
+    stripeTotalCode?: string
     /** Stat codes. */
     statCodes?: string[]
     /** Legend. */

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

@@ -21,34 +21,79 @@ export interface WaffleMap extends MapInstance {
     noDataFillStyle(): string
     noDataFillStyle(v: string): this
 
+    waffleSettings(): {
+        minSize?: number
+        maxSize?: number
+        gridSize?: number
+        cellPadding?: number
+        strokeFill?: string
+        strokeWidth?: number
+        roundedCorners?: number
+        tooltipSize?: number
+        otherColor?: string
+        otherText?: string
+    }
+    waffleSettings(v: {
+        minSize?: number
+        maxSize?: number
+        gridSize?: number
+        cellPadding?: number
+        strokeFill?: string
+        strokeWidth?: number
+        roundedCorners?: number
+        tooltipSize?: number
+        otherColor?: string
+        otherText?: string
+    }): this
+
+    /** @deprecated Use waffleSettings({ maxSize }) */
     waffleMaxSize(): number
+    /** @deprecated Use waffleSettings({ maxSize }) */
     waffleMaxSize(v: number): this
 
+    /** @deprecated Use waffleSettings({ minSize }) */
     waffleMinSize(): number
+    /** @deprecated Use waffleSettings({ minSize }) */
     waffleMinSize(v: number): this
 
+    /** @deprecated Use waffleSettings({ gridSize }) */
     waffleGridSize(): number
+    /** @deprecated Use waffleSettings({ gridSize }) */
     waffleGridSize(v: number): this
 
+    /** @deprecated Use waffleSettings({ cellPadding }) */
     waffleCellPadding(): number
+    /** @deprecated Use waffleSettings({ cellPadding }) */
     waffleCellPadding(v: number): this
 
+    /** @deprecated Use waffleSettings({ otherColor }) */
     waffleOtherColor(): string
+    /** @deprecated Use waffleSettings({ otherColor }) */
     waffleOtherColor(v: string): this
 
+    /** @deprecated Use waffleSettings({ otherText }) */
     waffleOtherText(): string
+    /** @deprecated Use waffleSettings({ otherText }) */
     waffleOtherText(v: string): this
 
+    /** @deprecated Use waffleSettings({ strokeFill }) */
     waffleStrokeFill(): string
+    /** @deprecated Use waffleSettings({ strokeFill }) */
     waffleStrokeFill(v: string): this
 
+    /** @deprecated Use waffleSettings({ strokeWidth }) */
     waffleStrokeWidth(): number
+    /** @deprecated Use waffleSettings({ strokeWidth }) */
     waffleStrokeWidth(v: number): this
 
+    /** @deprecated Use waffleSettings({ roundedCorners }) */
     waffleRoundedCorners(): number
+    /** @deprecated Use waffleSettings({ roundedCorners }) */
     waffleRoundedCorners(v: number): this
 
+    /** @deprecated Use waffleSettings({ tooltipSize }) */
     waffleTooltipSize(): number
+    /** @deprecated Use waffleSettings({ tooltipSize }) */
     waffleTooltipSize(v: number): this
 
     dorling(): boolean

package/build/types/map-types/composition/waffle/WaffleMapConfig.d.ts

@@ -5,29 +5,43 @@ import type { WaffleLegendConfig } from '../../../legend/composition/WaffleLegen
  * Configuration for waffle chart composition maps.
  */
 export interface WaffleMapConfig extends MapConfig {
-    /** Waffle min size. */
+    /** Consolidated waffle chart settings. */
+    waffleSettings?: {
+        minSize?: number
+        maxSize?: number
+        gridSize?: number
+        cellPadding?: number
+        strokeFill?: string
+        strokeWidth?: number
+        roundedCorners?: number
+        tooltipSize?: number
+        otherColor?: string
+        otherText?: string
+    }
+
+    /** @deprecated Use waffleSettings.minSize */
     waffleMinSize?: number
-    /** Waffle max size. */
+    /** @deprecated Use waffleSettings.maxSize */
     waffleMaxSize?: number
-    /** Waffle grid size. */
+    /** @deprecated Use waffleSettings.gridSize */
     waffleGridSize?: number
-    /** Waffle cell padding. */
+    /** @deprecated Use waffleSettings.cellPadding */
     waffleCellPadding?: number
-    /** Waffle stroke fill. */
+    /** @deprecated Use waffleSettings.strokeFill */
     waffleStrokeFill?: string
-    /** Waffle stroke width. */
+    /** @deprecated Use waffleSettings.strokeWidth */
     waffleStrokeWidth?: number
-    /** Waffle rounded corners. */
+    /** @deprecated Use waffleSettings.roundedCorners */
     waffleRoundedCorners?: number
-    /** Waffle tooltip size. */
+    /** @deprecated Use waffleSettings.tooltipSize */
     waffleTooltipSize?: number
     /** Cat colors. */
     catColors?: Record<string, string>
     /** Cat labels. */
     catLabels?: Record<string, string>
-    /** Waffle other color. */
+    /** @deprecated Use waffleSettings.otherColor */
     waffleOtherColor?: string
-    /** Waffle other text. */
+    /** @deprecated Use waffleSettings.otherText */
     waffleOtherText?: string
     /** Show only when complete. */
     showOnlyWhenComplete?: boolean

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

@@ -1,5 +1,5 @@
-import type { MapInstance } from '../../core/MapInstance'
-import type { FlowMapConfig } from './FlowMapConfig'
-
-/** Creates a flow map instance */
-export function map(config?: FlowMapConfig): MapInstance
+import type { MapInstance } from '../../core/MapInstance'
+import type { FlowMapConfig } from './FlowMapConfig'
+
+/** Creates a flow map instance */
+export function map(config?: FlowMapConfig): MapInstance

package/build/types/map-types/spark/SparkStatConfig.d.ts

@@ -1,16 +1,32 @@
 /**
  * Statistical configuration for sparkline maps.
+ *
+ * Either `eurostatDatasetCode` + `dates` (Eurostat API path)
+ * or `customData` (custom data path) must be provided.
  */
 export interface SparkStatConfig {
-    /** Eurostat dataset code. */
-    eurostatDatasetCode: string
+    /**
+     * Custom data keyed by region ID then date string.
+     * Use instead of `eurostatDatasetCode` when supplying data directly.
+     * When `customData` is set, `eurostatDatasetCode` is not required;
+     * `dates` defaults to the key order of the first region's entries.
+     * @example
+     * customData: {
+     *   ES: { '2020': 100, '2021': 120, '2022': 115 },
+     *   DE: { '2020': 200, '2021': 190, '2022': 210 },
+     * }
+     */
+    customData?: Record<string, Record<string, number>>
+
+    /** Eurostat dataset code. Required when not using `customData`. */
+    eurostatDatasetCode?: string
     /** Filters. */
     filters?: Record<string, any>
     /** Unit text. */
     unitText?: string
     transform?: (value: number) => number
-    /** Dates. */
-    dates: string[]
-    /** Labels. */
+    /** Date keys to fetch. Required when not using `customData`. */
+    dates?: string[]
+    /** Display labels for each date. */
     labels?: string[]
 }

package/package.json

@@ -1,21 +1,20 @@
 {
     "name": "eurostat-map",
-    "version": "4.4.3",
+    "version": "4.4.5",
     "description": "Reusable library to quickly create and customise web maps showing Eurostat data directly retrieved from Eurostat database.",
     "keywords": [
+        "cartography",
+        "data visualization",
+        "dataviz",
+        "maps",
+        "d3",
+        "europe",
         "eurostat",
         "statistics",
-        "europe",
         "SVG",
         "NUTS",
-        "map",
-        "D3",
-        "cartography",
-        "thematic",
-        "mapping",
-        "eurostat-map",
-        "dataviz",
-        "data visualization"
+        "thematic-mapping",
+        "eurostat-map"
     ],
     "homepage": "https://github.com/eurostat/eurostat-map",
     "author": "",
@@ -39,13 +38,14 @@
         "build-prod-debug": "webpack --config webpack/webpack.config.debug-size.js",
         "format": "prettier --write .",
         "copy-types": "copyfiles -u 2 \"src/types/**/*.d.ts\" build/types",
-        "check:types:legend-config-sync": "node test/scripts/check-legend-config-sync.js",
+        "check:types:legend-config-sync": "node scripts/check-legend-config-sync.js",
         "type-check": "npm run check:types:legend-config-sync && tsc --noEmit && tsc --noEmit test/typescript-test.ts",
-        "docs:api": "typedoc --options typedoc.json",
-        "docs": "npm run docs:api",
-        "generate-previews": "node examples/scripts/generate-previews.js",
+        "update-all": "npm run update-types && npm run update-docs && npm run update-examples",
+        "update-types": "node scripts/update-types.js",
+        "update-docs": "typedoc --options typedoc.json",
+        "update-examples": "npm run update-examples-manifest && npm run generate-previews",
         "update-examples-manifest": "node examples/scripts/update-examples-manifest.js",
-        "update-examples": "npm run update-examples-manifest && npm run generate-previews"
+        "generate-previews": "node examples/scripts/generate-previews.js"
     },
     "dependencies": {
         "d3-array": "^3.2.4",