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

package/esm/next/hooks/legend/useSelectedSegments.d.ts

@@ -0,0 +1,17 @@
+import { IPushpinCategoryLegendItem } from "@gooddata/sdk-ui-vis-commons";
+/**
+ * Hook to compute selected segment URIs from enabled legend items.
+ *
+ * @remarks
+ * This hook filters category legend items to only include visible ones,
+ * and returns their URIs for use in map filtering. If no legend items are
+ * provided or the enabled list is empty (meaning all are enabled), returns
+ * an empty array which signals "show all".
+ *
+ * @param categoryItems - All category legend items
+ * @returns Array of URIs for enabled segments (empty array means "show all")
+ *
+ * @alpha
+ */
+export declare function useSelectedSegments(categoryItems: IPushpinCategoryLegendItem[]): string[];
+//# sourceMappingURL=useSelectedSegments.d.ts.map

package/esm/next/hooks/legend/useSelectedSegments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSelectedSegments.d.ts","sourceRoot":"","sources":["../../../../src/next/hooks/legend/useSelectedSegments.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAI1E;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,0BAA0B,EAAE,GAAG,MAAM,EAAE,CAgBzF"}

package/esm/next/hooks/legend/useSelectedSegments.js

@@ -0,0 +1,32 @@
+// (C) 2025 GoodData Corporation
+import { useMemo } from "react";
+import { useGeoLegend } from "../../context/GeoLegendContext.js";
+/**
+ * Hook to compute selected segment URIs from enabled legend items.
+ *
+ * @remarks
+ * This hook filters category legend items to only include visible ones,
+ * and returns their URIs for use in map filtering. If no legend items are
+ * provided or the enabled list is empty (meaning all are enabled), returns
+ * an empty array which signals "show all".
+ *
+ * @param categoryItems - All category legend items
+ * @returns Array of URIs for enabled segments (empty array means "show all")
+ *
+ * @alpha
+ */
+export function useSelectedSegments(categoryItems) {
+    const { enabledLegendItems } = useGeoLegend();
+    return useMemo(() => {
+        if (!categoryItems.length) {
+            return [];
+        }
+        // If no items are explicitly enabled, show all
+        if (enabledLegendItems.length === 0) {
+            return [];
+        }
+        // Filter to only enabled items
+        return categoryItems.filter((item) => enabledLegendItems.includes(item.uri)).map((item) => item.uri);
+    }, [categoryItems, enabledLegendItems]);
+}
+//# sourceMappingURL=useSelectedSegments.js.map

package/esm/next/hooks/legend/useSelectedSegments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSelectedSegments.js","sourceRoot":"","sources":["../../../../src/next/hooks/legend/useSelectedSegments.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAEhC,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAIhC,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAEjE;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,mBAAmB,CAAC,aAA2C;IAC3E,MAAM,EAAE,kBAAkB,EAAE,GAAG,YAAY,EAAE,CAAC;IAE9C,OAAO,OAAO,CAAC,GAAG,EAAE;QAChB,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC;YACxB,OAAO,EAAE,CAAC;QACd,CAAC;QAED,+CAA+C;QAC/C,IAAI,kBAAkB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClC,OAAO,EAAE,CAAC;QACd,CAAC;QAED,+BAA+B;QAC/B,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,kBAAkB,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzG,CAAC,EAAE,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAAC,CAAC;AAC5C,CAAC"}

package/esm/next/hooks/map/useAfterRender.d.ts

@@ -0,0 +1,19 @@
+import type { Map as MapLibreMap } from "maplibre-gl";
+/**
+ * Calls afterRender callback when map finishes rendering
+ *
+ * @remarks
+ * This hook listens to the map's "idle" event and calls the afterRender
+ * callback once. This is used by the Analytical Designer to know when
+ * the chart has finished rendering and can remove the loading spinner.
+ *
+ * The callback is only called once per resetSignal change to avoid repeated calls.
+ *
+ * @param map - MapLibre map instance
+ * @param afterRender - Callback to call when rendering is complete
+ * @param resetSignal - Value that indicates the map should re-signal completion (e.g., execution object)
+ *
+ * @internal
+ */
+export declare function useAfterRender(map: MapLibreMap | null, afterRender?: () => void, resetSignal?: unknown): void;
+//# sourceMappingURL=useAfterRender.d.ts.map

