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

package/esm/next/constants/geoChart.js

@@ -0,0 +1,130 @@
+// (C) 2025 GoodData Corporation
+// =============================================================================
+// Pushpin Size Configuration
+// =============================================================================
+/**
+ * Pushpin size mapping for different size options
+ *
+ * @remarks
+ * Defines minimum and maximum pushpin sizes for each size preset
+ */
+export const PUSHPIN_SIZE_OPTIONS_MAP = {
+    min: {
+        default: 8,
+        "0.5x": 4,
+        "0.75x": 6,
+        normal: 8,
+        "1.25x": 10,
+        "1.5x": 12,
+    },
+    max: {
+        default: 60,
+        "0.5x": 30,
+        "0.75x": 45,
+        normal: 60,
+        "1.25x": 75,
+        "1.5x": 90,
+    },
+};
+// =============================================================================
+// Pushpin Color Configuration
+// =============================================================================
+/**
+ * Default border color for pushpins
+ */
+export const DEFAULT_PUSHPIN_BORDER_COLOR_VALUE = "rgb(233,237,241)";
+/**
+ * Default opacity for pushpin colors
+ */
+export const DEFAULT_PUSHPIN_COLOR_OPACITY = 0.7;
+/**
+ * Number of color scale steps for color gradients
+ *
+ * @remarks
+ * Used for creating color palettes. Should be less than 20 for performance.
+ */
+export const DEFAULT_PUSHPIN_COLOR_SCALE = 6;
+/**
+ * Default color value for pushpins
+ *
+ * @remarks
+ * Used as fallback color when no color mapping is defined
+ */
+export const DEFAULT_PUSHPIN_COLOR_VALUE = "rgb(20,178,226)";
+// =============================================================================
+// Clustering Configuration
+// =============================================================================
+/**
+ * Maximum zoom level at which to cluster points
+ */
+export const DEFAULT_CLUSTER_MAX_ZOOM = 14;
+/**
+ * Radius in pixels within which points will be clustered
+ */
+export const DEFAULT_CLUSTER_RADIUS = 50;
+// =============================================================================
+// Layer and Data Source Names
+// =============================================================================
+/**
+ * Default name for the pushpin data source
+ */
+export const DEFAULT_DATA_SOURCE_NAME = "gdcPushpinsData";
+/**
+ * Default name for the pushpin layer
+ */
+export const DEFAULT_LAYER_NAME = "gdcPushpins";
+/**
+ * Default name for the cluster layer
+ */
+export const DEFAULT_CLUSTER_LAYER_NAME = "gdcClusters";
+/**
+ * Suffix for label layers
+ */
+export const LAYER_STYLE_LABEL_PREFIX = "-label";
+// =============================================================================
+// Pushpin Style Properties
+// =============================================================================
+/**
+ * Pushpin circle style type
+ */
+export const PUSHPIN_STYLE_CIRCLE = "circle";
+/**
+ * Pushpin circle color property
+ */
+export const PUSHPIN_STYLE_CIRCLE_COLOR = "circle-color";
+/**
+ * Pushpin circle size property
+ */
+export const PUSHPIN_STYLE_CIRCLE_SIZE = "circle-radius";
+/**
+ * Pushpin circle stroke color property
+ */
+export const PUSHPIN_STYLE_CIRCLE_STROKE_COLOR = "circle-stroke-color";
+// =============================================================================
+// Data Limits
+// =============================================================================
+/**
+ * Maximum number of data points to render
+ *
+ * @remarks
+ * Limits are in place for performance reasons
+ */
+export const DEFAULT_DATA_POINTS_LIMIT = 25000;
+// =============================================================================
+// Tooltip Configuration
+// =============================================================================
+/**
+ * Default options for pushpin styling
+ */
+export const DEFAULT_PUSHPIN_OPTIONS = {
+    "circle-stroke-width": 1,
+};
+/**
+ * Value to display when data is null
+ */
+export const NULL_TOOLTIP_VALUE = "-";
+/**
+ * Value used for empty segment filters
+ */
+export const EMPTY_SEGMENT_VALUE = "empty-segment-filter";
+//# sourceMappingURL=geoChart.js.map

