eurostat-map 4.10.9 → 4.10.11

package/build/types/layers/proportional-symbol/ProportionalSymbolConfig.d.ts

@@ -1,52 +1,105 @@
-import type { MapConfig } from '../../core/MapConfig'
-
-export interface ProportionalSymbolSettings {
-    shape?: string
-    customShape?: any
-    customSVG?: any
-    spikeWidth?: number
-    offset?: { x: number; y: number }
-    barWidth?: number
-    minValue?: number | undefined
-    maxValue?: number | undefined
-    fill?: string
-    fillOpacity?: number
-    stroke?: string
-    strokeWidth?: number
-    strokeOpacity?: number
-    sizeScale?: 'sqrt' | 'linear' | any
-    minSize?: number
-    maxSize?: number
-    classes?: number
-    colors?: string[] | null
-    colorFun?: any
-    classToFillStyle?: any
-    thresholds?: number[]
-    classificationMethod?: string
-    brightenFactor?: number
-    codeLabels?: boolean
-}
-
-/**
- * Configuration for proportional symbol maps
- */
-export interface ProportionalSymbolConfig extends MapConfig {
-    /** Fill styles for categorical exceptions in the color dataset, keyed by raw value. */
-    categoryFillStyle?: { [rawValue: string]: string }
-    /** Legend and tooltip labels for categorical exceptions, keyed by raw value. */
-    categoryText?: { [rawValue: string]: string }
-
-    /** Symbol shape used for markers. */
-    symbol?: 'circle' | 'square'
-    /** Base symbol size factor. */
-    size?: number
-
-    /** Dorling cartogram. */
-    dorling?: boolean
-
-    /** Size function. */
-    psCustomSize?: (value: number) => number
-
-    /** Grouped proportional symbol style settings. */
-    psSettings?: ProportionalSymbolSettings
-}
+import type { MapConfig } from '../../core/MapConfig'
+
+export interface ProportionalSymbolSettings {
+    /** Symbol shape. Accepted values: 'circle', 'bar', 'square', 'star', 'diamond', 'wye', 'cross', 'triangle', 'spike'. */
+    shape?: string
+    /** Custom d3-shape symbol type, used when shape is not one of the built-in shapes. */
+    customShape?: any
+    /** Custom SVG symbol markup/selector to use instead of a built-in shape. */
+    customSVG?: any
+    spikeWidth?: number
+    offset?: { x: number; y: number }
+    barWidth?: number
+    minValue?: number | undefined
+    maxValue?: number | undefined
+    fill?: string
+    fillOpacity?: number
+    stroke?: string
+    strokeWidth?: number
+    strokeOpacity?: number
+    sizeScale?: 'sqrt' | 'linear'
+    minSize?: number
+    maxSize?: number
+    classes?: number
+    colors?: string[] | null
+    /** d3-scale-chromatic interpolator used to auto-generate colors when not set explicitly. */
+    colorFun?: (t: number) => string
+    /** Function mapping a class index and the number of classes to a fill color. */
+    classToFillStyle?: (ecl: number, numberOfClasses: number) => string
+    thresholds?: number[]
+    classificationMethod?: 'quantile' | 'equinter' | 'threshold'
+    brightenFactor?: number
+    codeLabels?: boolean
+}
+
+/**
+ * Configuration for proportional symbol maps
+ */
+export interface ProportionalSymbolConfig extends MapConfig {
+    /** Fill styles for categorical exceptions in the color dataset, keyed by raw value. */
+    categoryFillStyle?: { [rawValue: string]: string }
+    /** Legend and tooltip labels for categorical exceptions, keyed by raw value. */
+    categoryText?: { [rawValue: string]: string }
+
+    /** Dorling cartogram. */
+    dorling?: boolean
+
+    /** Dorling simulation settings for this layer. Defaults to the map's dorlingSettings. */
+    dorlingSettings?: import('../../core/DorlingSettings').DorlingSettings
+
+    /** Grouped proportional symbol style settings. Preferred over the individual `ps*` fields below. */
+    psSettings?: ProportionalSymbolSettings
+
+    /** Symbol shape. Accepted values: 'circle', 'bar', 'square', 'star', 'diamond', 'wye', 'cross', 'triangle', 'spike'. @default 'circle' */
+    psShape?: string
+    /** Custom d3-shape symbol type, used when psShape is not one of the built-in shapes. */
+    psCustomShape?: any
+    /** Custom SVG symbol markup/selector to use instead of a built-in shape. */
+    psCustomSVG?: any
+    /** Width in pixels of spike symbols (psShape: 'spike'). @default 7 */
+    psSpikeWidth?: number
+    /** Pixel offset {x, y} applied to each symbol, scaled with symbol size. */
+    psOffset?: { x: number; y: number }
+    /** Width in pixels of vertical bar symbols (psShape: 'bar'). @default 10 */
+    psBarWidth?: number
+    /** Max symbol size in pixels. @default 30 */
+    psMaxSize?: number
+    /** Min symbol size in pixels. @default 5 */
+    psMinSize?: number
+    /** Value mapped to psMaxSize. Auto-detected from the data when omitted. */
+    psMaxValue?: number
+    /** Value mapped to psMinSize. Auto-detected from the data when omitted. */
+    psMinValue?: number
+    /** Size scale type. @default 'sqrt' */
+    psSizeScale?: 'sqrt' | 'linear'
+    /** Fill color, used when the symbols are not colored by a classified stat. @default '#009569' */
+    psFill?: string
+    /** Fill opacity. @default 1 */
+    psFillOpacity?: number
+    /** Stroke color. @default '#ffffff' */
+    psStroke?: string
+    /** Stroke width. @default 0.2 */
+    psStrokeWidth?: number
+    /** Stroke opacity. @default 1 */
+    psStrokeOpacity?: number
+    /** Number of color classes. @default 5 */
+    psClasses?: number
+    /** Colors used for the color classes. */
+    psColors?: string[] | null
+    /** d3-scale-chromatic interpolator used to auto-generate psColors when not set explicitly. */
+    psColorFun?: any
+    /** Function mapping a class index to a fill color. Auto-derived from psColors/psColorFun when unset. */
+    psClassToFillStyle?: any
+    /** Thresholds, used when psClassificationMethod is 'threshold'. */
+    psThresholds?: number[]
+    /** Color classification method. @default 'quantile' */
+    psClassificationMethod?: 'quantile' | 'equinter' | 'threshold'
+    /** Brighten factor applied to generated color classes. @default 0.9 */
+    psBrightenFactor?: number
+    /** Show region code labels next to symbols. @default false */
+    psCodeLabels?: boolean
+    /** The classifier function used for sizing symbols. */
+    classifierSize?: any
+    /** The classifier function used for coloring symbols. */
+    classifierColor?: any
+}