package/esm/next/hooks/map/useAfterRender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAfterRender.d.ts","sourceRoot":"","sources":["../../../../src/next/hooks/map/useAfterRender.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,GAAG,IAAI,WAAW,EAAE,MAAM,aAAa,CAAC;AA2CtD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAC1B,GAAG,EAAE,WAAW,GAAG,IAAI,EACvB,WAAW,CAAC,EAAE,MAAM,IAAI,EACxB,WAAW,CAAC,EAAE,OAAO,GACtB,IAAI,CAkDN"}

package/esm/next/hooks/map/useAfterRender.js

@@ -0,0 +1,99 @@
+// (C) 2025 GoodData Corporation
+import { useEffect, useRef } from "react";
+/**
+ * Check if map is fully idle (loaded and tiles ready)
+ *
+ * @remarks
+ * Pure function that checks if the map is in an idle state, meaning both
+ * the style and tiles are loaded and ready for rendering.
+ *
+ * @param map - MapLibre map instance
+ * @returns true if map is idle, false otherwise
+ *
+ * @internal
+ */
+function isMapFullyIdle(map) {
+    // Check if tiles are loaded (if method exists)
+    const tilesLoaded = typeof map.areTilesLoaded === "function"
+        ? map.areTilesLoaded()
+        : true;
+    return map.loaded() && tilesLoaded;
+}
+/**
+ * Schedule callback to run asynchronously
+ *
+ * @remarks
+ * Pure function that schedules a callback to run on the next frame or tick.
+ * Prefers requestAnimationFrame for smoother rendering, falls back to setTimeout.
+ *
+ * @param callback - Function to schedule
+ *
+ * @internal
+ */
+function scheduleAsync(callback) {
+    if (typeof requestAnimationFrame === "function") {
+        requestAnimationFrame(callback);
+    }
+    else {
+        setTimeout(callback, 0);
+    }
+}
+/**
+ * Calls afterRender callback when map finishes rendering
+ *
+ * @remarks
+ * This hook listens to the map's "idle" event and calls the afterRender
+ * callback once. This is used by the Analytical Designer to know when
+ * the chart has finished rendering and can remove the loading spinner.
+ *
+ * The callback is only called once per resetSignal change to avoid repeated calls.
+ *
+ * @param map - MapLibre map instance
+ * @param afterRender - Callback to call when rendering is complete
+ * @param resetSignal - Value that indicates the map should re-signal completion (e.g., execution object)
+ *
+ * @internal
+ */
+export function useAfterRender(map, afterRender, resetSignal) {
+    const hasCalledRef = useRef(false);
+    const lastResetSignalRef = useRef(resetSignal);
+    // Reset the "called" flag when resetSignal changes
+    useEffect(() => {
+        if (resetSignal !== lastResetSignalRef.current) {
+            hasCalledRef.current = false;
+            lastResetSignalRef.current = resetSignal;
+        }
+    }, [resetSignal]);
+    // Set up idle listener and invoke callbacks
+    useEffect(() => {
+        // Guard: skip if no map, already called, or no callbacks
+        if (!map || hasCalledRef.current || !afterRender) {
+            return;
+        }
+        const invokeCallbacks = () => {
+            // Double-check we haven't called yet (race condition guard)
+            if (hasCalledRef.current) {
+                return;
+            }
+            hasCalledRef.current = true;
+            // Invoke callbacks
+            if (afterRender) {
+                afterRender();
+            }
+        };
+        const handleIdle = () => {
+            map.off("idle", handleIdle);
+            invokeCallbacks();
+        };
+        // Register idle listener
+        map.on("idle", handleIdle);
+        // If already idle, trigger immediately (async to avoid sync effects)
+        if (isMapFullyIdle(map)) {
+            scheduleAsync(handleIdle);
+        }
+        return () => {
+            map.off("idle", handleIdle);
+        };
+    }, [map, afterRender, resetSignal]);
+}
+//# sourceMappingURL=useAfterRender.js.map

