@gooddata/sdk-ui-geo 11.6.0-alpha.5 → 11.6.0-alpha.7

package/esm/next/features/coloring/palette.js

@@ -0,0 +1,233 @@
+// (C) 2025 GoodData Corporation
+import { isEmpty, range } from "lodash-es";
+import { isAttributeDescriptor, isResultAttributeHeader } from "@gooddata/sdk-model";
+import { DEFAULT_PUSHPIN_BORDER_COLOR_VALUE, DEFAULT_PUSHPIN_COLOR_OPACITY, DEFAULT_PUSHPIN_COLOR_SCALE, } from "../../constants/geoChart.js";
+import { getMinMax } from "../size/calculations.js";
+/**
+ * Color palette functions for GeoPushpinChartNext
+ *
+ * @internal
+ */
+const DEFAULT_SEGMENT_ITEM = "default_segment_item";
+const DEFAULT_COLOR_INDEX_IN_PALETTE = DEFAULT_PUSHPIN_COLOR_SCALE - 1;
+/**
+ * Formats RGB color values into CSS color string
+ */
+function formatColor(red, green, blue, opacity = 1) {
+    if (opacity === 1) {
+        return `rgb(${red},${green},${blue})`;
+    }
+    return `rgba(${red},${green},${blue},${opacity})`;
+}
+/**
+ * Parses RGB color string into component values
+ */
+function parseRGBColorCode(color) {
+    const parts = color.split(",");
+    const R = parseInt(parts[0].slice(4), 10);
+    const G = parseInt(parts[1], 10);
+    const B = parseInt(parts[2], 10);
+    return { R, G, B };
+}
+/**
+ * Calculates a color channel value for a gradient step
+ */
+function getCalculatedChannel(channel, index, step) {
+    return Math.trunc(channel + index * step);
+}
+/**
+ * Generates an array of gradient colors
+ */
+function getCalculatedColors(count, channels, steps, opacity = 1) {
+    return range(1, count).map((index) => formatColor(getCalculatedChannel(channels[0], index, steps[0]), getCalculatedChannel(channels[1], index, steps[1]), getCalculatedChannel(channels[2], index, steps[2]), opacity));
+}
+/**
+ * Converts color to RGB color code object
+ */
+function getRGBColorCode(color) {
+    if (typeof color === "string") {
+        const { R: r, G: g, B: b } = parseRGBColorCode(color);
+        return { r, g, b };
+    }
+    return color;
+}
+/**
+ * Generates a color palette from a base color
+ *
+ * @remarks
+ * Creates a gradient palette with lighter shades, useful for color scales
+ *
+ * @param baseColor - Base color as RGB string or object
+ * @param opacity - Opacity value (0-1)
+ * @returns Array of color strings from light to dark
+ *
+ * @internal
+ */
+export function getColorPalette(baseColor, opacity = 1) {
+    const colorItemsCount = 6;
+    const { r, g, b } = getRGBColorCode(baseColor);
+    const channels = [r, g, b];
+    const steps = channels.map((channel) => (255 - channel) / colorItemsCount);
+    const generatedColors = getCalculatedColors(colorItemsCount, channels, steps, opacity);
+    return [...generatedColors.reverse(), formatColor(r, g, b, opacity)];
+}
+/**
+ * Converts RGB color to RGBA with opacity
+ *
+ * @param color - RGB color string
+ * @param opacity - Opacity value (0-1)
+ * @returns RGBA color string
+ *
+ * @internal
+ */
+export function rgbToRgba(color, opacity = 1) {
+    const { R, G, B } = parseRGBColorCode(color);
+    return formatColor(R, G, B, opacity);
+}
+/**
+ * Gets the color palette index for a given value
+ *
+ * @param value - Value to map to palette
+ * @param min - Minimum value in range
+ * @param max - Maximum value in range
+ * @returns Index in the color palette (0 to DEFAULT_PUSHPIN_COLOR_SCALE - 1)
+ *
+ * @internal
+ */
+export function getColorIndexInPalette(value, min, max) {
+    if (value === null || !Number.isFinite(value) || min === max || value === min) {
+        return 0;
+    }
+    if (value === max) {
+        return DEFAULT_COLOR_INDEX_IN_PALETTE;
+    }
+    const step = (max - min) / DEFAULT_PUSHPIN_COLOR_SCALE;
+    for (let i = 0, offset = min; i < DEFAULT_PUSHPIN_COLOR_SCALE; i++, offset += step) {
+        if (offset >= value) {
+            return i;
+        }
+    }
+    return DEFAULT_COLOR_INDEX_IN_PALETTE;
+}
+/**
+ * Creates a mapping of segment names to color palettes
+ *
+ * @param colorStrategy - Color strategy from visualization
+ * @returns Map of segment names to color palettes
+ *
+ * @internal
+ */
+export function getColorPaletteMapping(colorStrategy) {
+    const colorAssignment = colorStrategy.getColorAssignment();
+    return colorAssignment.reduce((result, item, index) => {
+        const color = colorStrategy.getColorByIndex(index);
+        const colorPalette = getColorPalette(color, DEFAULT_PUSHPIN_COLOR_OPACITY);
+        // Color based on Location
+        if (isAttributeDescriptor(item.headerItem)) {
+            return {
+                [DEFAULT_SEGMENT_ITEM]: colorPalette,
+            };
+        }
+        // Color based on SegmentBy
+        const name = isResultAttributeHeader(item.headerItem)
+            ? item.headerItem.attributeHeaderItem.name
+            : DEFAULT_SEGMENT_ITEM;
+        result[name ?? DEFAULT_SEGMENT_ITEM] = colorPalette;
+        return result;
+    }, {});
+}
+/**
+ * Generates pushpin colors based on color and segment values
+ *
+ * @remarks
+ * Determines border and background colors for each pushpin based on:
+ * - Color measure values
+ * - Segment values
+ * - Color strategy
+ *
+ * @param colorValues - Array of color measure values (can be null)
+ * @param segmentValues - Array of segment names
+ * @param colorStrategy - Color strategy for palette generation
+ * @returns Array of pushpin color configurations
+ *
+ * @internal
+ */
+export function getPushpinColors(colorValues, segmentValues = [], colorStrategy) {
+    const defaultColorValue = colorStrategy.getColorByIndex(0);
+    const defaultColor = rgbToRgba(defaultColorValue, DEFAULT_PUSHPIN_COLOR_OPACITY);
+    // No color or segment data - use default
+    if (colorValues.length === 0 && segmentValues.length === 0) {
+        return [
+            {
+                border: DEFAULT_PUSHPIN_BORDER_COLOR_VALUE,
+                background: defaultColor,
+            },
+        ];
+    }
+    const segmentNames = [...segmentValues];
+    const colorPaletteMapping = getColorPaletteMapping(colorStrategy);
+    // Only segment data, no color measure
+    if (colorValues.length === 0) {
+        return segmentNames.map((name) => {
+            const palette = colorPaletteMapping[name];
+            return {
+                border: DEFAULT_PUSHPIN_BORDER_COLOR_VALUE,
+                background: palette[DEFAULT_COLOR_INDEX_IN_PALETTE],
+            };
+        });
+    }
+    // Calculate min/max for color scale
+    const colorsWithoutNull = colorValues.filter((value) => value !== null && Number.isFinite(value));
+    const { min, max } = getMinMax(colorsWithoutNull);
+    // All values are the same and no segments - use default
+    if (min === max && segmentValues.length === 0) {
+        return [
+            {
+                border: DEFAULT_PUSHPIN_BORDER_COLOR_VALUE,
+                background: defaultColor,
+            },
+        ];
+    }
+    // Generate colors for each data point
+    return colorValues.map((color, index) => {
+        const value = color !== null && Number.isFinite(color) ? color : min;
+        const colorIndex = getColorIndexInPalette(value, min, max);
+        const segmentItemName = segmentNames[index] || DEFAULT_SEGMENT_ITEM;
+        const palette = colorPaletteMapping[segmentItemName];
+        return {
+            border: palette[DEFAULT_COLOR_INDEX_IN_PALETTE],
+            background: palette[colorIndex],
+        };
+    });
+}
+/**
+ * Generates legend color data for a color measure
+ *
+ * @param colorSeries - Array of color values
+ * @param colorString - Base color as string
+ * @returns Array of color legend items with ranges
+ *
+ * @internal
+ */
+export function generateLegendColorData(colorSeries, colorString) {
+    if (isEmpty(colorSeries)) {
+        return [];
+    }
+    const colorPalette = getColorPalette(colorString, DEFAULT_PUSHPIN_COLOR_OPACITY);
+    const min = Math.min(...colorSeries);
+    const max = Math.max(...colorSeries);
+    const offset = (max - min) / DEFAULT_PUSHPIN_COLOR_SCALE;
+    if (min === max) {
+        return [];
+    }
+    return range(0, DEFAULT_PUSHPIN_COLOR_SCALE).map((index) => {
+        const from = min + offset * index;
+        const isLastItem = index === DEFAULT_PUSHPIN_COLOR_SCALE - 1;
+        const to = isLastItem ? max : from + offset;
+        return {
+            range: { from, to },
+            color: colorPalette[index],
+        };
+    });
+}
+//# sourceMappingURL=palette.js.map

