@trackunit/react-core-hooks 1.12.67 → 1.13.0

package/index.cjs.js

@@ -230,6 +230,99 @@ const useFilterBarContext = () => {
     return context;
 };
 
+const useStandaloneGeolocation = ({ enabled, requestOnMount, }) => {
+    const [position, setPosition] = react.useState(null);
+    const queryGeolocationPermission = react.useCallback(async () => {
+        if (!enabled || typeof navigator === "undefined") {
+            return null;
+        }
+        try {
+            const status = await navigator.permissions.query({ name: "geolocation" });
+            return status.state;
+        }
+        catch {
+            return null;
+        }
+    }, [enabled]);
+    const getCurrentPosition = react.useCallback(async () => {
+        if (!enabled || typeof navigator === "undefined") {
+            return null;
+        }
+        return await new Promise(resolve => {
+            try {
+                navigator.geolocation.getCurrentPosition(currentPosition => {
+                    resolve([currentPosition.coords.longitude, currentPosition.coords.latitude]);
+                }, () => {
+                    resolve(null);
+                });
+            }
+            catch {
+                resolve(null);
+            }
+        });
+    }, [enabled]);
+    const getPosition = react.useCallback(async (options) => {
+        const prompt = options?.prompt !== false;
+        if (!prompt) {
+            const permissionState = await queryGeolocationPermission();
+            if (permissionState !== "granted") {
+                return null;
+            }
+        }
+        const currentPosition = await getCurrentPosition();
+        if (currentPosition !== null) {
+            setPosition(currentPosition);
+        }
+        return currentPosition;
+    }, [getCurrentPosition, queryGeolocationPermission]);
+    react.useEffect(() => {
+        if (!enabled || requestOnMount !== true) {
+            return;
+        }
+        void queryGeolocationPermission()
+            .then(permissionState => {
+            if (permissionState !== "granted") {
+                return null;
+            }
+            return getCurrentPosition();
+        })
+            .then(currentPosition => {
+            if (currentPosition !== null) {
+                setPosition(currentPosition);
+            }
+        });
+    }, [enabled, getCurrentPosition, queryGeolocationPermission, requestOnMount]);
+    return react.useMemo(() => ({
+        position,
+        getPosition,
+    }), [getPosition, position]);
+};
+/**
+ * Hook providing geolocation capabilities.
+ *
+ * In the host, geolocation is resolved directly via the browser API.
+ * In Iris Apps, requests are proxied to the host via the iframe bridge,
+ * so permission is only requested once at the host level.
+ *
+ * @example
+ * ```ts
+ * const { position, getPosition } = useGeolocation();
+ *
+ * // User-initiated request (e.g. "My Location" button)
+ * onClick: () => {
+ *   void getPosition().then(pos => { if (pos) fitBounds(pos); });
+ * }
+ * ```
+ */
+const useGeolocation = (options) => {
+    const context = react.useContext(reactCoreContextsApi.GeolocationContext);
+    const standaloneGeolocation = useStandaloneGeolocation({
+        enabled: context === null,
+        requestOnMount: options?.requestOnMount,
+    });
+    return context ?? standaloneGeolocation;
+};
+
 /**
  * This is a hook to use the TokenContext.
  *
@@ -396,7 +489,7 @@ const resolveAccess = async (context, options) => {
     }
     return context.hasAccessTo(options);
 };
-const INITIAL_STATE = {
+const INITIAL_STATE$1 = {
     status: "loading",
     hasAccess: undefined,
     error: undefined,
@@ -404,7 +497,7 @@ const INITIAL_STATE = {
 const accessReducer = (_state, action) => {
     switch (action.type) {
         case "FETCH_START":
-            return INITIAL_STATE;
+            return INITIAL_STATE$1;
         case "FETCH_SUCCESS":
             return { status: "success", hasAccess: action.hasAccess, error: undefined };
         case "FETCH_ERROR":
@@ -427,7 +520,7 @@ const accessReducer = (_state, action) => {
 const useHasAccessTo = (options) => {
     const context = react.useContext(reactCoreContextsApi.NavigationContext);
     const [stableOptions, setStableOptions] = react.useState(options);
-    const [state, dispatch] = react.useReducer(accessReducer, INITIAL_STATE);
+    const [state, dispatch] = react.useReducer(accessReducer, INITIAL_STATE$1);
     if (!esToolkit.isEqual(stableOptions, options)) {
         setStableOptions(options);
     }
@@ -576,6 +669,17 @@ const useCustomerRuntime = () => {
     return { customerInfo, loading, error };
 };
 
+const eventRuntimeReducer = (_state, action) => {
+    switch (action.type) {
+        case "success":
+            return { status: "success", eventInfo: action.eventInfo };
+        case "error":
+            return { status: "error", error: action.error };
+        default:
+            return _state;
+    }
+};
+const INITIAL_STATE = { status: "loading" };
 /**
  * A hook to expose event runtime for React components
  *
@@ -594,25 +698,17 @@ const useCustomerRuntime = () => {
  * }, [getEventQuery, eventInfo]);
  */
 const useEventRuntime = () => {
-    const [eventInfo, setEventInfo] = react.useState();
-    const [loading, setLoading] = react.useState(true);
-    const [error, setError] = react.useState();
+    const [state, dispatch] = react.useReducer(eventRuntimeReducer, INITIAL_STATE);
     react.useEffect(() => {
-        const getEventInfo = async () => {
-            setLoading(true);
-            try {
-                const updatedEventInfo = await irisAppRuntimeCore.EventRuntime.getEventInfo();
-                setLoading(false);
-                setEventInfo(updatedEventInfo);
-            }
-            catch (e) {
-                setLoading(false);
-                setError(new Error("Failed to get event info"));
-            }
-        };
-        void getEventInfo();
+        void irisAppRuntimeCore.EventRuntime.getEventInfo()
+            .then(eventInfo => dispatch({ type: "success", eventInfo }))
+            .catch(() => dispatch({ type: "error", error: new Error("Failed to get event info") }));
     }, []);
-    return { eventInfo, loading, error };
+    return {
+        eventInfo: state.status === "success" ? state.eventInfo : undefined,
+        loading: state.status === "loading",
+        error: state.status === "error" ? state.error : undefined,
+    };
 };
 
 /**
@@ -981,6 +1077,28 @@ const useWidgetConfigAsync = () => {
     }
     return context;
 };
+const widgetDataReducer = (state, action) => {
+    switch (action.type) {
+        case "dataLoaded":
+            return { ...state, data: action.data, loadingData: false };
+        case "dataVersionLoaded":
+            return { ...state, dataVersion: action.dataVersion };
+        case "titleLoaded":
+            return { ...state, title: action.title };
+        case "dataUpdated":
+            return { ...state, data: action.data, dataVersion: action.dataVersion };
+        case "titleUpdated":
+            return { ...state, title: action.title };
+        default:
+            return state;
+    }
+};
+const INITIAL_WIDGET_DATA_STATE = {
+    data: null,
+    loadingData: true,
+    dataVersion: null,
+    title: null,
+};
 /**
  * This is a hook to use the WidgetConfigContext.
  *
@@ -996,13 +1114,9 @@ const useWidgetConfigAsync = () => {
  */
 const useWidgetConfig = () => {
     const widgetConfigContext = useWidgetConfigAsync();
-    const [data, setData] = react.useState(null);
-    const [loadingData, setLoadingData] = react.useState(true);
-    const [dataVersion, setDataVersion] = react.useState(null);
-    const [title, setTitle] = react.useState(null);
+    const [widgetData, dispatch] = react.useReducer(widgetDataReducer, INITIAL_WIDGET_DATA_STATE);
     const filters = useFilterBarContext();
     const { timeRange } = useTimeRange();
-    // use window.location.hash directly to avoid depending on tanstack router in core-hooks
     const [edit, setEdit] = react.useState(() => window.location.hash.includes("edit=true"));
     react.useEffect(() => {
         const handleHashChange = () => {
@@ -1013,29 +1127,27 @@ const useWidgetConfig = () => {
     }, []);
     const widgetConfigContextRef = react.useRef(widgetConfigContext);
     react.useEffect(() => {
-        void widgetConfigContextRef.current.getData().then(d => {
-            setData(d);
-            setLoadingData(false);
-        });
-        void widgetConfigContextRef.current.getDataVersion().then(dv => setDataVersion(dv));
-        void widgetConfigContextRef.current.getTitle().then(t => setTitle(t));
+        void widgetConfigContextRef.current.getData().then(d => dispatch({ type: "dataLoaded", data: d }));
+        void widgetConfigContextRef.current
+            .getDataVersion()
+            .then(dv => dispatch({ type: "dataVersionLoaded", dataVersion: dv }));
+        void widgetConfigContextRef.current.getTitle().then(t => dispatch({ type: "titleLoaded", title: t }));
     }, []);
     const result = react.useMemo(() => ({
-        data,
+        data: widgetData.data,
         setData: async (newData, newDataVersion) => {
             await widgetConfigContext.setData(newData, newDataVersion);
-            setData(newData);
-            setDataVersion(newDataVersion);
+            dispatch({ type: "dataUpdated", data: newData, dataVersion: newDataVersion });
         },
-        dataVersion,
-        loadingData,
+        dataVersion: widgetData.dataVersion,
+        loadingData: widgetData.loadingData,
         setLoadingState: async (newLoadingState) => {
             await widgetConfigContext.setLoadingState(newLoadingState);
         },
-        title,
+        title: widgetData.title,
         setTitle: async (newTitle) => {
             await widgetConfigContext.setTitle(newTitle);
-            setTitle(newTitle);
+            dispatch({ type: "titleUpdated", title: newTitle });
         },
         filters,
         timeRange,
@@ -1048,13 +1160,25 @@ const useWidgetConfig = () => {
             if (props) {
                 if (props.newData && props.newData.data) {
                     await irisAppRuntimeCore.WidgetConfigRuntime.setWidgetData(props.newData.data, props.newData.dataVersion ?? 1, props.newTitle ?? undefined);
-                    setData(props.newData.data);
-                    setDataVersion(props.newData.dataVersion ?? 1);
+                    dispatch({
+                        type: "dataUpdated",
+                        data: props.newData.data,
+                        dataVersion: props.newData.dataVersion ?? 1,
+                    });
                 }
             }
             await widgetConfigContext.closeEditMode();
         },
-    }), [data, dataVersion, title, filters, timeRange, edit, loadingData, widgetConfigContext]);
+    }), [
+        widgetData.data,
+        widgetData.dataVersion,
+        widgetData.title,
+        filters,
+        timeRange,
+        edit,
+        widgetData.loadingData,
+        widgetConfigContext,
+    ]);
     return result;
 };
 