package/esm/next/hooks/map/useAfterRender.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAfterRender.js","sourceRoot":"","sources":["../../../../src/next/hooks/map/useAfterRender.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAEhC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAI1C;;;;;;;;;;;GAWG;AACH,SAAS,cAAc,CAAC,GAAgB;IACpC,+CAA+C;IAC/C,MAAM,WAAW,GACb,OAAQ,GAAqD,CAAC,cAAc,KAAK,UAAU;QACvF,CAAC,CAAE,GAAoD,CAAC,cAAc,EAAE;QACxE,CAAC,CAAC,IAAI,CAAC;IAEf,OAAO,GAAG,CAAC,MAAM,EAAE,IAAI,WAAW,CAAC;AACvC,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAS,aAAa,CAAC,QAAoB;IACvC,IAAI,OAAO,qBAAqB,KAAK,UAAU,EAAE,CAAC;QAC9C,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;SAAM,CAAC;QACJ,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC5B,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,cAAc,CAC1B,GAAuB,EACvB,WAAwB,EACxB,WAAqB;IAErB,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACnC,MAAM,kBAAkB,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IAE/C,mDAAmD;IACnD,SAAS,CAAC,GAAG,EAAE;QACX,IAAI,WAAW,KAAK,kBAAkB,CAAC,OAAO,EAAE,CAAC;YAC7C,YAAY,CAAC,OAAO,GAAG,KAAK,CAAC;YAC7B,kBAAkB,CAAC,OAAO,GAAG,WAAW,CAAC;QAC7C,CAAC;IACL,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;IAElB,4CAA4C;IAC5C,SAAS,CAAC,GAAG,EAAE;QACX,yDAAyD;QACzD,IAAI,CAAC,GAAG,IAAI,YAAY,CAAC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;YAC/C,OAAO;QACX,CAAC;QAED,MAAM,eAAe,GAAG,GAAG,EAAE;YACzB,4DAA4D;YAC5D,IAAI,YAAY,CAAC,OAAO,EAAE,CAAC;gBACvB,OAAO;YACX,CAAC;YAED,YAAY,CAAC,OAAO,GAAG,IAAI,CAAC;YAE5B,mBAAmB;YACnB,IAAI,WAAW,EAAE,CAAC;gBACd,WAAW,EAAE,CAAC;YAClB,CAAC;QACL,CAAC,CAAC;QAEF,MAAM,UAAU,GAAG,GAAG,EAAE;YACpB,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;YAC5B,eAAe,EAAE,CAAC;QACtB,CAAC,CAAC;QAEF,yBAAyB;QACzB,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAE3B,qEAAqE;QACrE,IAAI,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,aAAa,CAAC,UAAU,CAAC,CAAC;QAC9B,CAAC;QAED,OAAO,GAAG,EAAE;YACR,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAChC,CAAC,CAAC;IACN,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC;AACxC,CAAC"}

package/esm/next/hooks/map/useMapCallbacks.d.ts

@@ -0,0 +1,20 @@
+import type { Map as MapLibreMap } from "maplibre-gl";
+import { CenterPositionChangedCallback, ZoomChangedCallback } from "../../types/shared.js";
+/**
+ * Set up map interaction callbacks
+ *
+ * @remarks
+ * This hook sets up event listeners for map interactions like pan and zoom,
+ * and calls the provided callbacks when these events occur. It properly
+ * cleans up listeners on unmount or when dependencies change.
+ *
+ * @param map - MapLibre map instance
+ * @param callbacks - Callback functions for map events
+ *
+ * @internal
+ */
+export declare function useMapCallbacks(map: MapLibreMap | null, callbacks: {
+    onCenterPositionChanged?: CenterPositionChangedCallback;
+    onZoomChanged?: ZoomChangedCallback;
+}): void;
+//# sourceMappingURL=useMapCallbacks.d.ts.map

package/esm/next/hooks/map/useMapCallbacks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMapCallbacks.d.ts","sourceRoot":"","sources":["../../../../src/next/hooks/map/useMapCallbacks.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,GAAG,IAAI,WAAW,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,EAAE,6BAA6B,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE3F;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAC3B,GAAG,EAAE,WAAW,GAAG,IAAI,EACvB,SAAS,EAAE;IACP,uBAAuB,CAAC,EAAE,6BAA6B,CAAC;IACxD,aAAa,CAAC,EAAE,mBAAmB,CAAC;CACvC,GACF,IAAI,CAgCN"}

package/esm/next/hooks/map/useMapCallbacks.js