package/esm/next/constants/geoChart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geoChart.js","sourceRoot":"","sources":["../../../src/next/constants/geoChart.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAEhC,gFAAgF;AAChF,6BAA6B;AAC7B,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACpC,GAAG,EAAE;QACD,OAAO,EAAE,CAAC;QACV,MAAM,EAAE,CAAC;QACT,OAAO,EAAE,CAAC;QACV,MAAM,EAAE,CAAC;QACT,OAAO,EAAE,EAAE;QACX,MAAM,EAAE,EAAE;KACb;IACD,GAAG,EAAE;QACD,OAAO,EAAE,EAAE;QACX,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,EAAE;QACX,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,EAAE;QACX,MAAM,EAAE,EAAE;KACb;CACK,CAAC;AAEX,gFAAgF;AAChF,8BAA8B;AAC9B,gFAAgF;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAG,kBAAkB,CAAC;AAErE;;GAEG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,GAAG,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,iBAAiB,CAAC;AAE7D,gFAAgF;AAChF,2BAA2B;AAC3B,gFAAgF;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,CAAC;AAE3C;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAEzC,gFAAgF;AAChF,8BAA8B;AAC9B,gFAAgF;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,iBAAiB,CAAC;AAE1D;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,aAAa,CAAC;AAEhD;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,aAAa,CAAC;AAExD;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,QAAQ,CAAC;AAEjD,gFAAgF;AAChF,2BAA2B;AAC3B,gFAAgF;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,QAAQ,CAAC;AAE7C;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,cAAc,CAAC;AAEzD;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,eAAe,CAAC;AAEzD;;GAEG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,qBAAqB,CAAC;AAEvE,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,KAAK,CAAC;AAE/C,gFAAgF;AAChF,wBAAwB;AACxB,gFAAgF;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACnC,qBAAqB,EAAE,CAAC;CAClB,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAEtC;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,sBAAsB,CAAC"}

package/esm/next/constants/internal.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Empty arrays (referentially stable)
+ *
+ * @internal
+ */
+export declare const EMPTY_DRILLS: [];
+/**
+ * @internal
+ */
+export declare const EMPTY_FILTERS: [];
+/**
+ * @internal
+ */
+export declare const EMPTY_SORT_BY: [];
+/**
+ * @internal
+ */
+export declare const EMPTY_OBJECT: {};
+//# sourceMappingURL=internal.d.ts.map

package/esm/next/constants/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../../src/next/constants/internal.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,EAAO,CAAC;AAEnC;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,EAAO,CAAC;AAEpC;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,EAAO,CAAC;AAEpC;;GAEG;AACH,eAAO,MAAM,YAAY,IAAK,CAAC"}

package/esm/next/constants/internal.js

@@ -0,0 +1,20 @@
+// (C) 2025 GoodData Corporation
+/**
+ * Empty arrays (referentially stable)
+ *
+ * @internal
+ */
+export const EMPTY_DRILLS = [];
+/**
+ * @internal
+ */
+export const EMPTY_FILTERS = [];
+/**
+ * @internal
+ */
+export const EMPTY_SORT_BY = [];
+/**
+ * @internal
+ */
+export const EMPTY_OBJECT = {};
+//# sourceMappingURL=internal.js.map

package/esm/next/constants/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../../../src/next/constants/internal.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAEhC;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAO,EAAE,CAAC;AAEnC;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAO,EAAE,CAAC;AAEpC;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAO,EAAE,CAAC;AAEpC;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAC"}

package/esm/next/context/GeoDataContext.d.ts