@@ -1078,6 +1202,7 @@ exports.useExportDataContext = useExportDataContext;
 exports.useFeatureBranchQueryString = useFeatureBranchQueryString;
 exports.useFeatureFlags = useFeatureFlags;
 exports.useFilterBarContext = useFilterBarContext;
+exports.useGeolocation = useGeolocation;
 exports.useHasAccessTo = useHasAccessTo;
 exports.useImageUploader = useImageUploader;
 exports.useIrisAppId = useIrisAppId;

package/index.esm.js

@@ -1,5 +1,5 @@
-import { AnalyticsContext, AssetSortingContext, ConfirmationDialogContext, EnvironmentContext, ErrorHandlingContext, ExportDataContext, FeatureFlagContext, FilterBarContext, TokenContext, ModalDialogContext, NavigationContext, OemBrandingContext, UserSubscriptionContext, TimeRangeContext, ToastContext, CurrentUserContext, CurrentUserPreferenceContext, WidgetConfigContext } from '@trackunit/react-core-contexts-api';
-import { useContext, useMemo, useState, useCallback, useReducer, useEffect, useRef } from 'react';
+import { AnalyticsContext, AssetSortingContext, ConfirmationDialogContext, EnvironmentContext, ErrorHandlingContext, ExportDataContext, FeatureFlagContext, FilterBarContext, GeolocationContext, TokenContext, ModalDialogContext, NavigationContext, OemBrandingContext, UserSubscriptionContext, TimeRangeContext, ToastContext, CurrentUserContext, CurrentUserPreferenceContext, WidgetConfigContext } from '@trackunit/react-core-contexts-api';
+import { useContext, useMemo, useState, useCallback, useEffect, useReducer, useRef } from 'react';
 import { isEqual } from 'es-toolkit';
 import { AssetRuntime, CustomerRuntime, EventRuntime, ParamsRuntime, SiteRuntime, WidgetConfigRuntime } from '@trackunit/iris-app-runtime-core';
 