@@ -0,0 +1,44 @@
+// (C) 2025 GoodData Corporation
+import { useEffect } from "react";
+/**
+ * Set up map interaction callbacks
+ *
+ * @remarks
+ * This hook sets up event listeners for map interactions like pan and zoom,
+ * and calls the provided callbacks when these events occur. It properly
+ * cleans up listeners on unmount or when dependencies change.
+ *
+ * @param map - MapLibre map instance
+ * @param callbacks - Callback functions for map events
+ *
+ * @internal
+ */
+export function useMapCallbacks(map, callbacks) {
+    const { onCenterPositionChanged, onZoomChanged } = callbacks;
+    useEffect(() => {
+        if (!map) {
+            return;
+        }
+        const handleMoveEnd = () => {
+            if (onCenterPositionChanged) {
+                const center = map.getCenter();
+                onCenterPositionChanged({
+                    lat: center.lat,
+                    lng: center.lng,
+                });
+            }
+        };
+        const handleZoomEnd = () => {
+            if (onZoomChanged) {
+                onZoomChanged(map.getZoom());
+            }
+        };
+        map.on("moveend", handleMoveEnd);
+        map.on("zoomend", handleZoomEnd);
+        return () => {
+            map.off("moveend", handleMoveEnd);
+            map.off("zoomend", handleZoomEnd);
+        };
+    }, [map, onCenterPositionChanged, onZoomChanged]);
+}
+//# sourceMappingURL=useMapCallbacks.js.map

package/esm/next/hooks/map/useMapCallbacks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMapCallbacks.js","sourceRoot":"","sources":["../../../../src/next/hooks/map/useMapCallbacks.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAEhC,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAMlC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAC3B,GAAuB,EACvB,SAGC;IAED,MAAM,EAAE,uBAAuB,EAAE,aAAa,EAAE,GAAG,SAAS,CAAC;IAE7D,SAAS,CAAC,GAAG,EAAE;QACX,IAAI,CAAC,GAAG,EAAE,CAAC;YACP,OAAO;QACX,CAAC;QAED,MAAM,aAAa,GAAG,GAAG,EAAE;YACvB,IAAI,uBAAuB,EAAE,CAAC;gBAC1B,MAAM,MAAM,GAAG,GAAG,CAAC,SAAS,EAAE,CAAC;gBAC/B,uBAAuB,CAAC;oBACpB,GAAG,EAAE,MAAM,CAAC,GAAG;oBACf,GAAG,EAAE,MAAM,CAAC,GAAG;iBAClB,CAAC,CAAC;YACP,CAAC;QACL,CAAC,CAAC;QAEF,MAAM,aAAa,GAAG,GAAG,EAAE;YACvB,IAAI,aAAa,EAAE,CAAC;gBAChB,aAAa,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YACjC,CAAC;QACL,CAAC,CAAC;QAEF,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QACjC,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QAEjC,OAAO,GAAG,EAAE;YACR,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;YAClC,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QACtC,CAAC,CAAC;IACN,CAAC,EAAE,CAAC,GAAG,EAAE,uBAAuB,EAAE,aAAa,CAAC,CAAC,CAAC;AACtD,CAAC"}

package/esm/next/hooks/map/useMapDataSync.d.ts

@@ -0,0 +1,44 @@
+import type { Map as MapLibreMap } from "maplibre-gl";
+import { DataViewFacade } from "@gooddata/sdk-ui";
+import { IColorStrategy } from "@gooddata/sdk-ui-vis-commons";
+import { IMapConfig } from "../../types/mapProvider.js";
+import { IGeoData, IGeoLngLat } from "../../types/shared.js";
+/**
+ * Filter out invalid coordinates
+ *
+ * @remarks
+ * Pure function that filters location data to only include valid coordinates.
+ * Valid coordinates must be present and have finite lat/lng values.
+ *
+ * @param locations - Array of location coordinates (may include nulls/undefined)
+ * @returns Filtered array of valid coordinates
+ *
+ * @internal
+ */
+export declare function getValidLocations(locations: Array<IGeoLngLat | null | undefined>): IGeoLngLat[];
+/**
+ * Synchronize geo data with map layers
+ *
+ * @remarks
+ * This hook updates map layers when data, config, or color strategy changes.
+ * It handles:
+ * - Removing old layers
+ * - Creating new data source
+ * - Adding appropriate layers (clustered or unclustered)
+ * - Setting viewport based on data (unless frozen or on first render)
+ *
+ * The hook waits for the map to be ready before attempting any updates.
+ * On first render, viewport setting is skipped because it was already set
+ * during map initialization.
+ *
+ * @param map - MapLibre map instance (null if not initialized)
+ * @param geoData - Geographic data to display (null if not loaded)
+ * @param config - Map configuration (null if not ready)
+ * @param colorStrategy - Color strategy for styling (null if not ready)
+ * @param isMapReady - Whether map is ready for updates
+ * @param result - Execution result for data access
+ *
+ * @internal
+ */
+export declare function useMapDataSync(map: MapLibreMap | null, geoData: IGeoData | null, config: IMapConfig | null, colorStrategy: IColorStrategy | null, isMapReady: boolean, result: DataViewFacade | null): void;
+//# sourceMappingURL=useMapDataSync.d.ts.map