package/build/types/layers/proportional-symbol/ProportionalSymbolMap.d.ts

@@ -1,100 +1,104 @@
-import { MapInstance } from '../../core/MapInstance'
-import type { ProportionalSymbolSettings } from './ProportionalSymbolConfig'
-
-/**
- * Proportional symbol map object
- */
-export interface ProportionalSymbolMap extends MapInstance {
-    categoryFillStyle(): { [rawValue: string]: string } | undefined
-    categoryFillStyle(v: { [rawValue: string]: string }): this
-
-    categoryText(): { [rawValue: string]: string } | undefined
-    categoryText(v: { [rawValue: string]: string }): this
-
-    psSettings(): ProportionalSymbolSettings
-    psSettings(v: ProportionalSymbolSettings): this
-
-    psMaxSize(): number
-    psMaxSize(v: number): this
-
-    psMinSize(): number
-    psMinSize(v: number): this
-
-    psMaxValue(): number | undefined
-    psMaxValue(v: number | undefined): this
-
-    psMinValue(): number | undefined
-    psMinValue(v: number | undefined): this
-
-    psFill(): string
-    psFill(v: string): this
-
-    psFillOpacity(): number
-    psFillOpacity(v: number): this
-
-    psStrokeOpacity(): number
-    psStrokeOpacity(v: number): this
-
-    psStroke(): string
-    psStroke(v: string): this
-
-    psStrokeWidth(): number
-    psStrokeWidth(v: number): this
-
-    classifierSize(): any
-    classifierSize(v: any): this
-
-    classifierColor(): any
-    classifierColor(v: any): this
-
-    psShape(): string
-    psShape(v: string): this
-
-    psCustomShape(): any
-    psCustomShape(v: any): this
-
-    psBarWidth(): number
-    psBarWidth(v: number): this
-
-    psClassToFillStyle(): any
-    psClassToFillStyle(v: any): this
-
-    psColorFun(): any
-    psColorFun(v: any): this
-
-    psSizeScale(): any
-    psSizeScale(v: any): this
-
-    noDataFillStyle(): string
-    noDataFillStyle(v: string): this
-
-    psThresholds(): number[]
-    psThresholds(v: number[]): this
-
-    psColors(): string[] | null
-    psColors(v: string[] | null): this
-
-    psCustomSVG(): any
-    psCustomSVG(v: any): this
-
-    psOffset(): { x: number; y: number }
-    psOffset(v: { x: number; y: number }): this
-
-    psClassificationMethod(): string
-    psClassificationMethod(v: string): this
-
-    psClasses(): number
-    psClasses(v: number): this
-
-    dorling(): boolean
-    dorling(v: boolean): this
-
-    psSpikeWidth(): number
-    psSpikeWidth(v: number): this
-
-    psCodeLabels(): boolean
-    psCodeLabels(v: boolean): this
-
-    psBrightenFactor(): number
-    psBrightenFactor(v: number): this
-}
+import { MapInstance } from '../../core/MapInstance'
+import type { ProportionalSymbolSettings } from './ProportionalSymbolConfig'
+
+/**
+ * Proportional symbol map object
+ */
+export interface ProportionalSymbolMap extends MapInstance {
+    categoryFillStyle(): { [rawValue: string]: string } | undefined
+    categoryFillStyle(v: { [rawValue: string]: string }): this
+
+    categoryText(): { [rawValue: string]: string } | undefined
+    categoryText(v: { [rawValue: string]: string }): this
+
+    psSettings(): ProportionalSymbolSettings
+    psSettings(v: ProportionalSymbolSettings): this
+
+    psMaxSize(): number
+    psMaxSize(v: number): this
+
+    psMinSize(): number
+    psMinSize(v: number): this
+
+    psMaxValue(): number | undefined
+    psMaxValue(v: number | undefined): this
+
+    psMinValue(): number | undefined
+    psMinValue(v: number | undefined): this
+
+    psFill(): string
+    psFill(v: string): this
+
+    psFillOpacity(): number
+    psFillOpacity(v: number): this
+
+    psStrokeOpacity(): number
+    psStrokeOpacity(v: number): this
+
+    psStroke(): string
+    psStroke(v: string): this
+
+    psStrokeWidth(): number
+    psStrokeWidth(v: number): this
+
+    /** D3 scale mapping a stat value to a symbol size in pixels. */
+    classifierSize(): ((value: number) => number) & { domain: (d?: number[]) => any }
+    classifierSize(v: ((value: number) => number) & { domain?: (d?: number[]) => any }): this
+
+    /** D3 scale mapping a stat value to a color class index. */
+    classifierColor(): ((value: number) => number) | undefined
+    classifierColor(v: (value: number) => number): this
+
+    psShape(): string
+    psShape(v: string): this
+
+    psCustomShape(): any
+    psCustomShape(v: any): this
+
+    psBarWidth(): number
+    psBarWidth(v: number): this
+
+    /** Function mapping a class index and the number of classes to a fill color. */
+    psClassToFillStyle(): (ecl: number, numberOfClasses: number) => string
+    psClassToFillStyle(v: (ecl: number, numberOfClasses: number) => string): this
+
+    /** d3-scale-chromatic interpolator used to auto-generate psColors when not set explicitly. */
+    psColorFun(): (t: number) => string
+    psColorFun(v: (t: number) => string): this
+
+    psSizeScale(): 'sqrt' | 'linear' | undefined
+    psSizeScale(v: 'sqrt' | 'linear'): this
+
+    noDataFillStyle(): string
+    noDataFillStyle(v: string): this
+
+    psThresholds(): number[]
+    psThresholds(v: number[]): this
+
+    psColors(): string[] | null
+    psColors(v: string[] | null): this
+
+    psCustomSVG(): any
+    psCustomSVG(v: any): this
+
+    psOffset(): { x: number; y: number }
+    psOffset(v: { x: number; y: number }): this
+
+    psClassificationMethod(): string
+    psClassificationMethod(v: string): this
+
+    psClasses(): number
+    psClasses(v: number): this
+
+    dorling(): boolean
+    dorling(v: boolean): this
+
+    psSpikeWidth(): number
+    psSpikeWidth(v: number): this
+
+    psCodeLabels(): boolean
+    psCodeLabels(v: boolean): this
+
+    psBrightenFactor(): number
+    psBrightenFactor(v: number): this
+}