package/esm/next/features/coloring/palette.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"palette.js","sourceRoot":"","sources":["../../../../src/next/features/coloring/palette.ts"],"names":[],"mappings":"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"}

package/esm/next/features/data/dataSourceManagement.d.ts

@@ -0,0 +1,20 @@
+import { IColorStrategy } from "@gooddata/sdk-ui-vis-commons";
+import { IMapConfig } from "../../types/mapProvider.js";
+import { IGeoData } from "../../types/shared.js";
+/**
+ * Create GeoJSON data source for map
+ *
+ * @remarks
+ * This function creates a GeoJSON data source from geographic data, applying
+ * the color strategy and configuring clustering if enabled. The resulting
+ * source can be added to the map with map.addSource().
+ *
+ * @param geoData - Geographic data to display
+ * @param colorStrategy - Color strategy for styling
+ * @param config - Map configuration
+ * @returns GeoJSON source specification
+ *
+ * @internal
+ */
+export declare function createGeoDataSource(geoData: IGeoData, colorStrategy: IColorStrategy, config: IMapConfig): import("maplibre-gl").GeoJSONSourceSpecification;
+//# sourceMappingURL=dataSourceManagement.d.ts.map

package/esm/next/features/data/dataSourceManagement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataSourceManagement.d.ts","sourceRoot":"","sources":["../../../../src/next/features/data/dataSourceManagement.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAG9D,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGjD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,oDAYvG"}