package/esm/next/hooks/map/useMapDataSync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMapDataSync.d.ts","sourceRoot":"","sources":["../../../../src/next/hooks/map/useMapDataSync.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,GAAG,IAAI,WAAW,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAI9D,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,KAAK,CAAC,UAAU,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,UAAU,EAAE,CAQ/F;AAkBD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,cAAc,CAC1B,GAAG,EAAE,WAAW,GAAG,IAAI,EACvB,OAAO,EAAE,QAAQ,GAAG,IAAI,EACxB,MAAM,EAAE,UAAU,GAAG,IAAI,EACzB,aAAa,EAAE,cAAc,GAAG,IAAI,EACpC,UAAU,EAAE,OAAO,EACnB,MAAM,EAAE,cAAc,GAAG,IAAI,GAC9B,IAAI,CAqCN"}

package/esm/next/hooks/map/useMapDataSync.js

@@ -0,0 +1,87 @@
+// (C) 2025 GoodData Corporation
+import { useEffect, useMemo, useRef } from "react";
+import { updateMapLayers } from "../../features/map/layerManagement.js";
+import { applyViewportSafely, calculateViewport } from "../../features/map/viewportManagement.js";
+/**
+ * Filter out invalid coordinates
+ *
+ * @remarks
+ * Pure function that filters location data to only include valid coordinates.
+ * Valid coordinates must be present and have finite lat/lng values.
+ *
+ * @param locations - Array of location coordinates (may include nulls/undefined)
+ * @returns Filtered array of valid coordinates
+ *
+ * @internal
+ */
+export function getValidLocations(locations) {
+    return locations.filter((coords) => coords !== null &&
+        coords !== undefined &&
+        Number.isFinite(coords.lat) &&
+        Number.isFinite(coords.lng));
+}
+/**
+ * Check if viewport should be updated
+ *
+ * @remarks
+ * Pure function that determines whether the viewport should be updated
+ * based on configuration. The viewport is frozen when explicitly configured.
+ *
+ * @param config - Map configuration
+ * @returns true if viewport should remain frozen, false if it should update
+ *
+ * @internal
+ */
+function isViewportFrozen(config) {
+    return Boolean(config.viewport?.frozen);
+}
+/**
+ * Synchronize geo data with map layers
+ *
+ * @remarks
+ * This hook updates map layers when data, config, or color strategy changes.
+ * It handles:
+ * - Removing old layers
+ * - Creating new data source
+ * - Adding appropriate layers (clustered or unclustered)
+ * - Setting viewport based on data (unless frozen or on first render)
+ *
+ * The hook waits for the map to be ready before attempting any updates.
+ * On first render, viewport setting is skipped because it was already set
+ * during map initialization.
+ *
+ * @param map - MapLibre map instance (null if not initialized)
+ * @param geoData - Geographic data to display (null if not loaded)
+ * @param config - Map configuration (null if not ready)
+ * @param colorStrategy - Color strategy for styling (null if not ready)
+ * @param isMapReady - Whether map is ready for updates
+ * @param result - Execution result for data access
+ *
+ * @internal
+ */
+export function useMapDataSync(map, geoData, config, colorStrategy, isMapReady, result) {
+    // Track first render to avoid re-applying viewport that was set during initialization
+    const isFirstRenderRef = useRef(true);
+    // Compute valid locations (pure function, memoized)
+    const validLocations = useMemo(() => (geoData?.location?.data ? getValidLocations(geoData.location.data) : []), [geoData?.location?.data]);
+    // Compute viewport (pure function, memoized)
+    const viewport = useMemo(() => (config ? calculateViewport(validLocations, config) : null), [validLocations, config]);
+    useEffect(() => {
+        // Guard: ensure all dependencies are ready
+        if (!map || !isMapReady || !geoData || !config || !colorStrategy || !result || !viewport) {
+            return undefined;
+        }
+        // Update layers with new data
+        updateMapLayers(map, geoData, config, colorStrategy);
+        // Skip viewport update on first render (already set during initialization)
+        // Update viewport on subsequent renders if not frozen
+        if (!isFirstRenderRef.current && !isViewportFrozen(config)) {
+            map.resize();
+            return applyViewportSafely(map, viewport);
+        }
+        // Mark that first render has completed
+        isFirstRenderRef.current = false;
+        return undefined;
+    }, [map, geoData, config, colorStrategy, result, isMapReady, viewport]);
+}
+//# sourceMappingURL=useMapDataSync.js.map