@@ -228,6 +228,99 @@ const useFilterBarContext = () => {
     return context;
 };
 
+const useStandaloneGeolocation = ({ enabled, requestOnMount, }) => {
+    const [position, setPosition] = useState(null);
+    const queryGeolocationPermission = useCallback(async () => {
+        if (!enabled || typeof navigator === "undefined") {
+            return null;
+        }
+        try {
+            const status = await navigator.permissions.query({ name: "geolocation" });
+            return status.state;
+        }
+        catch {
+            return null;
+        }
+    }, [enabled]);
+    const getCurrentPosition = useCallback(async () => {
+        if (!enabled || typeof navigator === "undefined") {
+            return null;
+        }
+        return await new Promise(resolve => {
+            try {
+                navigator.geolocation.getCurrentPosition(currentPosition => {
+                    resolve([currentPosition.coords.longitude, currentPosition.coords.latitude]);
+                }, () => {
+                    resolve(null);
+                });
+            }
+            catch {
+                resolve(null);
+            }
+        });
+    }, [enabled]);
+    const getPosition = useCallback(async (options) => {
+        const prompt = options?.prompt !== false;
+        if (!prompt) {
+            const permissionState = await queryGeolocationPermission();
+            if (permissionState !== "granted") {
+                return null;
+            }
+        }
+        const currentPosition = await getCurrentPosition();
+        if (currentPosition !== null) {
+            setPosition(currentPosition);
+        }
+        return currentPosition;
+    }, [getCurrentPosition, queryGeolocationPermission]);
+    useEffect(() => {
+        if (!enabled || requestOnMount !== true) {
+            return;
+        }
+        void queryGeolocationPermission()
+            .then(permissionState => {
+            if (permissionState !== "granted") {
+                return null;
+            }
+            return getCurrentPosition();
+        })
+            .then(currentPosition => {
+            if (currentPosition !== null) {
+                setPosition(currentPosition);
+            }
+        });
+    }, [enabled, getCurrentPosition, queryGeolocationPermission, requestOnMount]);
+    return useMemo(() => ({
+        position,
+        getPosition,
+    }), [getPosition, position]);
+};
+/**
+ * Hook providing geolocation capabilities.
+ *
+ * In the host, geolocation is resolved directly via the browser API.
+ * In Iris Apps, requests are proxied to the host via the iframe bridge,
+ * so permission is only requested once at the host level.
+ *
+ * @example
+ * ```ts
+ * const { position, getPosition } = useGeolocation();
+ *
+ * // User-initiated request (e.g. "My Location" button)
+ * onClick: () => {
+ *   void getPosition().then(pos => { if (pos) fitBounds(pos); });
+ * }
+ * ```
+ */
+const useGeolocation = (options) => {
+    const context = useContext(GeolocationContext);
+    const standaloneGeolocation = useStandaloneGeolocation({
+        enabled: context === null,
+        requestOnMount: options?.requestOnMount,
+    });
+    return context ?? standaloneGeolocation;
+};
+
 /**
  * This is a hook to use the TokenContext.
  *
@@ -394,7 +487,7 @@ const resolveAccess = async (context, options) => {
     }
     return context.hasAccessTo(options);
 };
-const INITIAL_STATE = {
+const INITIAL_STATE$1 = {
     status: "loading",
     hasAccess: undefined,
     error: undefined,
@@ -402,7 +495,7 @@ const INITIAL_STATE = {
 const accessReducer = (_state, action) => {
     switch (action.type) {
         case "FETCH_START":
-            return INITIAL_STATE;
+            return INITIAL_STATE$1;
         case "FETCH_SUCCESS":
             return { status: "success", hasAccess: action.hasAccess, error: undefined };
         case "FETCH_ERROR":
@@ -425,7 +518,7 @@ const accessReducer = (_state, action) => {
 const useHasAccessTo = (options) => {
     const context = useContext(NavigationContext);
     const [stableOptions, setStableOptions] = useState(options);
-    const [state, dispatch] = useReducer(accessReducer, INITIAL_STATE);
+    const [state, dispatch] = useReducer(accessReducer, INITIAL_STATE$1);
     if (!isEqual(stableOptions, options)) {
         setStableOptions(options);
     }
@@ -574,6 +667,17 @@ const useCustomerRuntime = () => {
     return { customerInfo, loading, error };
 };
 
+const eventRuntimeReducer = (_state, action) => {
+    switch (action.type) {
+        case "success":
+            return { status: "success", eventInfo: action.eventInfo };
+        case "error":
+            return { status: "error", error: action.error };
+        default:
+            return _state;
+    }
+};
+const INITIAL_STATE = { status: "loading" };
 /**
  * A hook to expose event runtime for React components
  *
@@ -592,25 +696,17 @@ const useCustomerRuntime = () => {
  * }, [getEventQuery, eventInfo]);
  */
 const useEventRuntime = () => {
-    const [eventInfo, setEventInfo] = useState();
-    const [loading, setLoading] = useState(true);
-    const [error, setError] = useState();
+    const [state, dispatch] = useReducer(eventRuntimeReducer, INITIAL_STATE);
     useEffect(() => {
-        const getEventInfo = async () => {
-            setLoading(true);
-            try {
-                const updatedEventInfo = await EventRuntime.getEventInfo();
-                setLoading(false);
-                setEventInfo(updatedEventInfo);
-            }
-            catch (e) {
-                setLoading(false);
-                setError(new Error("Failed to get event info"));
-            }
-        };
-        void getEventInfo();
+        void EventRuntime.getEventInfo()
+            .then(eventInfo => dispatch({ type: "success", eventInfo }))
+            .catch(() => dispatch({ type: "error", error: new Error("Failed to get event info") }));
     }, []);
-    return { eventInfo, loading, error };
+    return {
+        eventInfo: state.status === "success" ? state.eventInfo : undefined,
+        loading: state.status === "loading",
+        error: state.status === "error" ? state.error : undefined,
+    };
 };
 
 /**
@@ -979,6 +1075,28 @@ const useWidgetConfigAsync = () => {
     }
     return context;
 };
+const widgetDataReducer = (state, action) => {
+    switch (action.type) {
+        case "dataLoaded":
+            return { ...state, data: action.data, loadingData: false };
+        case "dataVersionLoaded":
+            return { ...state, dataVersion: action.dataVersion };
+        case "titleLoaded":
+            return { ...state, title: action.title };
+        case "dataUpdated":
+            return { ...state, data: action.data, dataVersion: action.dataVersion };
+        case "titleUpdated":
+            return { ...state, title: action.title };
+        default:
+            return state;
+    }
+};
+const INITIAL_WIDGET_DATA_STATE = {
+    data: null,
+    loadingData: true,
+    dataVersion: null,
+    title: null,
+};
 /**
  * This is a hook to use the WidgetConfigContext.
  *
@@ -994,13 +1112,9 @@ const useWidgetConfigAsync = () => {
  */
 const useWidgetConfig = () => {
     const widgetConfigContext = useWidgetConfigAsync();
-    const [data, setData] = useState(null);
-    const [loadingData, setLoadingData] = useState(true);
-    const [dataVersion, setDataVersion] = useState(null);
-    const [title, setTitle] = useState(null);
+    const [widgetData, dispatch] = useReducer(widgetDataReducer, INITIAL_WIDGET_DATA_STATE);
     const filters = useFilterBarContext();
     const { timeRange } = useTimeRange();
-    // use window.location.hash directly to avoid depending on tanstack router in core-hooks
     const [edit, setEdit] = useState(() => window.location.hash.includes("edit=true"));
     useEffect(() => {
         const handleHashChange = () => {
@@ -1011,29 +1125,27 @@ const useWidgetConfig = () => {
     }, []);
     const widgetConfigContextRef = useRef(widgetConfigContext);
     useEffect(() => {
-        void widgetConfigContextRef.current.getData().then(d => {
-            setData(d);
-            setLoadingData(false);
-        });
-        void widgetConfigContextRef.current.getDataVersion().then(dv => setDataVersion(dv));
-        void widgetConfigContextRef.current.getTitle().then(t => setTitle(t));
+        void widgetConfigContextRef.current.getData().then(d => dispatch({ type: "dataLoaded", data: d }));
+        void widgetConfigContextRef.current
+            .getDataVersion()
+            .then(dv => dispatch({ type: "dataVersionLoaded", dataVersion: dv }));
+        void widgetConfigContextRef.current.getTitle().then(t => dispatch({ type: "titleLoaded", title: t }));
     }, []);
     const result = useMemo(() => ({
-        data,
+        data: widgetData.data,
         setData: async (newData, newDataVersion) => {
             await widgetConfigContext.setData(newData, newDataVersion);
-            setData(newData);
-            setDataVersion(newDataVersion);
+            dispatch({ type: "dataUpdated", data: newData, dataVersion: newDataVersion });
         },
-        dataVersion,
-        loadingData,
+        dataVersion: widgetData.dataVersion,
+        loadingData: widgetData.loadingData,
         setLoadingState: async (newLoadingState) => {
             await widgetConfigContext.setLoadingState(newLoadingState);
         },
-        title,
+        title: widgetData.title,
         setTitle: async (newTitle) => {
             await widgetConfigContext.setTitle(newTitle);
-            setTitle(newTitle);
+            dispatch({ type: "titleUpdated", title: newTitle });
         },
         filters,
         timeRange,
@@ -1046,14 +1158,26 @@ const useWidgetConfig = () => {
             if (props) {
                 if (props.newData && props.newData.data) {
                     await WidgetConfigRuntime.setWidgetData(props.newData.data, props.newData.dataVersion ?? 1, props.newTitle ?? undefined);
-                    setData(props.newData.data);
-                    setDataVersion(props.newData.dataVersion ?? 1);
+                    dispatch({
+                        type: "dataUpdated",
+                        data: props.newData.data,
+                        dataVersion: props.newData.dataVersion ?? 1,
+                    });
                 }
             }
             await widgetConfigContext.closeEditMode();
         },
-    }), [data, dataVersion, title, filters, timeRange, edit, loadingData, widgetConfigContext]);
+    }), [
+        widgetData.data,
+        widgetData.dataVersion,
+        widgetData.title,
+        filters,
+        timeRange,
+        edit,
+        widgetData.loadingData,
+        widgetConfigContext,
+    ]);
     return result;
 };
 