package/esm/next/features/data/dataSourceManagement.js

@@ -0,0 +1,30 @@
+// (C) 2025 GoodData Corporation
+import { createPushpinDataSource } from "../../providers/maplibre/maplibreDataSource.js";
+import { isClusteringAllowed } from "../clustering/clustering.js";
+/**
+ * Create GeoJSON data source for map
+ *
+ * @remarks
+ * This function creates a GeoJSON data source from geographic data, applying
+ * the color strategy and configuring clustering if enabled. The resulting
+ * source can be added to the map with map.addSource().
+ *
+ * @param geoData - Geographic data to display
+ * @param colorStrategy - Color strategy for styling
+ * @param config - Map configuration
+ * @returns GeoJSON source specification
+ *
+ * @internal
+ */
+export function createGeoDataSource(geoData, colorStrategy, config) {
+    const { points: geoPointsConfig = {} } = config;
+    const hasClustering = isClusteringAllowed(geoData, geoPointsConfig.groupNearbyPoints);
+    const dataSourceProps = {
+        geoData,
+        config,
+        colorStrategy,
+        hasClustering,
+    };
+    return createPushpinDataSource(dataSourceProps);
+}
+//# sourceMappingURL=dataSourceManagement.js.map

package/esm/next/features/data/dataSourceManagement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataSourceManagement.js","sourceRoot":"","sources":["../../../../src/next/features/data/dataSourceManagement.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAIhC,OAAO,EAAuB,uBAAuB,EAAE,MAAM,gDAAgD,CAAC;AAG9G,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAElE;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAiB,EAAE,aAA6B,EAAE,MAAkB;IACpG,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC;IAChD,MAAM,aAAa,GAAG,mBAAmB,CAAC,OAAO,EAAE,eAAe,CAAC,iBAAiB,CAAC,CAAC;IAEtF,MAAM,eAAe,GAAwB;QACzC,OAAO;QACP,MAAM;QACN,aAAa;QACb,aAAa;KAChB,CAAC;IAEF,OAAO,uBAAuB,CAAC,eAAe,CAAC,CAAC;AACpD,CAAC"}

package/esm/next/features/data/transformation.d.ts