package/esm/next/hooks/map/useMapDataSync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMapDataSync.js","sourceRoot":"","sources":["../../../../src/next/hooks/map/useMapDataSync.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAEhC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAOnD,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAIlG;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAA+C;IAC7E,OAAO,SAAS,CAAC,MAAM,CACnB,CAAC,MAAM,EAAwB,EAAE,CAC7B,MAAM,KAAK,IAAI;QACf,MAAM,KAAK,SAAS;QACpB,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC;QAC3B,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAClC,CAAC;AACN,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAS,gBAAgB,CAAC,MAAkB;IACxC,OAAO,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,cAAc,CAC1B,GAAuB,EACvB,OAAwB,EACxB,MAAyB,EACzB,aAAoC,EACpC,UAAmB,EACnB,MAA6B;IAE7B,sFAAsF;IACtF,MAAM,gBAAgB,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAEtC,oDAAoD;IACpD,MAAM,cAAc,GAAG,OAAO,CAC1B,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAC/E,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,CAC5B,CAAC;IAEF,6CAA6C;IAC7C,MAAM,QAAQ,GAAG,OAAO,CACpB,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EACjE,CAAC,cAAc,EAAE,MAAM,CAAC,CAC3B,CAAC;IAEF,SAAS,CAAC,GAAG,EAAE;QACX,2CAA2C;QAC3C,IAAI,CAAC,GAAG,IAAI,CAAC,UAAU,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM,IAAI,CAAC,aAAa,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;YACvF,OAAO,SAAS,CAAC;QACrB,CAAC;QAED,8BAA8B;QAC9B,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC;QAErD,2EAA2E;QAC3E,sDAAsD;QACtD,IAAI,CAAC,gBAAgB,CAAC,OAAO,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;YACzD,GAAG,CAAC,MAAM,EAAE,CAAC;YACb,OAAO,mBAAmB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC9C,CAAC;QAED,uCAAuC;QACvC,gBAAgB,CAAC,OAAO,GAAG,KAAK,CAAC;QAEjC,OAAO,SAAS,CAAC;IACrB,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC5E,CAAC"}

package/esm/next/hooks/map/useMapInitialization.d.ts

@@ -0,0 +1,56 @@
+import { RefObject } from "react";
+import type { Map as MapLibreMap, Popup } from "maplibre-gl";
+import { IntlShape } from "react-intl";
+import { IGeoPushpinChartNextConfig } from "../../types/config.js";
+import { IMapViewport } from "../../types/mapProvider.js";
+/**
+ * Hook return value
+ *
+ * @internal
+ */
+export interface IUseMapInitializationResult {
+    /**
+     * MapLibre map instance (null until initialized)
+     */
+    map: MapLibreMap | null;
+    /**
+     * Tooltip popup instance (null until initialized)
+     */
+    tooltip: Popup | null;
+    /**
+     * Whether map is ready for use
+     */
+    isMapReady: boolean;
+    /**
+     * Error that occurred during initialization
+     */
+    error: Error | null;
+}
+/**
+ * Initialize map instance
+ *
+ * @remarks
+ * This hook handles map creation, loading state, and cleanup.
+ * It creates the MapLibre map instance when the container is ready
+ * and cleans it up on unmount.
+ *
+ * The map instance is returned along with loading/error states.
+ *
+ * Key behaviors:
+ * - Accepts pre-calculated viewport to prevent initial world view
+ * - Captures initial center/zoom on first render (prevents re-centering on config changes)
+ * - Creates map instance asynchronously
+ * - Handles race conditions with isMounted flag
+ * - Cleans up resources on unmount or style change
+ * - Supports cooperative gestures with localized messages
+ *
+ * @param containerRef - Ref to the map container element
+ * @param intl - react-intl instance for translations
+ * @param config - Geo configuration (optional)
+ * @param initialViewport - Pre-calculated viewport from data (optional)
+ * @returns Map instance, tooltip, ready state, and error
+ *
+ * @internal
+ */
+export declare function useMapInitialization(containerRef: RefObject<HTMLDivElement | null>, intl: IntlShape, config?: IGeoPushpinChartNextConfig, initialViewport?: Partial<IMapViewport> | null): IUseMapInitializationResult;
+//# sourceMappingURL=useMapInitialization.d.ts.map

