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

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

@@ -0,0 +1,369 @@
+// (C) 2025 GoodData Corporation
+import { attributeDisplayFormRef, attributeLocalId, isAttribute, isIdentifierRef, isResultAttributeHeader, measureItem, measureLocalId, resultHeaderName, } from "@gooddata/sdk-model";
+import { BucketNames } from "@gooddata/sdk-ui";
+import { getMinMax } from "../size/calculations.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 function dataValueAsFloat(value) {
+    if (value === null) {
+        return NaN;
+    }
+    const parsedNumber = typeof value === "string" ? parseFloat(value) : value;
+    if (isNaN(parsedNumber)) {
+        console.warn(`SDK: dataValueAsFloat: ${value} is not a number`);
+    }
+    return parsedNumber;
+}
+/**
+ * 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 function getLocation(latlng) {
+    if (!latlng) {
+        return null;
+    }
+    const [latitude, longitude] = latlng.split(";").map(dataValueAsFloat);
+    if (isNaN(latitude) || isNaN(longitude)) {
+        console.warn("GeoPushpinChartNext: Invalid location format", latlng);
+        return null;
+    }
+    return {
+        lat: latitude,
+        lng: longitude,
+    };
+}
+/**
+ * Parses a coordinate string into a number
+ *
+ * @param coordinate - Coordinate string
+ * @returns Parsed number or null if invalid
+ *
+ * @internal
+ */
+export function parseCoordinate(coordinate) {
+    if (!coordinate) {
+        return null;
+    }
+    const numericalCoordinate = dataValueAsFloat(coordinate);
+    if (isNaN(numericalCoordinate)) {
+        console.warn("GeoPushpinChartNext: Invalid coordinate", coordinate);
+        return null;
+    }
+    return numericalCoordinate;
+}
+/**
+ * Gets attribute header items from data view for geo data
+ *
+ * @internal
+ */
+function getGeoAttributeHeaderItems(dv, geoData) {
+    const { color, size } = geoData;
+    const hasColorMeasure = color !== undefined;
+    const hasSizeMeasure = size !== undefined;
+    const attrHeaderItemIndex = hasColorMeasure || hasSizeMeasure ? 1 : 0;
+    return dv.meta().allHeaders()[attrHeaderItemIndex];
+}
+/**
+ * Gets format string from execution response for a measure
+ *
+ * @internal
+ */
+function getFormatFromExecutionResponse(dv, indexMeasure) {
+    const measureDescriptors = dv.meta().measureDescriptors();
+    return measureDescriptors[indexMeasure].measureHeaderItem.format;
+}
+/**
+ * Extracts segment data and URIs from attribute header items
+ */
+function getSegmentDataAndUris(attributeHeaderItems, dataIndex, nullHeaderString) {
+    const headerItems = attributeHeaderItems[dataIndex];
+    return headerItems.reduce((result, headerItem) => {
+        if (headerItem && isResultAttributeHeader(headerItem)) {
+            const { uri, name } = headerItem.attributeHeaderItem;
+            return { uris: [...result.uris, uri], data: [...result.data, name ?? nullHeaderString] };
+        }
+        return result;
+    }, { uris: [], data: [] });
+}
+/**
+ * Extracts measure data from data view
+ */
+function getMeasureData(dv, dataIndex) {
+    const twoDimData = dv.rawData().twoDimData();
+    const measureValues = twoDimData[dataIndex];
+    return measureValues.map(dataValueAsFloat);
+}
+/**
+ * Extracts attribute data from attribute header items
+ */
+function getAttributeData(attributeHeaderItems, dataIndex, emptyHeaderString, nullHeaderString) {
+    const headerItems = attributeHeaderItems[dataIndex];
+    return headerItems.map((i) => {
+        const name = resultHeaderName(i);
+        if (name) {
+            return name;
+        }
+        return name === "" ? emptyHeaderString : nullHeaderString;
+    });
+}
+/**
+ * Gets URI and identifier from object reference
+ */
+function getUriAndIdentifier(ref) {
+    if (isIdentifierRef(ref)) {
+        return { identifier: ref.identifier };
+    }
+    else {
+        return { uri: ref.uri };
+    }
+}
+/**
+ * Extracts bucket item information
+ */
+function getBucketItemInfo(bucketItem) {
+    if (!bucketItem) {
+        return null;
+    }
+    // Attribute item
+    if (isAttribute(bucketItem)) {
+        const localIdentifier = attributeLocalId(bucketItem);
+        const displayFormRef = attributeDisplayFormRef(bucketItem);
+        return {
+            localIdentifier,
+            ...getUriAndIdentifier(displayFormRef),
+        };
+    }
+    // Measure item
+    const localIdentifier = measureLocalId(bucketItem);
+    const measureItemRef = measureItem(bucketItem);
+    if (measureItemRef) {
+        return {
+            localIdentifier,
+            ...getUriAndIdentifier(measureItemRef),
+        };
+    }
+    // Non-simple-measures land here
+    return { localIdentifier };
+}
+/**
+ * Gets bucket item names and data indices from data view
+ */
+function getBucketItemNameAndDataIndex(dv) {
+    const buckets = dv.def().buckets();
+    const measureDescriptors = dv.meta().measureDescriptors();
+    const attributeDescriptors = dv.meta().attributeDescriptors();
+    const bucketItemInfos = buckets.reduce((result, bucket) => {
+        result[bucket.localIdentifier] = getBucketItemInfo(bucket.items[0]);
+        return result;
+    }, {});
+    const result = {};
+    // Process attribute buckets
+    [
+        BucketNames.LOCATION,
+        BucketNames.LATITUDE,
+        BucketNames.LONGITUDE,
+        BucketNames.SEGMENT,
+        BucketNames.TOOLTIP_TEXT,
+    ].forEach((bucketName) => {
+        const bucketItemInfo = bucketItemInfos[bucketName];
+        if (!bucketItemInfo) {
+            return;
+        }
+        const index = attributeDescriptors.findIndex((desc) => desc.attributeHeader.localIdentifier === bucketItemInfo.localIdentifier &&
+            (desc.attributeHeader.uri === bucketItemInfo.uri ||
+                desc.attributeHeader.identifier === bucketItemInfo.identifier));
+        if (index !== -1) {
+            const { formOf: { name }, } = attributeDescriptors[index].attributeHeader;
+            result[bucketName] = { index, name };
+        }
+    });
+    // Process measure buckets
+    [BucketNames.SIZE, BucketNames.COLOR].forEach((bucketName) => {
+        const bucketItemInfo = bucketItemInfos[bucketName];
+        if (!bucketItemInfo) {
+            return;
+        }
+        const index = measureDescriptors.findIndex((desc) => desc.measureHeaderItem.localIdentifier === bucketItemInfo.localIdentifier &&
+            (desc.measureHeaderItem.uri === bucketItemInfo.uri ||
+                desc.measureHeaderItem.identifier === bucketItemInfo.identifier));
+        if (index !== -1) {
+            result[bucketName] = {
+                index,
+                name: measureDescriptors[index].measureHeaderItem.name,
+            };
+        }
+    });
+    return result;
+}
+/**
+ * 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 function getGeoData(dv, emptyHeaderString, nullHeaderString) {
+    const geoData = getBucketItemNameAndDataIndex(dv);
+    const attributeHeaderItems = getGeoAttributeHeaderItems(dv, geoData);
+    const locationIndex = geoData.location?.index;
+    const latitudeIndex = geoData.latitude?.index;
+    const longitudeIndex = geoData.longitude?.index;
+    const segmentIndex = geoData?.segment?.index;
+    const tooltipTextIndex = geoData?.tooltipText?.index;
+    const sizeIndex = geoData?.size?.index;
+    const colorIndex = geoData?.color?.index;
+    // Process location data (single attribute mode)
+    if (locationIndex !== undefined) {
+        const locationData = getAttributeData(attributeHeaderItems, locationIndex, emptyHeaderString, nullHeaderString);
+        geoData[BucketNames.LOCATION].data = locationData.map(getLocation);
+    }
+    // Process latitude/longitude data (two attribute mode)
+    if (latitudeIndex !== undefined && longitudeIndex !== undefined) {
+        const latitudeData = getAttributeData(attributeHeaderItems, latitudeIndex, emptyHeaderString, nullHeaderString);
+        const longitudeData = getAttributeData(attributeHeaderItems, longitudeIndex, emptyHeaderString, nullHeaderString);
+        geoData[BucketNames.LOCATION] = {
+            ...geoData[BucketNames.LATITUDE],
+            data: latitudeData.map((value, index) => ({
+                lat: parseCoordinate(value),
+                lng: parseCoordinate(longitudeData[index]),
+            })),
+        };
+    }
+    // Process segment data
+    if (segmentIndex !== undefined) {
+        const { data, uris } = getSegmentDataAndUris(attributeHeaderItems, segmentIndex, nullHeaderString);
+        geoData[BucketNames.SEGMENT].data = data;
+        geoData[BucketNames.SEGMENT].uris = uris;
+    }
+    // Process tooltip text data
+    if (tooltipTextIndex !== undefined) {
+        geoData[BucketNames.TOOLTIP_TEXT].data = getAttributeData(attributeHeaderItems, tooltipTextIndex, emptyHeaderString, nullHeaderString);
+    }
+    // Process size measure data
+    if (sizeIndex !== undefined) {
+        geoData[BucketNames.SIZE].data = getMeasureData(dv, sizeIndex);
+        geoData[BucketNames.SIZE].format = getFormatFromExecutionResponse(dv, sizeIndex);
+    }
+    // Process color measure data
+    if (colorIndex !== undefined) {
+        geoData[BucketNames.COLOR].data = getMeasureData(dv, colorIndex);
+        geoData[BucketNames.COLOR].format = getFormatFromExecutionResponse(dv, colorIndex);
+    }
+    return geoData;
+}
+/**
+ * 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 function getAvailableLegends(categoryItems, geoData) {
+    const { color: { data: colorData = [] } = {}, size: { data: sizeData = [] } = {} } = geoData;
+    const { min: minColor, max: maxColor } = getMinMax(colorData);
+    const { min: minSize, max: maxSize } = getMinMax(sizeData);
+    const hasCategoryLegend = Boolean(categoryItems?.length);
+    const hasColorLegend = Boolean(colorData.length) && minColor !== maxColor && !hasCategoryLegend;
+    const hasSizeLegend = Boolean(sizeData.length) && minSize !== maxSize;
+    return {
+        hasCategoryLegend,
+        hasColorLegend,
+        hasSizeLegend,
+    };
+}
+/**
+ * Parses a GeoJSON property item from JSON string
+ */
+function parseGeoPropertyItem(item) {
+    try {
+        return JSON.parse(item);
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * 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 function parseGeoProperties(properties) {
+    const { locationName = "{}", color = "{}", size = "{}", segment = "{}" } = properties || {};
+    return {
+        locationName: parseGeoPropertyItem(locationName),
+        size: parseGeoPropertyItem(size),
+        color: parseGeoPropertyItem(color),
+        segment: parseGeoPropertyItem(segment),
+    };
+}
+/**
+ * Finds geo attributes in the data view dimension
+ *
+ * @param dv - Data view facade
+ * @param geoData - Geo data structure
+ * @returns Geo attributes information
+ *
+ * @internal
+ */
+export function findGeoAttributesInDimension(dv, geoData) {
+    const { color, location, segment, size, tooltipText } = geoData;
+    const locationIndex = location?.index ?? 0;
+    const headers = dv.meta().allHeaders();
+    const hasMeasure = size || color;
+    const attrDimensionIndex = hasMeasure ? 1 : 0;
+    const attributeDescriptors = dv.meta().attributeDescriptors();
+    const attributeResultHeaderItems = headers[attrDimensionIndex];
+    const locationAttribute = {
+        ...attributeDescriptors[locationIndex].attributeHeader,
+        items: attributeResultHeaderItems[locationIndex],
+    };
+    const segmentByAttribute = segment?.data.length
+        ? {
+            ...attributeDescriptors[segment.index].attributeHeader,
+            items: attributeResultHeaderItems[segment.index],
+        }
+        : undefined;
+    const tooltipTextAttribute = tooltipText?.data.length
+        ? {
+            ...attributeDescriptors[tooltipText.index].attributeHeader,
+            items: attributeResultHeaderItems[tooltipText.index],
+        }
+        : undefined;
+    return {
+        locationAttribute,
+        segmentByAttribute,
+        tooltipTextAttribute,
+    };
+}
+//# sourceMappingURL=transformation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transformation.js","sourceRoot":"","sources":["../../../../src/next/features/data/transformation.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAEhC,OAAO,EAQH,uBAAuB,EACvB,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,uBAAuB,EACvB,WAAW,EACX,cAAc,EACd,gBAAgB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAkB,MAAM,kBAAkB,CAAC;AAY/D,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAyCpD;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAgB;IAC7C,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACjB,OAAO,GAAG,CAAC;IACf,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAE3E,IAAI,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,IAAI,CAAC,0BAA0B,KAAK,kBAAkB,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,YAAY,CAAC;AACxB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,MAAqB;IAC7C,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IACtE,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QACtC,OAAO,CAAC,IAAI,CAAC,8CAA8C,EAAE,MAAM,CAAC,CAAC;QACrE,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,OAAO;QACH,GAAG,EAAE,QAAQ;QACb,GAAG,EAAE,SAAS;KACjB,CAAC;AACN,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,UAAyB;IACrD,IAAI,CAAC,UAAU,EAAE,CAAC;QACd,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,MAAM,mBAAmB,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;IACzD,IAAI,KAAK,CAAC,mBAAmB,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,IAAI,CAAC,yCAAyC,EAAE,UAAU,CAAC,CAAC;QACpE,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,OAAO,mBAAmB,CAAC;AAC/B,CAAC;AAED;;;;GAIG;AACH,SAAS,0BAA0B,CAAC,EAAkB,EAAE,OAAiB;IACrE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IAChC,MAAM,eAAe,GAAG,KAAK,KAAK,SAAS,CAAC;IAC5C,MAAM,cAAc,GAAG,IAAI,KAAK,SAAS,CAAC;IAC1C,MAAM,mBAAmB,GAAG,eAAe,IAAI,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACtE,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,UAAU,EAAE,CAAC,mBAAmB,CAAC,CAAC;AACvD,CAAC;AAED;;;;GAIG;AACH,SAAS,8BAA8B,CAAC,EAAkB,EAAE,YAAoB;IAC5E,MAAM,kBAAkB,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,kBAAkB,EAAE,CAAC;IAC1D,OAAO,kBAAkB,CAAC,YAAY,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC;AACrE,CAAC;AAED;;GAEG;AACH,SAAS,qBAAqB,CAC1B,oBAAuC,EACvC,SAAiB,EACjB,gBAAwB;IAExB,MAAM,WAAW,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;IACpD,OAAO,WAAW,CAAC,MAAM,CACrB,CAAC,MAAoB,EAAE,UAAyB,EAAgB,EAAE;QAC9D,IAAI,UAAU,IAAI,uBAAuB,CAAC,UAAU,CAAC,EAAE,CAAC;YACpD,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,UAAU,CAAC,mBAAmB,CAAC;YACrD,OAAO,EAAE,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,IAAI,IAAI,gBAAgB,CAAC,EAAE,CAAC;QAC7F,CAAC;QACD,OAAO,MAAM,CAAC;IAClB,CAAC,EACD,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CACzB,CAAC;AACN,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,EAAkB,EAAE,SAAiB;IACzD,MAAM,UAAU,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,UAAU,EAAE,CAAC;IAC7C,MAAM,aAAa,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;IAC5C,OAAO,aAAa,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CACrB,oBAAuC,EACvC,SAAiB,EACjB,iBAAyB,EACzB,gBAAwB;IAExB,MAAM,WAAW,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;IACpD,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACzB,MAAM,IAAI,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;QACjC,IAAI,IAAI,EAAE,CAAC;YACP,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,gBAAgB,CAAC;IAC9D,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,GAAW;IACpC,IAAI,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC;IAC1C,CAAC;SAAM,CAAC;QACJ,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC;IAC5B,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,UAA+B;IACtD,IAAI,CAAC,UAAU,EAAE,CAAC;QACd,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,iBAAiB;IACjB,IAAI,WAAW,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1B,MAAM,eAAe,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;QACrD,MAAM,cAAc,GAAG,uBAAuB,CAAC,UAAU,CAAC,CAAC;QAC3D,OAAO;YACH,eAAe;YACf,GAAG,mBAAmB,CAAC,cAAc,CAAC;SACzC,CAAC;IACN,CAAC;IAED,eAAe;IACf,MAAM,eAAe,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IACnD,MAAM,cAAc,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;IAE/C,IAAI,cAAc,EAAE,CAAC;QACjB,OAAO;YACH,eAAe;YACf,GAAG,mBAAmB,CAAC,cAAc,CAAC;SACzC,CAAC;IACN,CAAC;IAED,gCAAgC;IAChC,OAAO,EAAE,eAAe,EAAE,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,SAAS,6BAA6B,CAAC,EAAkB;IACrD,MAAM,OAAO,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;IACnC,MAAM,kBAAkB,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,kBAAkB,EAAE,CAAC;IAC1D,MAAM,oBAAoB,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,oBAAoB,EAAE,CAAC;IAE9D,MAAM,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,MAAmB,EAAE,MAAM,EAAE,EAAE;QACnE,MAAM,CAAC,MAAM,CAAC,eAAgB,CAAC,GAAG,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACrE,OAAO,MAAM,CAAC;IAClB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,MAAM,GAAmB,EAAE,CAAC;IAElC,4BAA4B;IAC5B;QACI,WAAW,CAAC,QAAQ;QACpB,WAAW,CAAC,QAAQ;QACpB,WAAW,CAAC,SAAS;QACrB,WAAW,CAAC,OAAO;QACnB,WAAW,CAAC,YAAY;KAC3B,CAAC,OAAO,CAAC,CAAC,UAAU,EAAQ,EAAE;QAC3B,MAAM,cAAc,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;QACnD,IAAI,CAAC,cAAc,EAAE,CAAC;YAClB,OAAO;QACX,CAAC;QACD,MAAM,KAAK,GAAG,oBAAoB,CAAC,SAAS,CACxC,CAAC,IAA0B,EAAW,EAAE,CACpC,IAAI,CAAC,eAAe,CAAC,eAAe,KAAK,cAAc,CAAC,eAAe;YACvE,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,KAAK,cAAc,CAAC,GAAG;gBAC5C,IAAI,CAAC,eAAe,CAAC,UAAU,KAAK,cAAc,CAAC,UAAU,CAAC,CACzE,CAAC;QAEF,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;YACf,MAAM,EACF,MAAM,EAAE,EAAE,IAAI,EAAE,GACnB,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC,eAAe,CAAC;YAChD,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QACzC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,0BAA0B;IAC1B,CAAC,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,EAAQ,EAAE;QAC/D,MAAM,cAAc,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;QACnD,IAAI,CAAC,cAAc,EAAE,CAAC;YAClB,OAAO;QACX,CAAC;QACD,MAAM,KAAK,GAAG,kBAAkB,CAAC,SAAS,CACtC,CAAC,IAAwB,EAAW,EAAE,CAClC,IAAI,CAAC,iBAAiB,CAAC,eAAe,KAAK,cAAc,CAAC,eAAe;YACzE,CAAC,IAAI,CAAC,iBAAiB,CAAC,GAAG,KAAK,cAAc,CAAC,GAAG;gBAC9C,IAAI,CAAC,iBAAiB,CAAC,UAAU,KAAK,cAAc,CAAC,UAAU,CAAC,CAC3E,CAAC;QACF,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;YACf,MAAM,CAAC,UAAU,CAAC,GAAG;gBACjB,KAAK;gBACL,IAAI,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC,iBAAiB,CAAC,IAAI;aACzD,CAAC;QACN,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAClB,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,UAAU,CACtB,EAAkB,EAClB,iBAAyB,EACzB,gBAAwB;IAExB,MAAM,OAAO,GAAG,6BAA6B,CAAC,EAAE,CAAC,CAAC;IAClD,MAAM,oBAAoB,GAAG,0BAA0B,CAAC,EAAE,EAAE,OAAmB,CAAC,CAAC;IAEjF,MAAM,aAAa,GAAG,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC;IAC9C,MAAM,aAAa,GAAG,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC;IAC9C,MAAM,cAAc,GAAG,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC;IAChD,MAAM,YAAY,GAAG,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC;IAC7C,MAAM,gBAAgB,GAAG,OAAO,EAAE,WAAW,EAAE,KAAK,CAAC;IACrD,MAAM,SAAS,GAAG,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC;IACvC,MAAM,UAAU,GAAG,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC;IAEzC,gDAAgD;IAChD,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,YAAY,GAAG,gBAAgB,CACjC,oBAAoB,EACpB,aAAa,EACb,iBAAiB,EACjB,gBAAgB,CACnB,CAAC;QACF,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAE,CAAC,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,WAAW,CAAiB,CAAC;IACxF,CAAC;IAED,uDAAuD;IACvD,IAAI,aAAa,KAAK,SAAS,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;QAC9D,MAAM,YAAY,GAAG,gBAAgB,CACjC,oBAAoB,EACpB,aAAa,EACb,iBAAiB,EACjB,gBAAgB,CACnB,CAAC;QACF,MAAM,aAAa,GAAG,gBAAgB,CAClC,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,CACnB,CAAC;QAEF,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG;YAC5B,GAAG,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAE;YACjC,IAAI,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;gBACtC,GAAG,EAAE,eAAe,CAAC,KAAK,CAAC;gBAC3B,GAAG,EAAE,eAAe,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;aAC7C,CAAC,CAAiB;SACtB,CAAC;IACN,CAAC;IAED,uBAAuB;IACvB,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,qBAAqB,CAAC,oBAAoB,EAAE,YAAY,EAAE,gBAAgB,CAAC,CAAC;QACnG,OAAO,CAAC,WAAW,CAAC,OAAO,CAAE,CAAC,IAAI,GAAG,IAAI,CAAC;QAC1C,OAAO,CAAC,WAAW,CAAC,OAAO,CAAE,CAAC,IAAI,GAAG,IAAI,CAAC;IAC9C,CAAC;IAED,4BAA4B;IAC5B,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,CAAC,WAAW,CAAC,YAAY,CAAE,CAAC,IAAI,GAAG,gBAAgB,CACtD,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,CACnB,CAAC;IACN,CAAC;IAED,4BAA4B;IAC5B,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,CAAC,WAAW,CAAC,IAAI,CAAE,CAAC,IAAI,GAAG,cAAc,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QAChE,OAAO,CAAC,WAAW,CAAC,IAAI,CAAE,CAAC,MAAM,GAAG,8BAA8B,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;IACtF,CAAC;IAED,6BAA6B;IAC7B,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,CAAC,WAAW,CAAC,KAAK,CAAE,CAAC,IAAI,GAAG,cAAc,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QAClE,OAAO,CAAC,WAAW,CAAC,KAAK,CAAE,CAAC,MAAM,GAAG,8BAA8B,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IACxF,CAAC;IAED,OAAO,OAAmB,CAAC;AAC/B,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,mBAAmB,CAC/B,aAA2C,EAC3C,OAAiB;IAEjB,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,GAAG,EAAE,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,GAAG,EAAE,EAAE,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IAE7F,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;IAC9D,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAE3D,MAAM,iBAAiB,GAAG,OAAO,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IACzD,MAAM,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,QAAQ,KAAK,QAAQ,IAAI,CAAC,iBAAiB,CAAC;IAChG,MAAM,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,OAAO,KAAK,OAAO,CAAC;IAEtE,OAAO;QACH,iBAAiB;QACjB,cAAc;QACd,aAAa;KAChB,CAAC;AACN,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAAC,IAAY;IACtC,IAAI,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,EAAE,CAAC;IACd,CAAC;AACL,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAqC;IACpE,MAAM,EAAE,YAAY,GAAG,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,OAAO,GAAG,IAAI,EAAE,GAAG,UAAU,IAAI,EAAE,CAAC;IAC5F,OAAO;QACH,YAAY,EAAE,oBAAoB,CAAC,YAAY,CAAC;QAChD,IAAI,EAAE,oBAAoB,CAAC,IAAI,CAAC;QAChC,KAAK,EAAE,oBAAoB,CAAC,KAAK,CAAC;QAClC,OAAO,EAAE,oBAAoB,CAAC,OAAO,CAAC;KACzC,CAAC;AACN,CAAC;AAkBD;;;;;;;;GAQG;AACH,MAAM,UAAU,4BAA4B,CACxC,EAAkB,EAClB,OAAiB;IAEjB,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAChE,MAAM,aAAa,GAAG,QAAQ,EAAE,KAAK,IAAI,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,UAAU,EAAE,CAAC;IAEvC,MAAM,UAAU,GAAG,IAAI,IAAI,KAAK,CAAC;IACjC,MAAM,kBAAkB,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,MAAM,oBAAoB,GAA2B,EAAE,CAAC,IAAI,EAAE,CAAC,oBAAoB,EAAE,CAAC;IACtF,MAAM,0BAA0B,GAAsB,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAElF,MAAM,iBAAiB,GAAkB;QACrC,GAAG,oBAAoB,CAAC,aAAa,CAAC,CAAC,eAAe;QACtD,KAAK,EAAE,0BAA0B,CAAC,aAAa,CAAC;KACnD,CAAC;IAEF,MAAM,kBAAkB,GAA8B,OAAO,EAAE,IAAI,CAAC,MAAM;QACtE,CAAC,CAAC;YACI,GAAG,oBAAoB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,eAAe;YACtD,KAAK,EAAE,0BAA0B,CAAC,OAAO,CAAC,KAAK,CAAC;SACnD;QACH,CAAC,CAAC,SAAS,CAAC;IAEhB,MAAM,oBAAoB,GAA8B,WAAW,EAAE,IAAI,CAAC,MAAM;QAC5E,CAAC,CAAC;YACI,GAAG,oBAAoB,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,eAAe;YAC1D,KAAK,EAAE,0BAA0B,CAAC,WAAW,CAAC,KAAK,CAAC;SACvD;QACH,CAAC,CAAC,SAAS,CAAC;IAEhB,OAAO;QACH,iBAAiB;QACjB,kBAAkB;QAClB,oBAAoB;KACvB,CAAC;AACN,CAAC"}

package/esm/next/features/map/initializeMap.d.ts

@@ -0,0 +1,30 @@
+import type { Map as MapLibreMap, Popup } from "maplibre-gl";
+import { IMapOptions } from "../../types/mapProvider.js";
+import { IMapLibreLocale } from "../../utils/mapLocale.js";
+/**
+ * Result of map initialization
+ *
+ * @internal
+ */
+export interface IMapInitResult {
+    map: MapLibreMap;
+    tooltip: Popup;
+    maplibregl: typeof import("maplibre-gl");
+}
+/**
+ * Initialize MapLibre GL map instance with options
+ *
+ * @remarks
+ * This function handles the creation of a MapLibre GL map instance with all necessary
+ * configuration. It dynamically imports maplibre-gl to avoid bundling issues, sets up
+ * the map with safe default options, and ensures glyphs are properly configured for
+ * text rendering.
+ *
+ * @param options - Map initialization options including container, center, zoom, bounds, etc.
+ * @param locale - Optional MapLibre locale configuration for cooperative gestures
+ * @returns Promise resolving to map instance, tooltip, and maplibre-gl module
+ *
+ * @internal
+ */
+export declare function initializeMapLibreMap({ container, center, zoom, bounds, interactive, cooperativeGestures, style }: IMapOptions, locale?: IMapLibreLocale): Promise<IMapInitResult>;
+//# sourceMappingURL=initializeMap.d.ts.map

package/esm/next/features/map/initializeMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initializeMap.d.ts","sourceRoot":"","sources":["../../../../src/next/features/map/initializeMap.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAgC,GAAG,IAAI,WAAW,EAAc,KAAK,EAAE,MAAM,aAAa,CAAC;AAMvG,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC3B,GAAG,EAAE,WAAW,CAAC;IACjB,OAAO,EAAE,KAAK,CAAC;IACf,UAAU,EAAE,cAAc,aAAa,CAAC,CAAC;CAC5C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,qBAAqB,CACvC,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAkB,EAAE,mBAA0B,EAAE,KAAK,EAAE,EAAE,WAAW,EACvG,MAAM,CAAC,EAAE,eAAe,GACzB,OAAO,CAAC,cAAc,CAAC,CA8CzB"}

package/esm/next/features/map/initializeMap.js

@@ -0,0 +1,58 @@
+// (C) 2025 GoodData Corporation
+import { DEFAULT_MAPLIBRE_OPTIONS, DEFAULT_TOOLTIP_OPTIONS, } from "../../providers/maplibre/maplibreConfig.js";
+/**
+ * Initialize MapLibre GL map instance with options
+ *
+ * @remarks
+ * This function handles the creation of a MapLibre GL map instance with all necessary
+ * configuration. It dynamically imports maplibre-gl to avoid bundling issues, sets up
+ * the map with safe default options, and ensures glyphs are properly configured for
+ * text rendering.
+ *
+ * @param options - Map initialization options including container, center, zoom, bounds, etc.
+ * @param locale - Optional MapLibre locale configuration for cooperative gestures
+ * @returns Promise resolving to map instance, tooltip, and maplibre-gl module
+ *
+ * @internal
+ */
+export async function initializeMapLibreMap({ container, center, zoom, bounds, interactive = true, cooperativeGestures = true, style }, locale) {
+    // Dynamically import maplibre-gl to avoid bundling issues
+    const maplibregl = await import("maplibre-gl");
+    let styleSpecification = style;
+    if (!styleSpecification) {
+        const { createStyleSpecification } = await import("../../providers/maplibre/style.js");
+        styleSpecification = createStyleSpecification(window.location.origin);
+    }
+    const mapOptions = {
+        ...DEFAULT_MAPLIBRE_OPTIONS,
+        style: styleSpecification,
+        container,
+        interactive,
+        cooperativeGestures,
+        ...(cooperativeGestures && locale ? { locale } : {}),
+    };
+    if (bounds) {
+        mapOptions.bounds = [
+            [bounds.southWest.lng, bounds.southWest.lat],
+            [bounds.northEast.lng, bounds.northEast.lat],
+        ];
+    }
+    else if (center) {
+        mapOptions.center = [center.lng, center.lat];
+    }
+    else if (zoom) {
+        mapOptions.zoom = zoom;
+    }
+    const map = new maplibregl.Map(mapOptions);
+    const tooltip = new maplibregl.Popup(DEFAULT_TOOLTIP_OPTIONS);
+    return new Promise((resolve, reject) => {
+        map.on("load", () => {
+            resolve({ map, tooltip, maplibregl });
+        });
+        map.on("error", (e) => {
+            console.error("[initializeMapLibreMap] Map error", e);
+            reject(new Error(`MapLibre initialization error: ${e?.error?.message ?? "Unknown error"}`));
+        });
+    });
+}
+//# sourceMappingURL=initializeMap.js.map

package/esm/next/features/map/initializeMap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"initializeMap.js","sourceRoot":"","sources":["../../../../src/next/features/map/initializeMap.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAIhC,OAAO,EACH,wBAAwB,EACxB,uBAAuB,GAC1B,MAAM,4CAA4C,CAAC;AAepD;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACvC,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,EAAE,mBAAmB,GAAG,IAAI,EAAE,KAAK,EAAe,EACvG,MAAwB;IAExB,0DAA0D;IAC1D,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IAC/C,IAAI,kBAAkB,GAAG,KAAK,CAAC;IAC/B,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACtB,MAAM,EAAE,wBAAwB,EAAE,GAAG,MAAM,MAAM,CAAC,mCAAmC,CAAC,CAAC;QACvF,kBAAkB,GAAG,wBAAwB,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC1E,CAAC;IAED,MAAM,UAAU,GAAe;QAC3B,GAAG,wBAAwB;QAC3B,KAAK,EAAE,kBAAkB;QACzB,SAAS;QACT,WAAW;QACX,mBAAmB;QACnB,GAAG,CAAC,mBAAmB,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvD,CAAC;IAEF,IAAI,MAAM,EAAE,CAAC;QACT,UAAU,CAAC,MAAM,GAAG;YAChB,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC;YAC5C,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC;SAC3B,CAAC;IAC1B,CAAC;SAAM,IAAI,MAAM,EAAE,CAAC;QAChB,UAAU,CAAC,MAAM,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,CAAe,CAAC;IAC/D,CAAC;SAAM,IAAI,IAAI,EAAE,CAAC;QACd,UAAU,CAAC,IAAI,GAAG,IAAI,CAAC;IAC3B,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAE9D,OAAO,IAAI,OAAO,CAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACnD,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;YAChB,OAAO,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAU,EAAE,EAAE;YAC3B,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,CAAC,CAAC,CAAC;YACtD,MAAM,CACF,IAAI,KAAK,CACL,kCAAmC,CAAsC,EAAE,KAAK,EAAE,OAAO,IAAI,eAAe,EAAE,CACjH,CACJ,CAAC;QACN,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC"}

package/esm/next/features/map/layerManagement.d.ts

@@ -0,0 +1,51 @@
+import type { Map as MapLibreMap } from "maplibre-gl";
+import { IColorStrategy } from "@gooddata/sdk-ui-vis-commons";
+import { IMapConfig } from "../../types/mapProvider.js";
+import { IGeoData } from "../../types/shared.js";
+/**
+ * Add pushpin layers to the map
+ *
+ * @remarks
+ * This function adds the appropriate layers for displaying pushpin data on the map.
+ * If clustering is enabled, it adds cluster layers (cluster points, cluster labels, and
+ * unclustered points). Otherwise, it adds a single pushpin layer, attempting to insert
+ * it before state labels if they exist for better visual hierarchy.
+ *
+ * @param map - MapLibre map instance
+ * @param dataSourceId - ID of the data source to use
+ * @param geoData - Geographic data to display
+ * @param config - Map configuration
+ * @param hasClustering - Whether clustering is enabled
+ *
+ * @internal
+ */
+export declare function addPushpinLayers(map: MapLibreMap, dataSourceId: string, geoData: IGeoData, config: IMapConfig, hasClustering: boolean): void;
+/**
+ * Remove all geo-related layers from the map
+ *
+ * @remarks
+ * This function removes all pushpin and cluster layers along with their data source.
+ * It's typically called before updating the map with new data.
+ *
+ * @param map - MapLibre map instance
+ *
+ * @internal
+ */
+export declare function removeGeoLayers(map: MapLibreMap): void;
+/**
+ * Add data source and layers to the map
+ *
+ * @remarks
+ * This function combines data source creation and layer addition into a single
+ * operation. It removes any existing layers/source first, then creates a new
+ * data source and adds the appropriate layers based on clustering configuration.
+ *
+ * @param map - MapLibre map instance
+ * @param geoData - Geographic data to display
+ * @param config - Map configuration
+ * @param colorStrategy - Color strategy for styling
+ *
+ * @internal
+ */
+export declare function updateMapLayers(map: MapLibreMap, geoData: IGeoData, config: IMapConfig, colorStrategy: IColorStrategy): void;
+//# sourceMappingURL=layerManagement.d.ts.map

package/esm/next/features/map/layerManagement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layerManagement.d.ts","sourceRoot":"","sources":["../../../../src/next/features/map/layerManagement.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,IAAI,WAAW,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAa9D,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAIjD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAC5B,GAAG,EAAE,WAAW,EAChB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,QAAQ,EACjB,MAAM,EAAE,UAAU,EAClB,aAAa,EAAE,OAAO,GACvB,IAAI,CAgBN;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAYtD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAC3B,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,QAAQ,EACjB,MAAM,EAAE,UAAU,EAClB,aAAa,EAAE,cAAc,GAC9B,IAAI,CAoBN"}

package/esm/next/features/map/layerManagement.js

@@ -0,0 +1,95 @@
+// (C) 2025 GoodData Corporation
+import { DEFAULT_CLUSTER_LAYER_NAME, DEFAULT_DATA_SOURCE_NAME, DEFAULT_LAYER_NAME, } from "../../constants/geoChart.js";
+import { createClusterLabels, createClusterPoints, createPushpinDataLayer, createUnclusterPoints, } from "../../providers/maplibre/maplibreDataLayers.js";
+import { isClusteringAllowed } from "../clustering/clustering.js";
+import { createGeoDataSource } from "../data/dataSourceManagement.js";
+/**
+ * Add pushpin layers to the map
+ *
+ * @remarks
+ * This function adds the appropriate layers for displaying pushpin data on the map.
+ * If clustering is enabled, it adds cluster layers (cluster points, cluster labels, and
+ * unclustered points). Otherwise, it adds a single pushpin layer, attempting to insert
+ * it before state labels if they exist for better visual hierarchy.
+ *
+ * @param map - MapLibre map instance
+ * @param dataSourceId - ID of the data source to use
+ * @param geoData - Geographic data to display
+ * @param config - Map configuration
+ * @param hasClustering - Whether clustering is enabled
+ *
+ * @internal
+ */
+export function addPushpinLayers(map, dataSourceId, geoData, config, hasClustering) {
+    if (hasClustering) {
+        map.addLayer(createClusterPoints(dataSourceId));
+        map.addLayer(createClusterLabels(dataSourceId));
+        map.addLayer(createUnclusterPoints(dataSourceId));
+    }
+    else {
+        // Try to add layer before state labels if they exist, otherwise add on top
+        const layerToInsertBefore = "state-label";
+        const beforeLayerExists = map.getLayer(layerToInsertBefore);
+        if (beforeLayerExists) {
+            map.addLayer(createPushpinDataLayer(dataSourceId, geoData, config), layerToInsertBefore);
+        }
+        else {
+            map.addLayer(createPushpinDataLayer(dataSourceId, geoData, config));
+        }
+    }
+}
+/**
+ * Remove all geo-related layers from the map
+ *
+ * @remarks
+ * This function removes all pushpin and cluster layers along with their data source.
+ * It's typically called before updating the map with new data.
+ *
+ * @param map - MapLibre map instance
+ *
+ * @internal
+ */
+export function removeGeoLayers(map) {
+    const layersToRemove = [DEFAULT_LAYER_NAME, DEFAULT_CLUSTER_LAYER_NAME, "gdcClusterLabels"];
+    layersToRemove.forEach((layerId) => {
+        if (map.getLayer(layerId)) {
+            map.removeLayer(layerId);
+        }
+    });
+    if (map.getSource(DEFAULT_DATA_SOURCE_NAME)) {
+        map.removeSource(DEFAULT_DATA_SOURCE_NAME);
+    }
+}
+/**
+ * Add data source and layers to the map
+ *
+ * @remarks
+ * This function combines data source creation and layer addition into a single
+ * operation. It removes any existing layers/source first, then creates a new
+ * data source and adds the appropriate layers based on clustering configuration.
+ *
+ * @param map - MapLibre map instance
+ * @param geoData - Geographic data to display
+ * @param config - Map configuration
+ * @param colorStrategy - Color strategy for styling
+ *
+ * @internal
+ */
+export function updateMapLayers(map, geoData, config, colorStrategy) {
+    if (!map.isStyleLoaded()) {
+        void map.once("styledata", () => {
+            updateMapLayers(map, geoData, config, colorStrategy);
+        });
+        return;
+    }
+    const { points: geoPointsConfig = {} } = config;
+    const hasClustering = isClusteringAllowed(geoData, geoPointsConfig.groupNearbyPoints);
+    // Remove existing layers and source
+    removeGeoLayers(map);
+    // Create and add new data source using data management utility
+    const source = createGeoDataSource(geoData, colorStrategy, config);
+    map.addSource(DEFAULT_DATA_SOURCE_NAME, source);
+    // Add layers
+    addPushpinLayers(map, DEFAULT_DATA_SOURCE_NAME, geoData, config, hasClustering);
+}
+//# sourceMappingURL=layerManagement.js.map

package/esm/next/features/map/layerManagement.js.map

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