INIT

2026-02-17 14:10:16 -06:00
parent 2bca5834c5
commit cf73cd3b4c
11246 changed files with 1690552 additions and 0 deletions
@@ -0,0 +1,71 @@
+import { defaultNavigator, } from "../../internal/configurable-globals.js";
+/**
+ * Reactive access to the browser's [Geolocation API](https://developer.mozilla.org/en-US/docs/Web/API/Geolocation_API).
+ *
+ * @see https://runed.dev/docs/utilities/use-geolocation
+ */
+export function useGeolocation(options = {}) {
+    const { enableHighAccuracy = true, maximumAge = 30000, timeout = 27000, immediate = true, navigator = defaultNavigator, } = options;
+    const isSupported = Boolean(navigator);
+    let error = $state.raw(null);
+    let position = $state({
+        timestamp: 0,
+        coords: {
+            accuracy: 0,
+            latitude: Number.POSITIVE_INFINITY,
+            longitude: Number.POSITIVE_INFINITY,
+            altitude: null,
+            altitudeAccuracy: null,
+            heading: null,
+            speed: null,
+        },
+    });
+    let isPaused = $state(false);
+    function updatePosition(_position) {
+        error = null;
+        position.timestamp = _position.timestamp;
+        position.coords.accuracy = _position.coords.accuracy;
+        position.coords.altitude = _position.coords.altitude;
+        position.coords.altitudeAccuracy = _position.coords.altitudeAccuracy;
+        position.coords.heading = _position.coords.heading;
+        position.coords.latitude = _position.coords.latitude;
+        position.coords.longitude = _position.coords.longitude;
+        position.coords.speed = _position.coords.speed;
+    }
+    let watcher;
+    function resume() {
+        if (!navigator)
+            return;
+        watcher = navigator.geolocation.watchPosition(updatePosition, (err) => (error = err), {
+            enableHighAccuracy,
+            maximumAge,
+            timeout,
+        });
+        isPaused = false;
+    }
+    function pause() {
+        if (watcher && navigator) {
+            navigator.geolocation.clearWatch(watcher);
+        }
+        isPaused = true;
+    }
+    $effect(() => {
+        if (immediate)
+            resume();
+        return () => pause();
+    });
+    return {
+        get isSupported() {
+            return isSupported;
+        },
+        position,
+        get error() {
+            return error;
+        },
+        get isPaused() {
+            return isPaused;
+        },
+        resume,
+        pause,
+    };
+}