package/esm/next/hooks/map/useMapInitialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMapInitialization.d.ts","sourceRoot":"","sources":["../../../../src/next/hooks/map/useMapInitialization.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAwC,MAAM,OAAO,CAAC;AAExE,OAAO,KAAK,EAAE,GAAG,IAAI,WAAW,EAAE,KAAK,EAAsB,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGvC,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAG1D;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IACxC;;OAEG;IACH,GAAG,EAAE,WAAW,GAAG,IAAI,CAAC;IAExB;;OAEG;IACH,OAAO,EAAE,KAAK,GAAG,IAAI,CAAC;IAEtB;;OAEG;IACH,UAAU,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACvB;AAmBD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,oBAAoB,CAChC,YAAY,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,EAC9C,IAAI,EAAE,SAAS,EACf,MAAM,CAAC,EAAE,0BAA0B,EACnC,eAAe,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,GAC/C,2BAA2B,CAqF7B"}

package/esm/next/hooks/map/useMapInitialization.js

@@ -0,0 +1,121 @@
+// (C) 2025 GoodData Corporation
+import { useEffect, useMemo, useRef, useState } from "react";
+import { initializeMapLibreMap } from "../../features/map/initializeMap.js";
+import { generateMapLibreLocale } from "../../utils/mapLocale.js";
+/**
+ * Cleanup map resources
+ *
+ * @remarks
+ * Pure function that safely removes map and tooltip instances.
+ * Handles null checks internally for clean code.
+ *
+ * @param map - MapLibre map instance to remove (or null)
+ * @param tooltip - Tooltip popup instance to remove (or null)
+ *
+ * @internal
+ */
+function cleanupMapResources(map, tooltip) {
+    tooltip?.remove();
+    map?.remove();
+}
+/**
+ * Initialize map instance
+ *
+ * @remarks
+ * This hook handles map creation, loading state, and cleanup.
+ * It creates the MapLibre map instance when the container is ready
+ * and cleans it up on unmount.
+ *
+ * The map instance is returned along with loading/error states.
+ *
+ * Key behaviors:
+ * - Accepts pre-calculated viewport to prevent initial world view
+ * - Captures initial center/zoom on first render (prevents re-centering on config changes)
+ * - Creates map instance asynchronously
+ * - Handles race conditions with isMounted flag
+ * - Cleans up resources on unmount or style change
+ * - Supports cooperative gestures with localized messages
+ *
+ * @param containerRef - Ref to the map container element
+ * @param intl - react-intl instance for translations
+ * @param config - Geo configuration (optional)
+ * @param initialViewport - Pre-calculated viewport from data (optional)
+ * @returns Map instance, tooltip, ready state, and error
+ *
+ * @internal
+ */
+export function useMapInitialization(containerRef, intl, config, initialViewport) {
+    const [map, setMap] = useState(null);
+    const [tooltip, setTooltip] = useState(null);
+    const [isMapReady, setIsMapReady] = useState(false);
+    const [error, setError] = useState(null);
+    // Refs for instance tracking and cleanup
+    const mapInstanceRef = useRef(null);
+    const tooltipInstanceRef = useRef(null);
+    // Capture initial viewport config (prevents re-centering when config changes)
+    // Prioritize initialViewport from data, then fall back to config
+    const initialCenterRef = useRef(initialViewport?.center ?? config?.center);
+    const initialZoomRef = useRef(initialViewport?.zoom ?? config?.zoom);
+    const initialBoundsRef = useRef(initialViewport?.bounds);
+    // Update initial refs if map hasn't been created yet
+    useEffect(() => {
+        if (!mapInstanceRef.current) {
+            initialCenterRef.current = initialViewport?.center ?? config?.center;
+            initialZoomRef.current = initialViewport?.zoom ?? config?.zoom;
+            initialBoundsRef.current = initialViewport?.bounds;
+        }
+    }, [config?.center, config?.zoom, initialViewport]);
+    // Generate locale for cooperative gestures
+    const cooperativeGestures = config?.cooperativeGestures ?? true;
+    const locale = useMemo(() => {
+        return cooperativeGestures ? generateMapLibreLocale(intl) : undefined;
+    }, [cooperativeGestures, intl]);
+    // Create and manage map instance
+    useEffect(() => {
+        const container = containerRef.current;
+        if (!container) {
+            return;
+        }
+        let isMounted = true;
+        // Initialize map with captured initial viewport
+        // Use bounds if available (calculated from data), otherwise use center/zoom
+        initializeMapLibreMap({
+            container,
+            bounds: initialBoundsRef.current,
+            center: initialCenterRef.current,
+            zoom: initialZoomRef.current,
+            cooperativeGestures,
+            style: config?.mapStyle,
+        }, locale)
+            .then((result) => {
+            if (isMounted) {
+                // Store in refs and state
+                mapInstanceRef.current = result.map;
+                tooltipInstanceRef.current = result.tooltip;
+                setMap(result.map);
+                setTooltip(result.tooltip);
+                setIsMapReady(true);
+            }
+            else {
+                // Component unmounted during initialization - clean up
+                cleanupMapResources(result.map, result.tooltip);
+            }
+        })
+            .catch((err) => {
+            if (isMounted) {
+                console.error("[useMapInitialization] Failed to initialize map:", err);
+                setError(err);
+            }
+        });
+        return () => {
+            isMounted = false;
+            setIsMapReady(false);
+            // Clean up resources
+            cleanupMapResources(mapInstanceRef.current, tooltipInstanceRef.current);
+            mapInstanceRef.current = null;
+            tooltipInstanceRef.current = null;
+        };
+    }, [containerRef, config?.mapStyle, cooperativeGestures, locale]);
+    return { map, tooltip, isMapReady, error };
+}
+//# sourceMappingURL=useMapInitialization.js.map