@@ -0,0 +1,99 @@
+import { DataValue, IAttributeDescriptor, IResultHeader } from "@gooddata/sdk-model";
+import { DataViewFacade } from "@gooddata/sdk-ui";
+import { IPushpinCategoryLegendItem } from "@gooddata/sdk-ui-vis-commons";
+import { IAvailableLegends, IGeoData, IGeoLngLat } from "../../types/shared.js";
+/**
+ * Converts a data value to a float
+ *
+ * @param value - Data value from execution result
+ * @returns Parsed float value, or NaN if parsing fails
+ *
+ * @internal
+ */
+export declare function dataValueAsFloat(value: DataValue): number;
+/**
+ * Parses a location string in "lat;lng" format into coordinates
+ *
+ * @param latlng - Location string in "latitude;longitude" format
+ * @returns Coordinate object or null if invalid
+ *
+ * @internal
+ */
+export declare function getLocation(latlng: string | null): IGeoLngLat | null;
+/**
+ * Parses a coordinate string into a number
+ *
+ * @param coordinate - Coordinate string
+ * @returns Parsed number or null if invalid
+ *
+ * @internal
+ */
+export declare function parseCoordinate(coordinate: string | null): number | null;
+/**
+ * Transforms data view into geo data structure
+ *
+ * @remarks
+ * This is the main data transformation function that extracts and structures
+ * all geo-related data from the execution result
+ *
+ * @param dv - Data view facade
+ * @param emptyHeaderString - String to use for empty headers
+ * @param nullHeaderString - String to use for null headers
+ * @returns Structured geo data
+ *
+ * @internal
+ */
+export declare function getGeoData(dv: DataViewFacade, emptyHeaderString: string, nullHeaderString: string): IGeoData;
+/**
+ * Determines which legends should be available based on data
+ *
+ * @remarks
+ * Analyzes geo data to determine which legend types are applicable:
+ * - Category legend: When segments exist
+ * - Color legend: When color measure exists with varying values
+ * - Size legend: When size measure exists with varying values
+ *
+ * @param categoryItems - Category legend items
+ * @param geoData - Geo data structure
+ * @returns Object indicating which legends are available
+ *
+ * @internal
+ */
+export declare function getAvailableLegends(categoryItems: IPushpinCategoryLegendItem[], geoData: IGeoData): IAvailableLegends;
+/**
+ * Parses GeoJSON properties from feature
+ *
+ * @remarks
+ * Extracts and parses location, color, size, and segment properties from GeoJSON feature
+ *
+ * @param properties - GeoJSON properties object
+ * @returns Parsed properties object
+ *
+ * @internal
+ */
+export declare function parseGeoProperties(properties: GeoJSON.GeoJsonProperties): GeoJSON.GeoJsonProperties;
+/**
+ * Attribute information with header items
+ */
+export type AttributeInfo = IAttributeDescriptor["attributeHeader"] & {
+    items: IResultHeader[];
+};
+/**
+ * Geo attributes in dimension
+ */
+export interface IGeoAttributesInDimension {
+    locationAttribute: AttributeInfo;
+    segmentByAttribute: AttributeInfo | undefined;
+    tooltipTextAttribute: AttributeInfo | undefined;
+}
+/**
+ * Finds geo attributes in the data view dimension
+ *
+ * @param dv - Data view facade
+ * @param geoData - Geo data structure
+ * @returns Geo attributes information
+ *
+ * @internal
+ */
+export declare function findGeoAttributesInDimension(dv: DataViewFacade, geoData: IGeoData): IGeoAttributesInDimension;
+//# sourceMappingURL=transformation.d.ts.map

package/esm/next/features/data/transformation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformation.d.ts","sourceRoot":"","sources":["../../../../src/next/features/data/transformation.ts"],"names":[],"mappings":"AAEA,OAAO,EACH,SAAS,EACT,oBAAoB,EAGpB,aAAa,EAWhB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAe,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAE1E,OAAO,EACH,iBAAiB,EAEjB,QAAQ,EACR,UAAU,EAIb,MAAM,uBAAuB,CAAC;AA0C/B;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAWzD;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,UAAU,GAAG,IAAI,CAepE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAYxE;AAuLD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CACtB,EAAE,EAAE,cAAc,EAClB,iBAAiB,EAAE,MAAM,EACzB,gBAAgB,EAAE,MAAM,GACzB,QAAQ,CA6EV;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAC/B,aAAa,EAAE,0BAA0B,EAAE,EAC3C,OAAO,EAAE,QAAQ,GAClB,iBAAiB,CAenB;AAaD;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,OAAO,CAAC,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAQnG;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,oBAAoB,CAAC,iBAAiB,CAAC,GAAG;IAClE,KAAK,EAAE,aAAa,EAAE,CAAC;CAC1B,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACtC,iBAAiB,EAAE,aAAa,CAAC;IACjC,kBAAkB,EAAE,aAAa,GAAG,SAAS,CAAC;IAC9C,oBAAoB,EAAE,aAAa,GAAG,SAAS,CAAC;CACnD;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CACxC,EAAE,EAAE,cAAc,EAClB,OAAO,EAAE,QAAQ,GAClB,yBAAyB,CAkC3B"}