@@ -0,0 +1,69 @@
+import { ReactNode } from "react";
+import { IColorPalette } from "@gooddata/sdk-model";
+import { IColorStrategy, IPushpinCategoryLegendItem } from "@gooddata/sdk-ui-vis-commons";
+import { IAvailableLegends, IGeoData } from "../types/shared.js";
+/**
+ * Context for geographic data and derived values.
+ *
+ * @remarks
+ * This context provides all computed data derived from the initial execution result.
+ * All values are computed once using useMemo and provided down the tree.
+ * This eliminates the need for useEffect state synchronization.
+ *
+ * @alpha
+ */
+interface IGeoDataContext {
+    /**
+     * Transformed geographic data
+     */
+    geoData: IGeoData | null;
+    /**
+     * Color strategy used for visualization
+     */
+    colorStrategy: IColorStrategy | null;
+    /**
+     * Color palette used for visualization
+     */
+    colorPalette: IColorPalette;
+    /**
+     * Base category legend items (before applying visibility state)
+     */
+    baseLegendItems: IPushpinCategoryLegendItem[];
+    /**
+     * Available legend types based on data
+     */
+    availableLegends: IAvailableLegends;
+}
+/**
+ * Provider for geographic data.
+ *
+ * @remarks
+ * This provider computes all derived data from the initial execution result:
+ * - Transforms DataView to IGeoData
+ * - Creates color strategy
+ * - Generates legend items
+ * - Determines available legends
+ *
+ * All computations use useMemo and happen once per data change.
+ * No useEffect or state synchronization needed.
+ *
+ * @alpha
+ */
+export declare function GeoDataProvider({ children }: {
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+/**
+ * Hook to access geographic data.
+ *
+ * @remarks
+ * Use this hook to access all computed data derived from the execution result.
+ * All values are already computed and memoized.
+ *
+ * @returns Geographic data context
+ * @throws Error if used outside of GeoDataProvider
+ *
+ * @alpha
+ */
+export declare function useGeoData(): IGeoDataContext;
+export {};
+//# sourceMappingURL=GeoDataContext.d.ts.map

package/esm/next/context/GeoDataContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GeoDataContext.d.ts","sourceRoot":"","sources":["../../../src/next/context/GeoDataContext.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAsC,MAAM,OAAO,CAAC;AAEtE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAQ1F,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEjE;;;;;;;;;GASG;AACH,UAAU,eAAe;IACrB;;OAEG;IACH,OAAO,EAAE,QAAQ,GAAG,IAAI,CAAC;IAEzB;;OAEG;IACH,aAAa,EAAE,cAAc,GAAG,IAAI,CAAC;IAErC;;OAEG;IACH,YAAY,EAAE,aAAa,CAAC;IAE5B;;OAEG;IACH,eAAe,EAAE,0BAA0B,EAAE,CAAC;IAE9C;;OAEG;IACH,gBAAgB,EAAE,iBAAiB,CAAC;CACvC;AAUD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,2CA4CpE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,IAAI,eAAe,CAQ5C"}

package/esm/next/context/GeoDataContext.js

@@ -0,0 +1,80 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// (C) 2025 GoodData Corporation
+import { createContext, useContext, useMemo } from "react";
+import { DefaultColorPalette } from "@gooddata/sdk-ui";
+import { useGeoPushpinProps } from "./GeoPushpinPropsContext.js";
+import { useInitialExecution } from "./InitialExecutionContext.js";
+import { getColorStrategy } from "../features/coloring/colorStrategy.js";
+import { getAvailableLegends } from "../features/data/transformation.js";
+import { useLegendItems } from "../hooks/legend/useLegendItems.js";
+import { useGeoDataTransformation } from "../hooks/shared/useGeoDataTransformation.js";
+const GeoDataContext = createContext(undefined);
+const EMPTY_AVAILABLE_LEGENDS = {
+    hasCategoryLegend: false,
+    hasColorLegend: false,
+    hasSizeLegend: false,
+};
+/**
+ * Provider for geographic data.
+ *
+ * @remarks
+ * This provider computes all derived data from the initial execution result:
+ * - Transforms DataView to IGeoData
+ * - Creates color strategy
+ * - Generates legend items
+ * - Determines available legends
+ *
+ * All computations use useMemo and happen once per data change.
+ * No useEffect or state synchronization needed.
+ *
+ * @alpha
+ */
+export function GeoDataProvider({ children }) {
+    const props = useGeoPushpinProps();
+    const { initialDataView } = useInitialExecution();
+    // Transform execution data to geo format
+    const geoData = useGeoDataTransformation(initialDataView);
+    // Create color strategy (memoized to prevent infinite loops)
+    const colorPalette = useMemo(() => props.config?.colorPalette || DefaultColorPalette, [props.config?.colorPalette]);
+    const colorMapping = useMemo(() => props.config?.colorMapping || [], [props.config?.colorMapping]);
+    const colorStrategy = useMemo(() => geoData && initialDataView
+        ? getColorStrategy(colorPalette, colorMapping, geoData, initialDataView)
+        : null, [colorPalette, colorMapping, geoData, initialDataView]);
+    // Get base legend items (with colors, but always isVisible: true)
+    const baseLegendItems = useLegendItems(initialDataView, geoData, colorStrategy);
+    // Compute available legends
+    const availableLegends = useMemo(() => {
+        if (!geoData) {
+            return EMPTY_AVAILABLE_LEGENDS;
+        }
+        return getAvailableLegends(baseLegendItems, geoData);
+    }, [baseLegendItems, geoData]);
+    const value = useMemo(() => ({
+        geoData,
+        colorStrategy,
+        colorPalette,
+        baseLegendItems,
+        availableLegends,
+    }), [geoData, colorStrategy, colorPalette, baseLegendItems, availableLegends]);
+    return _jsx(GeoDataContext.Provider, { value: value, children: children });
+}
+/**
+ * Hook to access geographic data.
+ *
+ * @remarks
+ * Use this hook to access all computed data derived from the execution result.
+ * All values are already computed and memoized.
+ *
+ * @returns Geographic data context
+ * @throws Error if used outside of GeoDataProvider
+ *
+ * @alpha
+ */
+export function useGeoData() {
+    const context = useContext(GeoDataContext);
+    if (context === undefined) {
+        throw new Error("useGeoData must be used within a GeoDataProvider");
+    }
+    return context;
+}
+//# sourceMappingURL=GeoDataContext.js.map

package/esm/next/context/GeoDataContext.js.map

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

package/esm/next/context/GeoLegendContext.d.ts

@@ -0,0 +1,78 @@
+import { ReactNode } from "react";
+import { PositionType } from "@gooddata/sdk-ui-vis-commons";
+/**
+ * Context for managing legend state and behavior.
+ *
+ * @remarks
+ * This context manages which legend items are enabled/visible, the legend position,
+ * and responsive layout behavior for smaller screens.
+ *
+ * @alpha
+ */
+interface IGeoLegendContext {
+    /**
+     * URIs of enabled legend items (empty array means all enabled)
+     */
+    enabledLegendItems: string[];
+    /**
+     * Updates the enabled legend items
+     */
+    setEnabledLegendItems: (items: string[]) => void;
+    /**
+     * Toggles a legend item's enabled state
+     *
+     * @param uri - The URI of the legend item to toggle
+     * @param allUris - All available legend item URIs (for toggle logic)
+     */
+    toggleLegendItem: (uri: string, allUris: string[]) => void;
+    /**
+     * Position of the legend relative to the chart
+     */
+    legendPosition: PositionType;
+    /**
+     * Updates the legend position
+     */
+    setLegendPosition: (position: PositionType) => void;
+    /**
+     * Whether the legend is in responsive mode (horizontal layout on small screens)
+     */
+    isResponsive: boolean;
+    /**
+     * Updates the responsive state
+     */
+    setIsResponsive: (responsive: boolean) => void;
+    /**
+     * Whether the legend should show in a popup on small screens
+     */
+    showPopup: boolean;
+    /**
+     * Updates the popup state
+     */
+    setShowPopup: (show: boolean) => void;
+}
+/**
+ * Provider for legend state management.
+ *
+ * @remarks
+ * This provider manages the state of the legend including which items are visible,
+ * the legend position, and responsive behavior.
+ *
+ * @alpha
+ */
+export declare function GeoLegendProvider({ children }: {
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+/**
+ * Hook to access legend state and controls.
+ *
+ * @remarks
+ * Use this hook to manage legend visibility, position, and responsive behavior.
+ *
+ * @returns Legend context
+ * @throws Error if used outside of GeoLegendProvider
+ *
+ * @alpha
+ */
+export declare function useGeoLegend(): IGeoLegendContext;
+export {};
+//# sourceMappingURL=GeoLegendContext.d.ts.map

package/esm/next/context/GeoLegendContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GeoLegendContext.d.ts","sourceRoot":"","sources":["../../../src/next/context/GeoLegendContext.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAuC,MAAM,OAAO,CAAC;AAEvE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE5D;;;;;;;;GAQG;AACH,UAAU,iBAAiB;IACvB;;OAEG;IACH,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAE7B;;OAEG;IACH,qBAAqB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAEjD;;;;;OAKG;IACH,gBAAgB,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAE3D;;OAEG;IACH,cAAc,EAAE,YAAY,CAAC;IAE7B;;OAEG;IACH,iBAAiB,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC;IAEpD;;OAEG;IACH,YAAY,EAAE,OAAO,CAAC;IAEtB;;OAEG;IACH,eAAe,EAAE,CAAC,UAAU,EAAE,OAAO,KAAK,IAAI,CAAC;IAE/C;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACzC;AAID;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,2CAmDtE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,IAAI,iBAAiB,CAQhD"}

package/esm/next/context/GeoLegendContext.js

@@ -0,0 +1,74 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// (C) 2025 GoodData Corporation
+import { createContext, useContext, useState } from "react";
+const GeoLegendContext = createContext(undefined);
+/**
+ * Provider for legend state management.
+ *
+ * @remarks
+ * This provider manages the state of the legend including which items are visible,
+ * the legend position, and responsive behavior.
+ *
+ * @alpha
+ */
+export function GeoLegendProvider({ children }) {
+    const [enabledLegendItems, setEnabledLegendItems] = useState([]);
+    const [legendPosition, setLegendPosition] = useState("top");
+    const [isResponsive, setIsResponsive] = useState(false);
+    const [showPopup, setShowPopup] = useState(false);
+    const toggleLegendItem = (uri, allUris) => {
+        setEnabledLegendItems((prev) => {
+            // If empty (all enabled), clicking disables the clicked item
+            // by enabling all EXCEPT the clicked one
+            if (prev.length === 0) {
+                return allUris.filter((itemUri) => itemUri !== uri);
+            }
+            // If the item is enabled, disable it
+            if (prev.includes(uri)) {
+                const newEnabled = prev.filter((item) => item !== uri);
+                // If all items would be enabled again, return to "all enabled" state (empty array)
+                if (newEnabled.length === allUris.length - 1) {
+                    return [];
+                }
+                return newEnabled;
+            }
+            // If the item is disabled, enable it
+            const newEnabled = [...prev, uri];
+            // If all items are now enabled, return to "all enabled" state (empty array)
+            if (newEnabled.length === allUris.length) {
+                return [];
+            }
+            return newEnabled;
+        });
+    };
+    return (_jsx(GeoLegendContext.Provider, { value: {
+            enabledLegendItems,
+            setEnabledLegendItems,
+            toggleLegendItem,
+            legendPosition,
+            setLegendPosition,
+            isResponsive,
+            setIsResponsive,
+            showPopup,
+            setShowPopup,
+        }, children: children }));
+}
+/**
+ * Hook to access legend state and controls.
+ *
+ * @remarks
+ * Use this hook to manage legend visibility, position, and responsive behavior.
+ *
+ * @returns Legend context
+ * @throws Error if used outside of GeoLegendProvider
+ *
+ * @alpha
+ */
+export function useGeoLegend() {
+    const context = useContext(GeoLegendContext);
+    if (context === undefined) {
+        throw new Error("useGeoLegend must be used within a GeoLegendProvider");
+    }
+    return context;
+}
+//# sourceMappingURL=GeoLegendContext.js.map

package/esm/next/context/GeoLegendContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GeoLegendContext.js","sourceRoot":"","sources":["../../../src/next/context/GeoLegendContext.tsx"],"names":[],"mappings":";AAAA,gCAAgC;AAEhC,OAAO,EAAa,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AA+DvE,MAAM,gBAAgB,GAAG,aAAa,CAAgC,SAAS,CAAC,CAAC;AAEjF;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAAE,QAAQ,EAA2B;IACnE,MAAM,CAAC,kBAAkB,EAAE,qBAAqB,CAAC,GAAG,QAAQ,CAAW,EAAE,CAAC,CAAC;IAC3E,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC,GAAG,QAAQ,CAAe,KAAK,CAAC,CAAC;IAC1E,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACxD,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAElD,MAAM,gBAAgB,GAAG,CAAC,GAAW,EAAE,OAAiB,EAAE,EAAE;QACxD,qBAAqB,CAAC,CAAC,IAAI,EAAE,EAAE;YAC3B,6DAA6D;YAC7D,yCAAyC;YACzC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACpB,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,GAAG,CAAC,CAAC;YACxD,CAAC;YAED,qCAAqC;YACrC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrB,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC;gBACvD,mFAAmF;gBACnF,IAAI,UAAU,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC3C,OAAO,EAAE,CAAC;gBACd,CAAC;gBACD,OAAO,UAAU,CAAC;YACtB,CAAC;YAED,qCAAqC;YACrC,MAAM,UAAU,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,CAAC;YAClC,4EAA4E;YAC5E,IAAI,UAAU,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC;gBACvC,OAAO,EAAE,CAAC;YACd,CAAC;YACD,OAAO,UAAU,CAAC;QACtB,CAAC,CAAC,CAAC;IACP,CAAC,CAAC;IAEF,OAAO,CACH,KAAC,gBAAgB,CAAC,QAAQ,IACtB,KAAK,EAAE;YACH,kBAAkB;YAClB,qBAAqB;YACrB,gBAAgB;YAChB,cAAc;YACd,iBAAiB;YACjB,YAAY;YACZ,eAAe;YACf,SAAS;YACT,YAAY;SACf,YAEA,QAAQ,GACe,CAC/B,CAAC;AACN,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY;IACxB,MAAM,OAAO,GAAG,UAAU,CAAC,gBAAgB,CAAC,CAAC;IAE7C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC5E,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC"}

package/esm/next/context/GeoPushpinPropsContext.d.ts

@@ -0,0 +1,47 @@
+import { ReactNode } from "react";
+import { IGeoPushpinChartNextConfig } from "../types/config.js";
+import { ICoreGeoPushpinChartNextProps } from "../types/internal.js";
+/**
+ * Provider for GeoPushpinChartNext component props.
+ *
+ * @remarks
+ * This context provides access to all props passed to the GeoPushpinChartNext component
+ * including configuration, data properties, and callback handlers.
+ *
+ * @alpha
+ */
+export declare function GeoPushpinPropsProvider({ children, ...props }: ICoreGeoPushpinChartNextProps & {
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+type WithRequired<T, K extends keyof T> = T & Required<Pick<T, K>>;
+type ConfigDefaults = "points" | "legend";
+type ConfigWithDefaults = WithRequired<IGeoPushpinChartNextConfig, ConfigDefaults>;
+type RootPropsDefaults = "drillableItems" | "filters" | "sortBy" | "config" | "execConfig";
+type RootPropsWithDefaults = WithRequired<ICoreGeoPushpinChartNextProps, RootPropsDefaults>;
+type GeoPushpinPropsWithDefaults = RootPropsWithDefaults & {
+    config: ConfigWithDefaults;
+};
+/**
+ * Applies default values to GeoPushpinChartNext props.
+ *
+ * @param props - The component props
+ * @returns Props with defaults applied
+ *
+ * @alpha
+ */
+export declare function applyGeoPushpinDefaultProps(props: ICoreGeoPushpinChartNextProps): GeoPushpinPropsWithDefaults;
+/**
+ * Hook to access GeoPushpinChartNext component props.
+ *
+ * @remarks
+ * This hook provides access to all component props with default values applied
+ * and deep memoization for stable references across renders.
+ *
+ * @returns Component props with defaults
+ * @throws Error if used outside of GeoPushpinPropsProvider
+ *
+ * @alpha
+ */
+export declare function useGeoPushpinProps(): GeoPushpinPropsWithDefaults;
+export {};
+//# sourceMappingURL=GeoPushpinPropsContext.d.ts.map

package/esm/next/context/GeoPushpinPropsContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GeoPushpinPropsContext.d.ts","sourceRoot":"","sources":["../../../src/next/context/GeoPushpinPropsContext.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAA6B,MAAM,OAAO,CAAC;AAK7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AAIrE;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,EACpC,QAAQ,EACR,GAAG,KAAK,EACX,EAAE,6BAA6B,GAAG;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,2CAEzD;AAED,KAAK,YAAY,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAEnE,KAAK,cAAc,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE1C,KAAK,kBAAkB,GAAG,YAAY,CAAC,0BAA0B,EAAE,cAAc,CAAC,CAAC;AAEnF,KAAK,iBAAiB,GAAG,gBAAgB,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,YAAY,CAAC;AAE3F,KAAK,qBAAqB,GAAG,YAAY,CAAC,6BAA6B,EAAE,iBAAiB,CAAC,CAAC;AAE5F,KAAK,2BAA2B,GAAG,qBAAqB,GAAG;IACvD,MAAM,EAAE,kBAAkB,CAAC;CAC9B,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACvC,KAAK,EAAE,6BAA6B,GACrC,2BAA2B,CAwB7B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,IAAI,2BAA2B,CAmBhE"}

package/esm/next/context/GeoPushpinPropsContext.js

@@ -0,0 +1,81 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// (C) 2025 GoodData Corporation
+import { createContext, useContext } from "react";
+import { useDeepMemo } from "@gooddata/sdk-ui/internal";
+import { EMPTY_DRILLS, EMPTY_FILTERS, EMPTY_OBJECT, EMPTY_SORT_BY } from "../constants/internal.js";
+const GeoPushpinPropsContext = createContext(undefined);
+/**
+ * Provider for GeoPushpinChartNext component props.
+ *
+ * @remarks
+ * This context provides access to all props passed to the GeoPushpinChartNext component
+ * including configuration, data properties, and callback handlers.
+ *
+ * @alpha
+ */
+export function GeoPushpinPropsProvider({ children, ...props }) {
+    return _jsx(GeoPushpinPropsContext.Provider, { value: props, children: children });
+}
+/**
+ * Applies default values to GeoPushpinChartNext props.
+ *
+ * @param props - The component props
+ * @returns Props with defaults applied
+ *
+ * @alpha
+ */
+export function applyGeoPushpinDefaultProps(props) {
+    return {
+        ...props,
+        drillableItems: props.drillableItems ?? EMPTY_DRILLS,
+        filters: props.filters ?? EMPTY_FILTERS,
+        sortBy: props.sortBy ?? EMPTY_SORT_BY,
+        config: {
+            ...(props.config ?? {}),
+            center: props.config?.center,
+            zoom: props.config?.zoom,
+            points: {
+                ...(props.config?.points ?? {}),
+                minSize: props.config?.points?.minSize ?? "normal",
+                maxSize: props.config?.points?.maxSize ?? "normal",
+                groupNearbyPoints: props.config?.points?.groupNearbyPoints ?? true,
+            },
+            legend: {
+                ...(props.config?.legend ?? {}),
+                enabled: props.config?.legend?.enabled ?? true,
+                position: props.config?.legend?.position ?? "top",
+            },
+        },
+        execConfig: props.execConfig ?? EMPTY_OBJECT,
+    };
+}
+/**
+ * Hook to access GeoPushpinChartNext component props.
+ *
+ * @remarks
+ * This hook provides access to all component props with default values applied
+ * and deep memoization for stable references across renders.
+ *
+ * @returns Component props with defaults
+ * @throws Error if used outside of GeoPushpinPropsProvider
+ *
+ * @alpha
+ */
+export function useGeoPushpinProps() {
+    const context = useContext(GeoPushpinPropsContext);
+    const memoizeDeep = useDeepMemo();
+    if (context === undefined) {
+        throw new Error("useGeoPushpinProps must be used within a GeoPushpinPropsProvider");
+    }
+    const baseProps = applyGeoPushpinDefaultProps(context);
+    // Recursively memoize nested properties to maintain stable references
+    return {
+        ...baseProps,
+        drillableItems: memoizeDeep("drillableItems", baseProps.drillableItems),
+        filters: memoizeDeep("filters", baseProps.filters),
+        sortBy: memoizeDeep("sortBy", baseProps.sortBy),
+        execConfig: memoizeDeep("execConfig", baseProps.execConfig),
+        config: memoizeDeep("config", baseProps.config),
+    };
+}
+//# sourceMappingURL=GeoPushpinPropsContext.js.map

package/esm/next/context/GeoPushpinPropsContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GeoPushpinPropsContext.js","sourceRoot":"","sources":["../../../src/next/context/GeoPushpinPropsContext.tsx"],"names":[],"mappings":";AAAA,gCAAgC;AAEhC,OAAO,EAAa,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAE7D,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAIpG,MAAM,sBAAsB,GAAG,aAAa,CAA4C,SAAS,CAAC,CAAC;AAEnG;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CAAC,EACpC,QAAQ,EACR,GAAG,KAAK,EAC8C;IACtD,OAAO,KAAC,sBAAsB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAAmC,CAAC;AACvG,CAAC;AAgBD;;;;;;;GAOG;AACH,MAAM,UAAU,2BAA2B,CACvC,KAAoC;IAEpC,OAAO;QACH,GAAG,KAAK;QACR,cAAc,EAAE,KAAK,CAAC,cAAc,IAAI,YAAY;QACpD,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,aAAa;QACvC,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,aAAa;QACrC,MAAM,EAAE;YACJ,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC;YACvB,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM;YAC5B,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,IAAI;YACxB,MAAM,EAAE;gBACJ,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,IAAI,EAAE,CAAC;gBAC/B,OAAO,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,IAAI,QAAQ;gBAClD,OAAO,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,IAAI,QAAQ;gBAClD,iBAAiB,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,iBAAiB,IAAI,IAAI;aACrE;YACD,MAAM,EAAE;gBACJ,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,IAAI,EAAE,CAAC;gBAC/B,OAAO,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,IAAI,IAAI;gBAC9C,QAAQ,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,IAAI,KAAK;aACpD;SACJ;QACD,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,YAAY;KAC/C,CAAC;AACN,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,kBAAkB;IAC9B,MAAM,OAAO,GAAG,UAAU,CAAC,sBAAsB,CAAC,CAAC;IACnD,MAAM,WAAW,GAAG,WAAW,EAAE,CAAC;IAElC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;IACxF,CAAC;IAED,MAAM,SAAS,GAAG,2BAA2B,CAAC,OAAO,CAAC,CAAC;IAEvD,sEAAsE;IACtE,OAAO;QACH,GAAG,SAAS;QACZ,cAAc,EAAE,WAAW,CAAC,gBAAgB,EAAE,SAAS,CAAC,cAAc,CAAC;QACvE,OAAO,EAAE,WAAW,CAAC,SAAS,EAAE,SAAS,CAAC,OAAO,CAAC;QAClD,MAAM,EAAE,WAAW,CAAC,QAAQ,EAAE,SAAS,CAAC,MAAM,CAAC;QAC/C,UAAU,EAAE,WAAW,CAAC,YAAY,EAAE,SAAS,CAAC,UAAU,CAAC;QAC3D,MAAM,EAAE,WAAW,CAAC,QAAQ,EAAE,SAAS,CAAC,MAAM,CAAC;KAClD,CAAC;AACN,CAAC"}