package/esm/next/hooks/map/useMapInitialization.js.map

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

package/esm/next/hooks/map/useTooltipHandlers.d.ts

@@ -0,0 +1,22 @@
+import type { Map as MapLibreMap, Popup } from "maplibre-gl";
+import { IntlShape } from "react-intl";
+import { IHeaderPredicate } from "@gooddata/sdk-ui";
+import { IMapConfig } from "../../types/mapProvider.js";
+/**
+ * Set up tooltip handlers for map interactions
+ *
+ * @remarks
+ * This hook manages tooltip event listeners for the map. It sets up
+ * mousemove handlers to show/hide tooltips when hovering over pushpins,
+ * and properly cleans them up when dependencies change or on unmount.
+ *
+ * @param map - MapLibre map instance (null if not initialized)
+ * @param tooltip - Popup instance for displaying tooltips (null if not initialized)
+ * @param config - Map configuration
+ * @param drillablePredicates - Array of drillable item predicates
+ * @param intl - Internationalization configuration
+ *
+ * @internal
+ */
+export declare function useTooltipHandlers(map: MapLibreMap | null, tooltip: Popup | null, config: IMapConfig | undefined, drillablePredicates: IHeaderPredicate[], intl: IntlShape): void;
+//# sourceMappingURL=useTooltipHandlers.d.ts.map

package/esm/next/hooks/map/useTooltipHandlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTooltipHandlers.d.ts","sourceRoot":"","sources":["../../../../src/next/hooks/map/useTooltipHandlers.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,GAAG,IAAI,WAAW,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGpD,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAExD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAC9B,GAAG,EAAE,WAAW,GAAG,IAAI,EACvB,OAAO,EAAE,KAAK,GAAG,IAAI,EACrB,MAAM,EAAE,UAAU,GAAG,SAAS,EAC9B,mBAAmB,EAAE,gBAAgB,EAAE,EACvC,IAAI,EAAE,SAAS,GAChB,IAAI,CAQN"}

package/esm/next/hooks/map/useTooltipHandlers.js

@@ -0,0 +1,28 @@
+// (C) 2025 GoodData Corporation
+import { useEffect } from "react";
+import { setupTooltipHandlers } from "../../features/tooltip/tooltipManagement.js";
+/**
+ * Set up tooltip handlers for map interactions
+ *
+ * @remarks
+ * This hook manages tooltip event listeners for the map. It sets up
+ * mousemove handlers to show/hide tooltips when hovering over pushpins,
+ * and properly cleans them up when dependencies change or on unmount.
+ *
+ * @param map - MapLibre map instance (null if not initialized)
+ * @param tooltip - Popup instance for displaying tooltips (null if not initialized)
+ * @param config - Map configuration
+ * @param drillablePredicates - Array of drillable item predicates
+ * @param intl - Internationalization configuration
+ *
+ * @internal
+ */
+export function useTooltipHandlers(map, tooltip, config, drillablePredicates, intl) {
+    useEffect(() => {
+        if (!map || !tooltip || !config) {
+            return undefined;
+        }
+        return setupTooltipHandlers(map, tooltip, config, drillablePredicates, intl);
+    }, [map, tooltip, config, drillablePredicates, intl]);
+}
+//# sourceMappingURL=useTooltipHandlers.js.map