package/build/types/layers/proportional-symbol/mushroom/MushroomMap.d.ts

@@ -4,15 +4,19 @@ import type { MapInstance } from '../../../core/MapInstance'
  * Mushroom map type.
  */
 export interface MushroomMap extends MapInstance {
+    /** Returns the resolved [v1, v2] stat codes for the two mushroom sides, honoring any
+     * 'left'/'right' or 'v1'/'v2' encodings before falling back to mushroomCodes. */
+    getMushroomStatCodes(): [string, string]
+
     mushroomSettings(): {
         codes: [string, string]
         minSize: number
         maxSize: number
         colors: [string, string]
         orientation: 'horizontal' | 'vertical'
-        sizeScaleFunction: any
-        sizeScaleFunctionV1: any
-        sizeScaleFunctionV2: any
+        sizeScaleFunction: ((value: number) => number) | null
+        sizeScaleFunctionV1: ((value: number) => number) | null
+        sizeScaleFunctionV2: ((value: number) => number) | null
     }
     mushroomSettings(v: {
         codes?: [string, string]
@@ -20,9 +24,9 @@ export interface MushroomMap extends MapInstance {
         maxSize?: number
         colors?: [string, string]
         orientation?: 'horizontal' | 'vertical'
-        sizeScaleFunction?: any
-        sizeScaleFunctionV1?: any
-        sizeScaleFunctionV2?: any
+        sizeScaleFunction?: ((value: number) => number) | null
+        sizeScaleFunctionV1?: ((value: number) => number) | null
+        sizeScaleFunctionV2?: ((value: number) => number) | null
     }): this
 
     /** @deprecated Use mushroomSettings({ codes }) */
@@ -51,17 +55,17 @@ export interface MushroomMap extends MapInstance {
     mushroomOrientation(v: 'horizontal' | 'vertical'): this
 
     /** @deprecated Use mushroomSettings({ sizeScaleFunction }) */
-    mushroomSizeScaleFunction(): any
+    mushroomSizeScaleFunction(): ((value: number) => number) | null
     /** @deprecated Use mushroomSettings({ sizeScaleFunction }) */
-    mushroomSizeScaleFunction(v: any): this
+    mushroomSizeScaleFunction(v: (value: number) => number): this
 
     /** @deprecated Use mushroomSettings({ sizeScaleFunctionV1 }) */
-    mushroomSizeScaleFunctionV1(): any
+    mushroomSizeScaleFunctionV1(): ((value: number) => number) | null
     /** @deprecated Use mushroomSettings({ sizeScaleFunctionV1 }) */
-    mushroomSizeScaleFunctionV1(v: any): this
+    mushroomSizeScaleFunctionV1(v: (value: number) => number): this
 
     /** @deprecated Use mushroomSettings({ sizeScaleFunctionV2 }) */
-    mushroomSizeScaleFunctionV2(): any
+    mushroomSizeScaleFunctionV2(): ((value: number) => number) | null
     /** @deprecated Use mushroomSettings({ sizeScaleFunctionV2 }) */
-    mushroomSizeScaleFunctionV2(v: any): this
+    mushroomSizeScaleFunctionV2(v: (value: number) => number): this
 }

package/build/types/layers/spark/SparkMap.d.ts

@@ -13,8 +13,8 @@ export interface SparkMap extends MapInstance {
     legend(): SparklineLegendConfig | false
     legend(config: SparklineLegendConfig | false): this
 
-    sparkLineColor(): any
-    sparkLineColor(v: any): this
+    sparkLineColor(): string | ((value: number, index: number, data: any[]) => string)
+    sparkLineColor(v: string | ((value: number, index: number, data: any[]) => string)): this
 
     showOnlyWhenComplete(): boolean
     showOnlyWhenComplete(v: boolean): this
@@ -37,14 +37,20 @@ export interface SparkMap extends MapInstance {
     sparkLineCircleRadius(): number
     sparkLineCircleRadius(v: number): this
 
-    sparkLineAreaColor(): any
-    sparkLineAreaColor(v: any): this
+    /** Alias for the areaColor setting (backward-compatible name). */
+    sparkLineAreaColor(): string | ((value: number, index: number, data: any[]) => string)
+    sparkLineAreaColor(v: string | ((value: number, index: number, data: any[]) => string)): this
 
-    sparkTooltipChart(): any
-    sparkTooltipChart(v: any): this
+    sparkTooltipChart(): { width: number; height: number; margin: { left: number; right: number; top: number; bottom: number }; circleRadius: number }
+    sparkTooltipChart(v: {
+        width: number
+        height: number
+        margin: { left: number; right: number; top: number; bottom: number }
+        circleRadius: number
+    }): this
 
-    sparkLineChartFunction(): any
-    sparkLineChartFunction(v: any): this
+    sparkLineChartFunction(): ((node: any, data: any[], width: number, height: number, isForTooltip?: boolean) => void) | undefined
+    sparkLineChartFunction(v: (node: any, data: any[], width: number, height: number, isForTooltip?: boolean) => void): this
 
     sparkLineOffsets(): { x: number; y: number }
     sparkLineOffsets(v: { x: number; y: number }): this

package/build/types/layers/spark/SparkMapConfig.d.ts

@@ -1,5 +1,6 @@
 import type { MapConfig } from '../../core/MapConfig'
 import type { SparklineLegendConfig } from '../../legend/composition/SparklineLegendConfig'
+import type { SparkStatConfig } from './SparkStatConfig'
 
 export interface SparkSettings {
     type?: 'line' | 'area' | 'bar'
@@ -24,22 +25,19 @@ export interface SparkSettings {
  * Configuration for sparkline maps.
  */
 export interface SparkMapConfig extends MapConfig {
+    /**
+     * Statistical data configuration. For sparkline maps, pass a `dates`-keyed
+     * SparkStatConfig (equivalent to calling `.statSpark(...)`) rather than a plain
+     * single-value StatConfig.
+     */
+    stat?: SparkStatConfig
+
     /** Grouped sparkline rendering settings. */
     sparkSettings?: SparkSettings
 
     /** Spark type. */
     sparkType?: 'line' | 'area' | 'bar'
 
-    /** Object-form stat configuration for temporal sparkline datasets. */
-    dates?: string[]
-    labels?: string[]
-    eurostatDatasetCode?: string
-    customData?: Record<string, Record<string, number>>
-    filters?: Record<string, any>
-    unitText?: string
-    preprocess?: (regionId: string, value: any) => any
-    transform?: (value: any) => any
-
     sparkLineColor?: string | ((value: number, index: number, data: any[]) => string)
     sparkAreaColor?: string | ((value: number, index: number, data: any[]) => string)
     /** Spark line width. */
@@ -68,8 +66,6 @@ export interface SparkMapConfig extends MapConfig {
     /** Show only when complete. */
     showOnlyWhenComplete?: boolean
     sparkLineChartFunction?: (node: any, data: any[], width: number, height: number, isForTooltip?: boolean) => void
-    /** Spark yscale. */
-    sparkYScale?: any
     /** Legend. */
     legend?: SparklineLegendConfig | false
 }

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

@@ -1,73 +1,72 @@
-/**
- * Parent configuration for map legends. Each map type will extend this with its own specific properties, but these are the common ones that apply to all legend types.
- */
-export interface LegendConfig {
-    /** Legend origin x-coordinate in pixels. */
-    x?: number
-    /** Legend origin y-coordinate in pixels. */
-    y?: number
-    /** Automatically position the legend in a map corner. Manual x/y coordinates take precedence. */
-    position?: 'top right' | 'bottom right' | 'top left' | 'bottom left'
-    /** Legend width in pixels. */
-    width?: number
-    /** Legend height in pixels. */
-    height?: number
-
-    /** Legend title text. */
-    title?: string
-    /** Legend subtitle text. */
-    subtitle?: string
-    /** Legend title font size in pixels. */
-    titleFontSize?: number
-
-    /** Box styling. */
-    /** Inner spacing around legend content. */
-    boxPadding?: number
-    /** Background opacity of the legend box. */
-    boxOpacity?: number
-    /** 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
-
-    /** Shape styling (for proportional symbol legends). */
-    /** Symbol swatch width in pixels. */
-    shapeWidth?: number
-    /** Symbol swatch height in pixels. */
-    shapeHeight?: number
-    /** Horizontal gap between shape and label. */
-    shapePadding?: number
-    /** Length of separator lines in discrete legends. */
-    sepLineLength?: number
-
-    /** Label styling. */
-    /** Label font size in pixels. */
-    labelFontSize?: number
-    /** Pixel offsets applied to labels. */
-    labelOffsets?: { x: number; y: number }
-    /** Custom formatter for legend labels. */
-    labelFormatter?: ((value: number, index?: number) => string) | null
-    /** Number of decimal places for auto-formatted labels. */
-    decimals?: number
-
-    /** Legend layout direction. */
-    orientation?: 'vertical' | 'horizontal'
-    /** Sort legend entries in ascending order when true. */
-    ascending?: boolean
-    /** Whether to display the no-data legend item. */
-    noData?: boolean
-    /** Label used for no-data legend item. */
-    noDataText?: string
-    /** Vertical gap before the no-data swatch in pixels. */
-    noDataPadding?: number
-    /** Width of the no-data swatch in pixels. */
-    noDataShapeWidth?: number
-    /** Height of the no-data swatch in pixels. */
-    noDataShapeHeight?: number
-
-    /** Whether to show dataset min/max labels when supported. */
-    maxMin?: boolean
-    /** Text affixes for min/max labels as [minSuffix, maxSuffix]. */
-    maxMinLabels?: [string, string]
-    layer?: any
-}
+/**
+ * Parent configuration for map legends. Each map type will extend this with its own specific properties, but these are the common ones that apply to all legend types.
+ */
+export interface LegendConfig {
+    /** Legend origin x-coordinate in pixels. */
+    x?: number
+    /** Legend origin y-coordinate in pixels. */
+    y?: number
+    /** Automatically position the legend in a map corner. Manual x/y coordinates take precedence. */
+    position?: 'top right' | 'bottom right' | 'top left' | 'bottom left'
+    /** Legend width in pixels. */
+    width?: number
+    /** Legend height in pixels. */
+    height?: number
+
+    /** Legend title text. */
+    title?: string
+    /** Legend subtitle text. */
+    subtitle?: string
+    /** Legend title font size in pixels. */
+    titleFontSize?: number
+
+    /** Box styling. */
+    /** Inner spacing around legend content. */
+    boxPadding?: number
+    /** Background opacity of the legend box. */
+    boxOpacity?: number
+    /** 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
+
+    /** Shape styling (for proportional symbol legends). */
+    /** Symbol swatch width in pixels. */
+    shapeWidth?: number
+    /** Symbol swatch height in pixels. */
+    shapeHeight?: number
+    /** Horizontal gap between shape and label. */
+    shapePadding?: number
+    /** Length of separator lines in discrete legends. */
+    sepLineLength?: number
+
+    /** Label styling. */
+    /** Label font size in pixels. */
+    labelFontSize?: number
+    /** Pixel offsets applied to labels. */
+    labelOffsets?: { x: number; y: number }
+    /** Custom formatter for legend labels. */
+    labelFormatter?: ((value: number, index?: number) => string) | null
+    /** Number of decimal places for auto-formatted labels. */
+    decimals?: number
+
+    /** Legend layout direction. */
+    orientation?: 'vertical' | 'horizontal'
+    /** Sort legend entries in ascending order when true. */
+    ascending?: boolean
+    /** Whether to display the no-data legend item. */
+    noData?: boolean
+    /** Label used for no-data legend item. */
+    noDataText?: string
+    /** Vertical gap before the no-data swatch in pixels. */
+    noDataPadding?: number
+    /** Width of the no-data swatch in pixels. */
+    noDataShapeWidth?: number
+    /** Height of the no-data swatch in pixels. */
+    noDataShapeHeight?: number
+
+    /** Whether to show dataset min/max labels when supported. */
+    maxMin?: boolean
+    /** Text affixes for min/max labels as [minSuffix, maxSuffix]. */
+    maxMinLabels?: [string, string]
+}