-export { fetchAssetBlobUrl, useAnalytics, useAssetRuntime, useAssetSorting, useConfirmationDialog, useCurrentUser, useCurrentUserFavoriteAdvancedSensors, useCurrentUserFavoriteInsights, useCurrentUserLanguage, useCurrentUserSystemOfMeasurement, useCurrentUserTimeZonePreference, useCustomerRuntime, useEnvironment, useErrorHandler, useErrorHandlerOrNull, useEventRuntime, useExportDataContext, useFeatureBranchQueryString, useFeatureFlags, useFilterBarContext, useHasAccessTo, useImageUploader, useIrisAppId, useIrisAppImage, useIrisAppName, useModalDialogContext, useNavigateInHost, useOemBrandingContext, useSiteRuntime, useTimeRange, useToast, useToken, useUserPermission, useUserSubscription, useWidgetConfig, useWidgetConfigAsync };
+export { fetchAssetBlobUrl, useAnalytics, useAssetRuntime, useAssetSorting, useConfirmationDialog, useCurrentUser, useCurrentUserFavoriteAdvancedSensors, useCurrentUserFavoriteInsights, useCurrentUserLanguage, useCurrentUserSystemOfMeasurement, useCurrentUserTimeZonePreference, useCustomerRuntime, useEnvironment, useErrorHandler, useErrorHandlerOrNull, useEventRuntime, useExportDataContext, useFeatureBranchQueryString, useFeatureFlags, useFilterBarContext, useGeolocation, useHasAccessTo, useImageUploader, useIrisAppId, useIrisAppImage, useIrisAppName, useModalDialogContext, useNavigateInHost, useOemBrandingContext, useSiteRuntime, useTimeRange, useToast, useToken, useUserPermission, useUserSubscription, useWidgetConfig, useWidgetConfigAsync };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trackunit/react-core-hooks",
-  "version": "1.12.67",
+  "version": "1.13.0",
   "repository": "https://github.com/Trackunit/manager",
   "license": "SEE LICENSE IN LICENSE.txt",
   "engines": {
@@ -9,9 +9,9 @@
   "dependencies": {
     "react": "19.0.0",
     "es-toolkit": "^1.39.10",
-    "@trackunit/iris-app-runtime-core": "1.13.60",
-    "@trackunit/iris-app-runtime-core-api": "1.12.57",
-    "@trackunit/react-core-contexts-api": "1.13.58"
+    "@trackunit/iris-app-runtime-core": "1.14.0",
+    "@trackunit/iris-app-runtime-core-api": "1.13.0",
+    "@trackunit/react-core-contexts-api": "1.14.0"
   },
   "module": "./index.esm.js",
   "main": "./index.cjs.js",

package/src/geolocation/useGeolocation.d.ts

@@ -0,0 +1,23 @@
+import { type GeolocationContextValue } from "@trackunit/react-core-contexts-api";
+type UseGeolocationOptions = Readonly<{
+    requestOnMount?: boolean;
+}>;
+/**
+ * Hook providing geolocation capabilities.
+ *
+ * In the host, geolocation is resolved directly via the browser API.
+ * In Iris Apps, requests are proxied to the host via the iframe bridge,
+ * so permission is only requested once at the host level.
+ *
+ * @example
+ * ```ts
+ * const { position, getPosition } = useGeolocation();
+ *
+ * // User-initiated request (e.g. "My Location" button)
+ * onClick: () => {
+ *   void getPosition().then(pos => { if (pos) fitBounds(pos); });
+ * }
+ * ```
+ */
+export declare const useGeolocation: (options?: UseGeolocationOptions) => GeolocationContextValue;
+export {};

package/src/index.d.ts

@@ -7,6 +7,7 @@ export * from "./exportData/useExportDataContext";
 export * from "./featureFlags/useFeatureFlags";
 export * from "./fetchAssetBlobUrl";
 export * from "./filterBar/useFilterBarContext";
+export * from "./geolocation/useGeolocation";
 export * from "./images/useImageUploader";
 export * from "./images/useIrisAppImage";
 export * from "./modalDialog/useModalDialogContext";