tempest-react-sdk 0.23.0 → 0.25.0

package/dist/geo/bounds.js

@@ -1,28 +1,31 @@
-function d(t) {
-  if (t.length === 0) return null;
-  let i = t[0].latitude, u = t[0].latitude, a = t[0].longitude, n = t[0].longitude;
-  for (const e of t)
-    e.latitude < i && (i = e.latitude), e.latitude > u && (u = e.latitude), e.longitude < a && (a = e.longitude), e.longitude > n && (n = e.longitude);
-  return { minLatitude: i, maxLatitude: u, minLongitude: a, maxLongitude: n };
+//#region src/geo/bounds.ts
+function e(e) {
+	if (e.length === 0) return null;
+	let t = e[0].latitude, n = e[0].latitude, r = e[0].longitude, i = e[0].longitude;
+	for (let a of e) a.latitude < t && (t = a.latitude), a.latitude > n && (n = a.latitude), a.longitude < r && (r = a.longitude), a.longitude > i && (i = a.longitude);
+	return {
+		minLatitude: t,
+		maxLatitude: n,
+		minLongitude: r,
+		maxLongitude: i
+	};
 }
-function l(t) {
-  return {
-    latitude: (t.minLatitude + t.maxLatitude) / 2,
-    longitude: (t.minLongitude + t.maxLongitude) / 2
-  };
+function t(e) {
+	return {
+		latitude: (e.minLatitude + e.maxLatitude) / 2,
+		longitude: (e.minLongitude + e.maxLongitude) / 2
+	};
 }
-function m(t, i = 0.1) {
-  const u = t.maxLatitude - t.minLatitude, a = t.maxLongitude - t.minLongitude, n = u * i || 1e-3, e = a * i || 1e-3;
-  return {
-    minLatitude: t.minLatitude - n,
-    maxLatitude: t.maxLatitude + n,
-    minLongitude: t.minLongitude - e,
-    maxLongitude: t.maxLongitude + e
-  };
+function n(e, t = .1) {
+	let n = e.maxLatitude - e.minLatitude, r = e.maxLongitude - e.minLongitude, i = n * t || .001, a = r * t || .001;
+	return {
+		minLatitude: e.minLatitude - i,
+		maxLatitude: e.maxLatitude + i,
+		minLongitude: e.minLongitude - a,
+		maxLongitude: e.maxLongitude + a
+	};
 }
-export {
-  d as boundingBox,
-  l as boundsCenter,
-  m as expandBounds
-};
-//# sourceMappingURL=bounds.js.map
+//#endregion
+export { e as boundingBox, t as boundsCenter, n as expandBounds };
+
+//# sourceMappingURL=bounds.js.map

package/dist/geo/bounds.js.map

@@ -1 +1 @@
-{"version":3,"file":"bounds.js","sources":["../../src/geo/bounds.ts"],"sourcesContent":["import type { Coordinate, GeoBounds } from \"./types\";\n\n/**\n * Compute the axis-aligned bounding box that contains every point. Returns\n * `null` for an empty list (there is nothing to bound).\n *\n * @param points - Coordinates to enclose.\n * @returns The bounds, or `null` when `points` is empty.\n */\nexport function boundingBox(points: readonly Coordinate[]): GeoBounds | null {\n    if (points.length === 0) return null;\n\n    let minLatitude = points[0].latitude;\n    let maxLatitude = points[0].latitude;\n    let minLongitude = points[0].longitude;\n    let maxLongitude = points[0].longitude;\n\n    for (const point of points) {\n        if (point.latitude < minLatitude) minLatitude = point.latitude;\n        if (point.latitude > maxLatitude) maxLatitude = point.latitude;\n        if (point.longitude < minLongitude) minLongitude = point.longitude;\n        if (point.longitude > maxLongitude) maxLongitude = point.longitude;\n    }\n\n    return { minLatitude, maxLatitude, minLongitude, maxLongitude };\n}\n\n/** Geometric center of a bounding box. */\nexport function boundsCenter(bounds: GeoBounds): Coordinate {\n    return {\n        latitude: (bounds.minLatitude + bounds.maxLatitude) / 2,\n        longitude: (bounds.minLongitude + bounds.maxLongitude) / 2,\n    };\n}\n\n/**\n * Grow a bounding box outward by `ratio` of its own span on every side, with a\n * small absolute floor so a single-point (zero-span) box still gets padding.\n * A `ratio` of `0.1` adds 10% margin — handy so a plotted trajectory does not\n * hug the edge of the viewport.\n *\n * @param bounds - The box to expand.\n * @param ratio - Fraction of the span to add per side. Default: `0.1`.\n * @returns A new, larger {@link GeoBounds}.\n */\nexport function expandBounds(bounds: GeoBounds, ratio = 0.1): GeoBounds {\n    const latSpan = bounds.maxLatitude - bounds.minLatitude;\n    const lonSpan = bounds.maxLongitude - bounds.minLongitude;\n    const latPad = latSpan * ratio || 0.001;\n    const lonPad = lonSpan * ratio || 0.001;\n\n    return {\n        minLatitude: bounds.minLatitude - latPad,\n        maxLatitude: bounds.maxLatitude + latPad,\n        minLongitude: bounds.minLongitude - lonPad,\n        maxLongitude: bounds.maxLongitude + lonPad,\n    };\n}\n"],"names":["boundingBox","points","minLatitude","maxLatitude","minLongitude","maxLongitude","point","boundsCenter","bounds","expandBounds","ratio","latSpan","lonSpan","latPad","lonPad"],"mappings":"AASO,SAASA,EAAYC,GAAiD;AACzE,MAAIA,EAAO,WAAW,EAAG,QAAO;AAEhC,MAAIC,IAAcD,EAAO,CAAC,EAAE,UACxBE,IAAcF,EAAO,CAAC,EAAE,UACxBG,IAAeH,EAAO,CAAC,EAAE,WACzBI,IAAeJ,EAAO,CAAC,EAAE;AAE7B,aAAWK,KAASL;AAChB,IAAIK,EAAM,WAAWJ,MAAaA,IAAcI,EAAM,WAClDA,EAAM,WAAWH,MAAaA,IAAcG,EAAM,WAClDA,EAAM,YAAYF,MAAcA,IAAeE,EAAM,YACrDA,EAAM,YAAYD,MAAcA,IAAeC,EAAM;AAG7D,SAAO,EAAE,aAAAJ,GAAa,aAAAC,GAAa,cAAAC,GAAc,cAAAC,EAAA;AACrD;AAGO,SAASE,EAAaC,GAA+B;AACxD,SAAO;AAAA,IACH,WAAWA,EAAO,cAAcA,EAAO,eAAe;AAAA,IACtD,YAAYA,EAAO,eAAeA,EAAO,gBAAgB;AAAA,EAAA;AAEjE;AAYO,SAASC,EAAaD,GAAmBE,IAAQ,KAAgB;AACpE,QAAMC,IAAUH,EAAO,cAAcA,EAAO,aACtCI,IAAUJ,EAAO,eAAeA,EAAO,cACvCK,IAASF,IAAUD,KAAS,MAC5BI,IAASF,IAAUF,KAAS;AAElC,SAAO;AAAA,IACH,aAAaF,EAAO,cAAcK;AAAA,IAClC,aAAaL,EAAO,cAAcK;AAAA,IAClC,cAAcL,EAAO,eAAeM;AAAA,IACpC,cAAcN,EAAO,eAAeM;AAAA,EAAA;AAE5C;"}
+{"version":3,"file":"bounds.js","names":[],"sources":["../../src/geo/bounds.ts"],"sourcesContent":["import type { Coordinate, GeoBounds } from \"./types\";\n\n/**\n * Compute the axis-aligned bounding box that contains every point. Returns\n * `null` for an empty list (there is nothing to bound).\n *\n * @param points - Coordinates to enclose.\n * @returns The bounds, or `null` when `points` is empty.\n */\nexport function boundingBox(points: readonly Coordinate[]): GeoBounds | null {\n    if (points.length === 0) return null;\n\n    let minLatitude = points[0].latitude;\n    let maxLatitude = points[0].latitude;\n    let minLongitude = points[0].longitude;\n    let maxLongitude = points[0].longitude;\n\n    for (const point of points) {\n        if (point.latitude < minLatitude) minLatitude = point.latitude;\n        if (point.latitude > maxLatitude) maxLatitude = point.latitude;\n        if (point.longitude < minLongitude) minLongitude = point.longitude;\n        if (point.longitude > maxLongitude) maxLongitude = point.longitude;\n    }\n\n    return { minLatitude, maxLatitude, minLongitude, maxLongitude };\n}\n\n/** Geometric center of a bounding box. */\nexport function boundsCenter(bounds: GeoBounds): Coordinate {\n    return {\n        latitude: (bounds.minLatitude + bounds.maxLatitude) / 2,\n        longitude: (bounds.minLongitude + bounds.maxLongitude) / 2,\n    };\n}\n\n/**\n * Grow a bounding box outward by `ratio` of its own span on every side, with a\n * small absolute floor so a single-point (zero-span) box still gets padding.\n * A `ratio` of `0.1` adds 10% margin — handy so a plotted trajectory does not\n * hug the edge of the viewport.\n *\n * @param bounds - The box to expand.\n * @param ratio - Fraction of the span to add per side. Default: `0.1`.\n * @returns A new, larger {@link GeoBounds}.\n */\nexport function expandBounds(bounds: GeoBounds, ratio = 0.1): GeoBounds {\n    const latSpan = bounds.maxLatitude - bounds.minLatitude;\n    const lonSpan = bounds.maxLongitude - bounds.minLongitude;\n    const latPad = latSpan * ratio || 0.001;\n    const lonPad = lonSpan * ratio || 0.001;\n\n    return {\n        minLatitude: bounds.minLatitude - latPad,\n        maxLatitude: bounds.maxLatitude + latPad,\n        minLongitude: bounds.minLongitude - lonPad,\n        maxLongitude: bounds.maxLongitude + lonPad,\n    };\n}\n"],"mappings":";AASA,SAAgB,EAAY,GAAiD;CACzE,IAAI,EAAO,WAAW,GAAG,OAAO;CAEhC,IAAI,IAAc,EAAO,EAAE,CAAC,UACxB,IAAc,EAAO,EAAE,CAAC,UACxB,IAAe,EAAO,EAAE,CAAC,WACzB,IAAe,EAAO,EAAE,CAAC;CAE7B,KAAK,IAAM,KAAS,GAIhB,AAHI,EAAM,WAAW,MAAa,IAAc,EAAM,WAClD,EAAM,WAAW,MAAa,IAAc,EAAM,WAClD,EAAM,YAAY,MAAc,IAAe,EAAM,YACrD,EAAM,YAAY,MAAc,IAAe,EAAM;CAG7D,OAAO;EAAE;EAAa;EAAa;EAAc;CAAa;AAClE;AAGA,SAAgB,EAAa,GAA+B;CACxD,OAAO;EACH,WAAW,EAAO,cAAc,EAAO,eAAe;EACtD,YAAY,EAAO,eAAe,EAAO,gBAAgB;CAC7D;AACJ;AAYA,SAAgB,EAAa,GAAmB,IAAQ,IAAgB;CACpE,IAAM,IAAU,EAAO,cAAc,EAAO,aACtC,IAAU,EAAO,eAAe,EAAO,cACvC,IAAS,IAAU,KAAS,MAC5B,IAAS,IAAU,KAAS;CAElC,OAAO;EACH,aAAa,EAAO,cAAc;EAClC,aAAa,EAAO,cAAc;EAClC,cAAc,EAAO,eAAe;EACpC,cAAc,EAAO,eAAe;CACxC;AACJ"}

package/dist/geo/create-position-tracker.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const S=require("./distance.cjs");function k(g={}){const{minDistanceKm:f=.005,maxPoints:l=1/0,positionOptions:p,onUpdate:u,onError:m,onStatusChange:h}=g;let n=[],r=0,o=null,e=null,a="idle";function i(t){a!==t&&(a=t,h?.(t))}function v(t){const c={latitude:t.coords.latitude,longitude:t.coords.longitude,timestamp:t.timestamp,accuracy:t.coords.accuracy};if(o){const d=S.haversineKm(o,c);if(d<f)return;r+=d}o=c,n.push(c),n.length>l&&(n=n.slice(n.length-l)),u?.(n)}function y(t){i("error"),m?.(t)}function P(){if(e===null){if(typeof navigator>"u"||!navigator.geolocation){i("error");return}i("tracking"),e=navigator.geolocation.watchPosition(v,y,p)}}function s(){e!==null&&typeof navigator<"u"&&navigator.geolocation&&navigator.geolocation.clearWatch(e),e=null,i("idle")}function K(){s(),n=[],r=0,o=null,u?.(n)}return{start:P,stop:s,clear:K,get points(){return n},get distanceKm(){return r},get status(){return a}}}exports.createPositionTracker=k;
-//# sourceMappingURL=create-position-tracker.cjs.map
+const e=require("./distance.cjs");function t(t={}){let{minDistanceKm:n=.005,maxPoints:r=1/0,positionOptions:i,onUpdate:a,onError:o,onStatusChange:s}=t,c=[],l=0,u=null,d=null,f=`idle`;function p(e){f!==e&&(f=e,s?.(e))}function m(t){let i={latitude:t.coords.latitude,longitude:t.coords.longitude,timestamp:t.timestamp,accuracy:t.coords.accuracy};if(u){let t=e.haversineKm(u,i);if(t<n)return;l+=t}u=i,c.push(i),c.length>r&&(c=c.slice(c.length-r)),a?.(c)}function h(e){p(`error`),o?.(e)}function g(){if(d===null){if(typeof navigator>`u`||!navigator.geolocation){p(`error`);return}p(`tracking`),d=navigator.geolocation.watchPosition(m,h,i)}}function _(){d!==null&&typeof navigator<`u`&&navigator.geolocation&&navigator.geolocation.clearWatch(d),d=null,p(`idle`)}function v(){_(),c=[],l=0,u=null,a?.(c)}return{start:g,stop:_,clear:v,get points(){return c},get distanceKm(){return l},get status(){return f}}}exports.createPositionTracker=t;
+//# sourceMappingURL=create-position-tracker.cjs.map

package/dist/geo/create-position-tracker.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"create-position-tracker.cjs","sources":["../../src/geo/create-position-tracker.ts"],"sourcesContent":["import { haversineKm } from \"./distance\";\nimport type { TrackPoint } from \"./types\";\n\n/** Lifecycle status of a {@link PositionTracker}. */\nexport type TrackerStatus = \"idle\" | \"tracking\" | \"error\";\n\n/** Options for {@link createPositionTracker}. */\nexport interface CreatePositionTrackerOptions {\n    /**\n     * Discard a new sample when it is closer than this (in km) to the last\n     * kept point — filters GPS jitter while standing still. Default: `0.005`\n     * (5 meters). Pass `0` to keep every sample.\n     */\n    minDistanceKm?: number;\n    /**\n     * Cap the retained trajectory to the most recent N points (older points are\n     * dropped, but their distance stays counted). Default: `Infinity`.\n     */\n    maxPoints?: number;\n    /** Forwarded to `navigator.geolocation.watchPosition`. */\n    positionOptions?: PositionOptions;\n    /** Called with the full trajectory each time a point is added. */\n    onUpdate?: (points: readonly TrackPoint[]) => void;\n    /** Called on a `GeolocationPositionError`. */\n    onError?: (error: GeolocationPositionError) => void;\n    /** Called whenever the status changes. */\n    onStatusChange?: (status: TrackerStatus) => void;\n}\n\n/** Imperative controller returned by {@link createPositionTracker}. */\nexport interface PositionTracker {\n    /** Begin watching position. No-op if already tracking. */\n    start: () => void;\n    /** Stop watching. Retains the recorded trajectory. */\n    stop: () => void;\n    /** Stop and discard the recorded trajectory. */\n    clear: () => void;\n    /** Snapshot of the recorded trajectory (newest last). */\n    readonly points: readonly TrackPoint[];\n    /** Total distance of the recorded trajectory in kilometers. */\n    readonly distanceKm: number;\n    /** Current tracker status. */\n    readonly status: TrackerStatus;\n}\n\n/**\n * Record a live GPS trajectory from `navigator.geolocation.watchPosition`.\n * Framework-free — the {@link usePositionTracker} hook wraps this for React.\n *\n * Jitter while stationary is filtered by `minDistanceKm`; distance is\n * accumulated across the *full* run even when `maxPoints` trims the retained\n * array. 100% browser-side: no network, no external service.\n *\n * @param options - Filtering, retention and callbacks.\n * @returns A controller with `start`/`stop`/`clear` and live getters.\n *\n * @example\n * const tracker = createPositionTracker({\n *   minDistanceKm: 0.01,\n *   onUpdate: (pts) => console.log(pts.length, \"points\"),\n * });\n * tracker.start();\n * // …later\n * tracker.stop();\n * console.log(tracker.distanceKm);\n */\nexport function createPositionTracker(options: CreatePositionTrackerOptions = {}): PositionTracker {\n    const {\n        minDistanceKm = 0.005,\n        maxPoints = Infinity,\n        positionOptions,\n        onUpdate,\n        onError,\n        onStatusChange,\n    } = options;\n\n    let points: TrackPoint[] = [];\n    let distanceKm = 0;\n    let lastKept: TrackPoint | null = null;\n    let watchId: number | null = null;\n    let status: TrackerStatus = \"idle\";\n\n    function setStatus(next: TrackerStatus): void {\n        if (status === next) return;\n        status = next;\n        onStatusChange?.(next);\n    }\n\n    function handlePosition(position: GeolocationPosition): void {\n        const point: TrackPoint = {\n            latitude: position.coords.latitude,\n            longitude: position.coords.longitude,\n            timestamp: position.timestamp,\n            accuracy: position.coords.accuracy,\n        };\n\n        if (lastKept) {\n            const step = haversineKm(lastKept, point);\n            if (step < minDistanceKm) return;\n            distanceKm += step;\n        }\n\n        lastKept = point;\n        points.push(point);\n        if (points.length > maxPoints) {\n            points = points.slice(points.length - maxPoints);\n        }\n        onUpdate?.(points);\n    }\n\n    function handleError(error: GeolocationPositionError): void {\n        setStatus(\"error\");\n        onError?.(error);\n    }\n\n    function start(): void {\n        if (watchId !== null) return;\n        if (typeof navigator === \"undefined\" || !navigator.geolocation) {\n            setStatus(\"error\");\n            return;\n        }\n        setStatus(\"tracking\");\n        watchId = navigator.geolocation.watchPosition(handlePosition, handleError, positionOptions);\n    }\n\n    function stop(): void {\n        if (watchId !== null && typeof navigator !== \"undefined\" && navigator.geolocation) {\n            navigator.geolocation.clearWatch(watchId);\n        }\n        watchId = null;\n        setStatus(\"idle\");\n    }\n\n    function clear(): void {\n        stop();\n        points = [];\n        distanceKm = 0;\n        lastKept = null;\n        onUpdate?.(points);\n    }\n\n    return {\n        start,\n        stop,\n        clear,\n        get points() {\n            return points;\n        },\n        get distanceKm() {\n            return distanceKm;\n        },\n        get status() {\n            return status;\n        },\n    };\n}\n"],"names":["createPositionTracker","options","minDistanceKm","maxPoints","positionOptions","onUpdate","onError","onStatusChange","points","distanceKm","lastKept","watchId","status","setStatus","next","handlePosition","position","point","step","haversineKm","handleError","error","start","stop","clear"],"mappings":"kHAkEO,SAASA,EAAsBC,EAAwC,GAAqB,CAC/F,KAAM,CACF,cAAAC,EAAgB,KAChB,UAAAC,EAAY,IACZ,gBAAAC,EACA,SAAAC,EACA,QAAAC,EACA,eAAAC,CAAA,EACAN,EAEJ,IAAIO,EAAuB,CAAA,EACvBC,EAAa,EACbC,EAA8B,KAC9BC,EAAyB,KACzBC,EAAwB,OAE5B,SAASC,EAAUC,EAA2B,CACtCF,IAAWE,IACfF,EAASE,EACTP,IAAiBO,CAAI,EACzB,CAEA,SAASC,EAAeC,EAAqC,CACzD,MAAMC,EAAoB,CACtB,SAAUD,EAAS,OAAO,SAC1B,UAAWA,EAAS,OAAO,UAC3B,UAAWA,EAAS,UACpB,SAAUA,EAAS,OAAO,QAAA,EAG9B,GAAIN,EAAU,CACV,MAAMQ,EAAOC,EAAAA,YAAYT,EAAUO,CAAK,EACxC,GAAIC,EAAOhB,EAAe,OAC1BO,GAAcS,CAClB,CAEAR,EAAWO,EACXT,EAAO,KAAKS,CAAK,EACbT,EAAO,OAASL,IAChBK,EAASA,EAAO,MAAMA,EAAO,OAASL,CAAS,GAEnDE,IAAWG,CAAM,CACrB,CAEA,SAASY,EAAYC,EAAuC,CACxDR,EAAU,OAAO,EACjBP,IAAUe,CAAK,CACnB,CAEA,SAASC,GAAc,CACnB,GAAIX,IAAY,KAChB,IAAI,OAAO,UAAc,KAAe,CAAC,UAAU,YAAa,CAC5DE,EAAU,OAAO,EACjB,MACJ,CACAA,EAAU,UAAU,EACpBF,EAAU,UAAU,YAAY,cAAcI,EAAgBK,EAAahB,CAAe,EAC9F,CAEA,SAASmB,GAAa,CACdZ,IAAY,MAAQ,OAAO,UAAc,KAAe,UAAU,aAClE,UAAU,YAAY,WAAWA,CAAO,EAE5CA,EAAU,KACVE,EAAU,MAAM,CACpB,CAEA,SAASW,GAAc,CACnBD,EAAA,EACAf,EAAS,CAAA,EACTC,EAAa,EACbC,EAAW,KACXL,IAAWG,CAAM,CACrB,CAEA,MAAO,CACH,MAAAc,EACA,KAAAC,EACA,MAAAC,EACA,IAAI,QAAS,CACT,OAAOhB,CACX,EACA,IAAI,YAAa,CACb,OAAOC,CACX,EACA,IAAI,QAAS,CACT,OAAOG,CACX,CAAA,CAER"}
+{"version":3,"file":"create-position-tracker.cjs","names":[],"sources":["../../src/geo/create-position-tracker.ts"],"sourcesContent":["import { haversineKm } from \"./distance\";\nimport type { TrackPoint } from \"./types\";\n\n/** Lifecycle status of a {@link PositionTracker}. */\nexport type TrackerStatus = \"idle\" | \"tracking\" | \"error\";\n\n/** Options for {@link createPositionTracker}. */\nexport interface CreatePositionTrackerOptions {\n    /**\n     * Discard a new sample when it is closer than this (in km) to the last\n     * kept point — filters GPS jitter while standing still. Default: `0.005`\n     * (5 meters). Pass `0` to keep every sample.\n     */\n    minDistanceKm?: number;\n    /**\n     * Cap the retained trajectory to the most recent N points (older points are\n     * dropped, but their distance stays counted). Default: `Infinity`.\n     */\n    maxPoints?: number;\n    /** Forwarded to `navigator.geolocation.watchPosition`. */\n    positionOptions?: PositionOptions;\n    /** Called with the full trajectory each time a point is added. */\n    onUpdate?: (points: readonly TrackPoint[]) => void;\n    /** Called on a `GeolocationPositionError`. */\n    onError?: (error: GeolocationPositionError) => void;\n    /** Called whenever the status changes. */\n    onStatusChange?: (status: TrackerStatus) => void;\n}\n\n/** Imperative controller returned by {@link createPositionTracker}. */\nexport interface PositionTracker {\n    /** Begin watching position. No-op if already tracking. */\n    start: () => void;\n    /** Stop watching. Retains the recorded trajectory. */\n    stop: () => void;\n    /** Stop and discard the recorded trajectory. */\n    clear: () => void;\n    /** Snapshot of the recorded trajectory (newest last). */\n    readonly points: readonly TrackPoint[];\n    /** Total distance of the recorded trajectory in kilometers. */\n    readonly distanceKm: number;\n    /** Current tracker status. */\n    readonly status: TrackerStatus;\n}\n\n/**\n * Record a live GPS trajectory from `navigator.geolocation.watchPosition`.\n * Framework-free — the {@link usePositionTracker} hook wraps this for React.\n *\n * Jitter while stationary is filtered by `minDistanceKm`; distance is\n * accumulated across the *full* run even when `maxPoints` trims the retained\n * array. 100% browser-side: no network, no external service.\n *\n * @param options - Filtering, retention and callbacks.\n * @returns A controller with `start`/`stop`/`clear` and live getters.\n *\n * @example\n * const tracker = createPositionTracker({\n *   minDistanceKm: 0.01,\n *   onUpdate: (pts) => console.log(pts.length, \"points\"),\n * });\n * tracker.start();\n * // …later\n * tracker.stop();\n * console.log(tracker.distanceKm);\n */\nexport function createPositionTracker(options: CreatePositionTrackerOptions = {}): PositionTracker {\n    const {\n        minDistanceKm = 0.005,\n        maxPoints = Infinity,\n        positionOptions,\n        onUpdate,\n        onError,\n        onStatusChange,\n    } = options;\n\n    let points: TrackPoint[] = [];\n    let distanceKm = 0;\n    let lastKept: TrackPoint | null = null;\n    let watchId: number | null = null;\n    let status: TrackerStatus = \"idle\";\n\n    function setStatus(next: TrackerStatus): void {\n        if (status === next) return;\n        status = next;\n        onStatusChange?.(next);\n    }\n\n    function handlePosition(position: GeolocationPosition): void {\n        const point: TrackPoint = {\n            latitude: position.coords.latitude,\n            longitude: position.coords.longitude,\n            timestamp: position.timestamp,\n            accuracy: position.coords.accuracy,\n        };\n\n        if (lastKept) {\n            const step = haversineKm(lastKept, point);\n            if (step < minDistanceKm) return;\n            distanceKm += step;\n        }\n\n        lastKept = point;\n        points.push(point);\n        if (points.length > maxPoints) {\n            points = points.slice(points.length - maxPoints);\n        }\n        onUpdate?.(points);\n    }\n\n    function handleError(error: GeolocationPositionError): void {\n        setStatus(\"error\");\n        onError?.(error);\n    }\n\n    function start(): void {\n        if (watchId !== null) return;\n        if (typeof navigator === \"undefined\" || !navigator.geolocation) {\n            setStatus(\"error\");\n            return;\n        }\n        setStatus(\"tracking\");\n        watchId = navigator.geolocation.watchPosition(handlePosition, handleError, positionOptions);\n    }\n\n    function stop(): void {\n        if (watchId !== null && typeof navigator !== \"undefined\" && navigator.geolocation) {\n            navigator.geolocation.clearWatch(watchId);\n        }\n        watchId = null;\n        setStatus(\"idle\");\n    }\n\n    function clear(): void {\n        stop();\n        points = [];\n        distanceKm = 0;\n        lastKept = null;\n        onUpdate?.(points);\n    }\n\n    return {\n        start,\n        stop,\n        clear,\n        get points() {\n            return points;\n        },\n        get distanceKm() {\n            return distanceKm;\n        },\n        get status() {\n            return status;\n        },\n    };\n}\n"],"mappings":"kCAkEA,SAAgB,EAAsB,EAAwC,CAAC,EAAoB,CAC/F,GAAM,CACF,gBAAgB,KAChB,YAAY,IACZ,kBACA,WACA,UACA,kBACA,EAEA,EAAuB,CAAC,EACxB,EAAa,EACb,EAA8B,KAC9B,EAAyB,KACzB,EAAwB,OAE5B,SAAS,EAAU,EAA2B,CACtC,IAAW,IACf,EAAS,EACT,IAAiB,CAAI,EACzB,CAEA,SAAS,EAAe,EAAqC,CACzD,IAAM,EAAoB,CACtB,SAAU,EAAS,OAAO,SAC1B,UAAW,EAAS,OAAO,UAC3B,UAAW,EAAS,UACpB,SAAU,EAAS,OAAO,QAC9B,EAEA,GAAI,EAAU,CACV,IAAM,EAAO,EAAA,YAAY,EAAU,CAAK,EACxC,GAAI,EAAO,EAAe,OAC1B,GAAc,CAClB,CAEA,EAAW,EACX,EAAO,KAAK,CAAK,EACb,EAAO,OAAS,IAChB,EAAS,EAAO,MAAM,EAAO,OAAS,CAAS,GAEnD,IAAW,CAAM,CACrB,CAEA,SAAS,EAAY,EAAuC,CACxD,EAAU,OAAO,EACjB,IAAU,CAAK,CACnB,CAEA,SAAS,GAAc,CACf,OAAY,KAChB,IAAI,OAAO,UAAc,KAAe,CAAC,UAAU,YAAa,CAC5D,EAAU,OAAO,EACjB,MACJ,CACA,EAAU,UAAU,EACpB,EAAU,UAAU,YAAY,cAAc,EAAgB,EAAa,CAAe,CAF1F,CAGJ,CAEA,SAAS,GAAa,CACd,IAAY,MAAQ,OAAO,UAAc,KAAe,UAAU,aAClE,UAAU,YAAY,WAAW,CAAO,EAE5C,EAAU,KACV,EAAU,MAAM,CACpB,CAEA,SAAS,GAAc,CACnB,EAAK,EACL,EAAS,CAAC,EACV,EAAa,EACb,EAAW,KACX,IAAW,CAAM,CACrB,CAEA,MAAO,CACH,QACA,OACA,QACA,IAAI,QAAS,CACT,OAAO,CACX,EACA,IAAI,YAAa,CACb,OAAO,CACX,EACA,IAAI,QAAS,CACT,OAAO,CACX,CACJ,CACJ"}

package/dist/geo/create-position-tracker.js

@@ -1,65 +1,58 @@
-import { haversineKm as k } from "./distance.js";
-function E(d = {}) {
-  const {
-    minDistanceKm: g = 5e-3,
-    maxPoints: l = 1 / 0,
-    positionOptions: p,
-    onUpdate: u,
-    onError: m,
-    onStatusChange: h
-  } = d;
-  let n = [], r = 0, o = null, e = null, a = "idle";
-  function i(t) {
-    a !== t && (a = t, h?.(t));
-  }
-  function v(t) {
-    const c = {
-      latitude: t.coords.latitude,
-      longitude: t.coords.longitude,
-      timestamp: t.timestamp,
-      accuracy: t.coords.accuracy
-    };
-    if (o) {
-      const f = k(o, c);
-      if (f < g) return;
-      r += f;
-    }
-    o = c, n.push(c), n.length > l && (n = n.slice(n.length - l)), u?.(n);
-  }
-  function y(t) {
-    i("error"), m?.(t);
-  }
-  function K() {
-    if (e === null) {
-      if (typeof navigator > "u" || !navigator.geolocation) {
-        i("error");
-        return;
-      }
-      i("tracking"), e = navigator.geolocation.watchPosition(v, y, p);
-    }
-  }
-  function s() {
-    e !== null && typeof navigator < "u" && navigator.geolocation && navigator.geolocation.clearWatch(e), e = null, i("idle");
-  }
-  function P() {
-    s(), n = [], r = 0, o = null, u?.(n);
-  }
-  return {
-    start: K,
-    stop: s,
-    clear: P,
-    get points() {
-      return n;
-    },
-    get distanceKm() {
-      return r;
-    },
-    get status() {
-      return a;
-    }
-  };
+import { haversineKm as e } from "./distance.js";
+//#region src/geo/create-position-tracker.ts
+function t(t = {}) {
+	let { minDistanceKm: n = .005, maxPoints: r = Infinity, positionOptions: i, onUpdate: a, onError: o, onStatusChange: s } = t, c = [], l = 0, u = null, d = null, f = "idle";
+	function p(e) {
+		f !== e && (f = e, s?.(e));
+	}
+	function m(t) {
+		let i = {
+			latitude: t.coords.latitude,
+			longitude: t.coords.longitude,
+			timestamp: t.timestamp,
+			accuracy: t.coords.accuracy
+		};
+		if (u) {
+			let t = e(u, i);
+			if (t < n) return;
+			l += t;
+		}
+		u = i, c.push(i), c.length > r && (c = c.slice(c.length - r)), a?.(c);
+	}
+	function h(e) {
+		p("error"), o?.(e);
+	}
+	function g() {
+		if (d === null) {
+			if (typeof navigator > "u" || !navigator.geolocation) {
+				p("error");
+				return;
+			}
+			p("tracking"), d = navigator.geolocation.watchPosition(m, h, i);
+		}
+	}
+	function _() {
+		d !== null && typeof navigator < "u" && navigator.geolocation && navigator.geolocation.clearWatch(d), d = null, p("idle");
+	}
+	function v() {
+		_(), c = [], l = 0, u = null, a?.(c);
+	}
+	return {
+		start: g,
+		stop: _,
+		clear: v,
+		get points() {
+			return c;
+		},
+		get distanceKm() {
+			return l;
+		},
+		get status() {
+			return f;
+		}
+	};
 }
-export {
-  E as createPositionTracker
-};
-//# sourceMappingURL=create-position-tracker.js.map
+//#endregion
+export { t as createPositionTracker };
+
+//# sourceMappingURL=create-position-tracker.js.map

package/dist/geo/create-position-tracker.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-position-tracker.js","sources":["../../src/geo/create-position-tracker.ts"],"sourcesContent":["import { haversineKm } from \"./distance\";\nimport type { TrackPoint } from \"./types\";\n\n/** Lifecycle status of a {@link PositionTracker}. */\nexport type TrackerStatus = \"idle\" | \"tracking\" | \"error\";\n\n/** Options for {@link createPositionTracker}. */\nexport interface CreatePositionTrackerOptions {\n    /**\n     * Discard a new sample when it is closer than this (in km) to the last\n     * kept point — filters GPS jitter while standing still. Default: `0.005`\n     * (5 meters). Pass `0` to keep every sample.\n     */\n    minDistanceKm?: number;\n    /**\n     * Cap the retained trajectory to the most recent N points (older points are\n     * dropped, but their distance stays counted). Default: `Infinity`.\n     */\n    maxPoints?: number;\n    /** Forwarded to `navigator.geolocation.watchPosition`. */\n    positionOptions?: PositionOptions;\n    /** Called with the full trajectory each time a point is added. */\n    onUpdate?: (points: readonly TrackPoint[]) => void;\n    /** Called on a `GeolocationPositionError`. */\n    onError?: (error: GeolocationPositionError) => void;\n    /** Called whenever the status changes. */\n    onStatusChange?: (status: TrackerStatus) => void;\n}\n\n/** Imperative controller returned by {@link createPositionTracker}. */\nexport interface PositionTracker {\n    /** Begin watching position. No-op if already tracking. */\n    start: () => void;\n    /** Stop watching. Retains the recorded trajectory. */\n    stop: () => void;\n    /** Stop and discard the recorded trajectory. */\n    clear: () => void;\n    /** Snapshot of the recorded trajectory (newest last). */\n    readonly points: readonly TrackPoint[];\n    /** Total distance of the recorded trajectory in kilometers. */\n    readonly distanceKm: number;\n    /** Current tracker status. */\n    readonly status: TrackerStatus;\n}\n\n/**\n * Record a live GPS trajectory from `navigator.geolocation.watchPosition`.\n * Framework-free — the {@link usePositionTracker} hook wraps this for React.\n *\n * Jitter while stationary is filtered by `minDistanceKm`; distance is\n * accumulated across the *full* run even when `maxPoints` trims the retained\n * array. 100% browser-side: no network, no external service.\n *\n * @param options - Filtering, retention and callbacks.\n * @returns A controller with `start`/`stop`/`clear` and live getters.\n *\n * @example\n * const tracker = createPositionTracker({\n *   minDistanceKm: 0.01,\n *   onUpdate: (pts) => console.log(pts.length, \"points\"),\n * });\n * tracker.start();\n * // …later\n * tracker.stop();\n * console.log(tracker.distanceKm);\n */\nexport function createPositionTracker(options: CreatePositionTrackerOptions = {}): PositionTracker {\n    const {\n        minDistanceKm = 0.005,\n        maxPoints = Infinity,\n        positionOptions,\n        onUpdate,\n        onError,\n        onStatusChange,\n    } = options;\n\n    let points: TrackPoint[] = [];\n    let distanceKm = 0;\n    let lastKept: TrackPoint | null = null;\n    let watchId: number | null = null;\n    let status: TrackerStatus = \"idle\";\n\n    function setStatus(next: TrackerStatus): void {\n        if (status === next) return;\n        status = next;\n        onStatusChange?.(next);\n    }\n\n    function handlePosition(position: GeolocationPosition): void {\n        const point: TrackPoint = {\n            latitude: position.coords.latitude,\n            longitude: position.coords.longitude,\n            timestamp: position.timestamp,\n            accuracy: position.coords.accuracy,\n        };\n\n        if (lastKept) {\n            const step = haversineKm(lastKept, point);\n            if (step < minDistanceKm) return;\n            distanceKm += step;\n        }\n\n        lastKept = point;\n        points.push(point);\n        if (points.length > maxPoints) {\n            points = points.slice(points.length - maxPoints);\n        }\n        onUpdate?.(points);\n    }\n\n    function handleError(error: GeolocationPositionError): void {\n        setStatus(\"error\");\n        onError?.(error);\n    }\n\n    function start(): void {\n        if (watchId !== null) return;\n        if (typeof navigator === \"undefined\" || !navigator.geolocation) {\n            setStatus(\"error\");\n            return;\n        }\n        setStatus(\"tracking\");\n        watchId = navigator.geolocation.watchPosition(handlePosition, handleError, positionOptions);\n    }\n\n    function stop(): void {\n        if (watchId !== null && typeof navigator !== \"undefined\" && navigator.geolocation) {\n            navigator.geolocation.clearWatch(watchId);\n        }\n        watchId = null;\n        setStatus(\"idle\");\n    }\n\n    function clear(): void {\n        stop();\n        points = [];\n        distanceKm = 0;\n        lastKept = null;\n        onUpdate?.(points);\n    }\n\n    return {\n        start,\n        stop,\n        clear,\n        get points() {\n            return points;\n        },\n        get distanceKm() {\n            return distanceKm;\n        },\n        get status() {\n            return status;\n        },\n    };\n}\n"],"names":["createPositionTracker","options","minDistanceKm","maxPoints","positionOptions","onUpdate","onError","onStatusChange","points","distanceKm","lastKept","watchId","status","setStatus","next","handlePosition","position","point","step","haversineKm","handleError","error","start","stop","clear"],"mappings":";AAkEO,SAASA,EAAsBC,IAAwC,IAAqB;AAC/F,QAAM;AAAA,IACF,eAAAC,IAAgB;AAAA,IAChB,WAAAC,IAAY;AAAA,IACZ,iBAAAC;AAAA,IACA,UAAAC;AAAA,IACA,SAAAC;AAAA,IACA,gBAAAC;AAAA,EAAA,IACAN;AAEJ,MAAIO,IAAuB,CAAA,GACvBC,IAAa,GACbC,IAA8B,MAC9BC,IAAyB,MACzBC,IAAwB;AAE5B,WAASC,EAAUC,GAA2B;AAC1C,IAAIF,MAAWE,MACfF,IAASE,GACTP,IAAiBO,CAAI;AAAA,EACzB;AAEA,WAASC,EAAeC,GAAqC;AACzD,UAAMC,IAAoB;AAAA,MACtB,UAAUD,EAAS,OAAO;AAAA,MAC1B,WAAWA,EAAS,OAAO;AAAA,MAC3B,WAAWA,EAAS;AAAA,MACpB,UAAUA,EAAS,OAAO;AAAA,IAAA;AAG9B,QAAIN,GAAU;AACV,YAAMQ,IAAOC,EAAYT,GAAUO,CAAK;AACxC,UAAIC,IAAOhB,EAAe;AAC1B,MAAAO,KAAcS;AAAA,IAClB;AAEA,IAAAR,IAAWO,GACXT,EAAO,KAAKS,CAAK,GACbT,EAAO,SAASL,MAChBK,IAASA,EAAO,MAAMA,EAAO,SAASL,CAAS,IAEnDE,IAAWG,CAAM;AAAA,EACrB;AAEA,WAASY,EAAYC,GAAuC;AACxD,IAAAR,EAAU,OAAO,GACjBP,IAAUe,CAAK;AAAA,EACnB;AAEA,WAASC,IAAc;AACnB,QAAIX,MAAY,MAChB;AAAA,UAAI,OAAO,YAAc,OAAe,CAAC,UAAU,aAAa;AAC5D,QAAAE,EAAU,OAAO;AACjB;AAAA,MACJ;AACA,MAAAA,EAAU,UAAU,GACpBF,IAAU,UAAU,YAAY,cAAcI,GAAgBK,GAAahB,CAAe;AAAA;AAAA,EAC9F;AAEA,WAASmB,IAAa;AAClB,IAAIZ,MAAY,QAAQ,OAAO,YAAc,OAAe,UAAU,eAClE,UAAU,YAAY,WAAWA,CAAO,GAE5CA,IAAU,MACVE,EAAU,MAAM;AAAA,EACpB;AAEA,WAASW,IAAc;AACnB,IAAAD,EAAA,GACAf,IAAS,CAAA,GACTC,IAAa,GACbC,IAAW,MACXL,IAAWG,CAAM;AAAA,EACrB;AAEA,SAAO;AAAA,IACH,OAAAc;AAAA,IACA,MAAAC;AAAA,IACA,OAAAC;AAAA,IACA,IAAI,SAAS;AACT,aAAOhB;AAAA,IACX;AAAA,IACA,IAAI,aAAa;AACb,aAAOC;AAAA,IACX;AAAA,IACA,IAAI,SAAS;AACT,aAAOG;AAAA,IACX;AAAA,EAAA;AAER;"}
+{"version":3,"file":"create-position-tracker.js","names":[],"sources":["../../src/geo/create-position-tracker.ts"],"sourcesContent":["import { haversineKm } from \"./distance\";\nimport type { TrackPoint } from \"./types\";\n\n/** Lifecycle status of a {@link PositionTracker}. */\nexport type TrackerStatus = \"idle\" | \"tracking\" | \"error\";\n\n/** Options for {@link createPositionTracker}. */\nexport interface CreatePositionTrackerOptions {\n    /**\n     * Discard a new sample when it is closer than this (in km) to the last\n     * kept point — filters GPS jitter while standing still. Default: `0.005`\n     * (5 meters). Pass `0` to keep every sample.\n     */\n    minDistanceKm?: number;\n    /**\n     * Cap the retained trajectory to the most recent N points (older points are\n     * dropped, but their distance stays counted). Default: `Infinity`.\n     */\n    maxPoints?: number;\n    /** Forwarded to `navigator.geolocation.watchPosition`. */\n    positionOptions?: PositionOptions;\n    /** Called with the full trajectory each time a point is added. */\n    onUpdate?: (points: readonly TrackPoint[]) => void;\n    /** Called on a `GeolocationPositionError`. */\n    onError?: (error: GeolocationPositionError) => void;\n    /** Called whenever the status changes. */\n    onStatusChange?: (status: TrackerStatus) => void;\n}\n\n/** Imperative controller returned by {@link createPositionTracker}. */\nexport interface PositionTracker {\n    /** Begin watching position. No-op if already tracking. */\n    start: () => void;\n    /** Stop watching. Retains the recorded trajectory. */\n    stop: () => void;\n    /** Stop and discard the recorded trajectory. */\n    clear: () => void;\n    /** Snapshot of the recorded trajectory (newest last). */\n    readonly points: readonly TrackPoint[];\n    /** Total distance of the recorded trajectory in kilometers. */\n    readonly distanceKm: number;\n    /** Current tracker status. */\n    readonly status: TrackerStatus;\n}\n\n/**\n * Record a live GPS trajectory from `navigator.geolocation.watchPosition`.\n * Framework-free — the {@link usePositionTracker} hook wraps this for React.\n *\n * Jitter while stationary is filtered by `minDistanceKm`; distance is\n * accumulated across the *full* run even when `maxPoints` trims the retained\n * array. 100% browser-side: no network, no external service.\n *\n * @param options - Filtering, retention and callbacks.\n * @returns A controller with `start`/`stop`/`clear` and live getters.\n *\n * @example\n * const tracker = createPositionTracker({\n *   minDistanceKm: 0.01,\n *   onUpdate: (pts) => console.log(pts.length, \"points\"),\n * });\n * tracker.start();\n * // …later\n * tracker.stop();\n * console.log(tracker.distanceKm);\n */\nexport function createPositionTracker(options: CreatePositionTrackerOptions = {}): PositionTracker {\n    const {\n        minDistanceKm = 0.005,\n        maxPoints = Infinity,\n        positionOptions,\n        onUpdate,\n        onError,\n        onStatusChange,\n    } = options;\n\n    let points: TrackPoint[] = [];\n    let distanceKm = 0;\n    let lastKept: TrackPoint | null = null;\n    let watchId: number | null = null;\n    let status: TrackerStatus = \"idle\";\n\n    function setStatus(next: TrackerStatus): void {\n        if (status === next) return;\n        status = next;\n        onStatusChange?.(next);\n    }\n\n    function handlePosition(position: GeolocationPosition): void {\n        const point: TrackPoint = {\n            latitude: position.coords.latitude,\n            longitude: position.coords.longitude,\n            timestamp: position.timestamp,\n            accuracy: position.coords.accuracy,\n        };\n\n        if (lastKept) {\n            const step = haversineKm(lastKept, point);\n            if (step < minDistanceKm) return;\n            distanceKm += step;\n        }\n\n        lastKept = point;\n        points.push(point);\n        if (points.length > maxPoints) {\n            points = points.slice(points.length - maxPoints);\n        }\n        onUpdate?.(points);\n    }\n\n    function handleError(error: GeolocationPositionError): void {\n        setStatus(\"error\");\n        onError?.(error);\n    }\n\n    function start(): void {\n        if (watchId !== null) return;\n        if (typeof navigator === \"undefined\" || !navigator.geolocation) {\n            setStatus(\"error\");\n            return;\n        }\n        setStatus(\"tracking\");\n        watchId = navigator.geolocation.watchPosition(handlePosition, handleError, positionOptions);\n    }\n\n    function stop(): void {\n        if (watchId !== null && typeof navigator !== \"undefined\" && navigator.geolocation) {\n            navigator.geolocation.clearWatch(watchId);\n        }\n        watchId = null;\n        setStatus(\"idle\");\n    }\n\n    function clear(): void {\n        stop();\n        points = [];\n        distanceKm = 0;\n        lastKept = null;\n        onUpdate?.(points);\n    }\n\n    return {\n        start,\n        stop,\n        clear,\n        get points() {\n            return points;\n        },\n        get distanceKm() {\n            return distanceKm;\n        },\n        get status() {\n            return status;\n        },\n    };\n}\n"],"mappings":";;AAkEA,SAAgB,EAAsB,IAAwC,CAAC,GAAoB;CAC/F,IAAM,EACF,mBAAgB,MAChB,eAAY,UACZ,oBACA,aACA,YACA,sBACA,GAEA,IAAuB,CAAC,GACxB,IAAa,GACb,IAA8B,MAC9B,IAAyB,MACzB,IAAwB;CAE5B,SAAS,EAAU,GAA2B;EACtC,MAAW,MACf,IAAS,GACT,IAAiB,CAAI;CACzB;CAEA,SAAS,EAAe,GAAqC;EACzD,IAAM,IAAoB;GACtB,UAAU,EAAS,OAAO;GAC1B,WAAW,EAAS,OAAO;GAC3B,WAAW,EAAS;GACpB,UAAU,EAAS,OAAO;EAC9B;EAEA,IAAI,GAAU;GACV,IAAM,IAAO,EAAY,GAAU,CAAK;GACxC,IAAI,IAAO,GAAe;GAC1B,KAAc;EAClB;EAOA,AALA,IAAW,GACX,EAAO,KAAK,CAAK,GACb,EAAO,SAAS,MAChB,IAAS,EAAO,MAAM,EAAO,SAAS,CAAS,IAEnD,IAAW,CAAM;CACrB;CAEA,SAAS,EAAY,GAAuC;EAExD,AADA,EAAU,OAAO,GACjB,IAAU,CAAK;CACnB;CAEA,SAAS,IAAc;EACf,UAAY,MAChB;OAAI,OAAO,YAAc,OAAe,CAAC,UAAU,aAAa;IAC5D,EAAU,OAAO;IACjB;GACJ;GAEA,AADA,EAAU,UAAU,GACpB,IAAU,UAAU,YAAY,cAAc,GAAgB,GAAa,CAAe;EAF1F;CAGJ;CAEA,SAAS,IAAa;EAKlB,AAJI,MAAY,QAAQ,OAAO,YAAc,OAAe,UAAU,eAClE,UAAU,YAAY,WAAW,CAAO,GAE5C,IAAU,MACV,EAAU,MAAM;CACpB;CAEA,SAAS,IAAc;EAKnB,AAJA,EAAK,GACL,IAAS,CAAC,GACV,IAAa,GACb,IAAW,MACX,IAAW,CAAM;CACrB;CAEA,OAAO;EACH;EACA;EACA;EACA,IAAI,SAAS;GACT,OAAO;EACX;EACA,IAAI,aAAa;GACb,OAAO;EACX;EACA,IAAI,SAAS;GACT,OAAO;EACX;CACJ;AACJ"}

package/dist/geo/distance.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const h=6371.0088;function e(t){return t*Math.PI/180}function u(t,a){const n=e(t.latitude),o=e(a.latitude),s=e(a.latitude-t.latitude),c=e(a.longitude-t.longitude),l=Math.sin(s/2)**2+Math.cos(n)*Math.cos(o)*Math.sin(c/2)**2;return 2*h*Math.asin(Math.sqrt(l))}function M(t){let a=0;for(let n=1;n<t.length;n+=1)a+=u(t[n-1],t[n]);return a}function i(t,a){const n=e(t.latitude),o=e(a.latitude),s=e(a.longitude-t.longitude),c=Math.sin(s)*Math.cos(o),l=Math.cos(n)*Math.sin(o)-Math.sin(n)*Math.cos(o)*Math.cos(s);return(Math.atan2(c,l)*180/Math.PI+360)%360}exports.EARTH_RADIUS_KM=h;exports.bearingDeg=i;exports.haversineKm=u;exports.pathLengthKm=M;exports.toRadians=e;
-//# sourceMappingURL=distance.cjs.map
+var e=6371.0088;function t(e){return e*Math.PI/180}function n(n,r){let i=t(n.latitude),a=t(r.latitude),o=t(r.latitude-n.latitude),s=t(r.longitude-n.longitude),c=Math.sin(o/2)**2+Math.cos(i)*Math.cos(a)*Math.sin(s/2)**2;return 2*e*Math.asin(Math.sqrt(c))}function r(e){let t=0;for(let r=1;r<e.length;r+=1)t+=n(e[r-1],e[r]);return t}function i(e,n){let r=t(e.latitude),i=t(n.latitude),a=t(n.longitude-e.longitude),o=Math.sin(a)*Math.cos(i),s=Math.cos(r)*Math.sin(i)-Math.sin(r)*Math.cos(i)*Math.cos(a);return(Math.atan2(o,s)*180/Math.PI+360)%360}exports.EARTH_RADIUS_KM=e,exports.bearingDeg=i,exports.haversineKm=n,exports.pathLengthKm=r,exports.toRadians=t;
+//# sourceMappingURL=distance.cjs.map

package/dist/geo/distance.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"distance.cjs","sources":["../../src/geo/distance.ts"],"sourcesContent":["import type { Coordinate } from \"./types\";\n\n/**\n * Mean Earth radius in kilometers. Same value used by `tempest-fastapi-sdk`\n * (`geo/distance.py`) so client and server distances agree.\n */\nexport const EARTH_RADIUS_KM = 6371.0088;\n\n/** Convert degrees to radians. */\nexport function toRadians(degrees: number): number {\n    return (degrees * Math.PI) / 180;\n}\n\n/**\n * Great-circle distance between two coordinates using the haversine formula\n * (spherical Earth). Mirrors `haversine_km` from `tempest-fastapi-sdk`.\n *\n * @param origin - Start coordinate.\n * @param destination - End coordinate.\n * @returns Distance in kilometers (`>= 0`).\n *\n * @example\n * haversineKm(\n *   { latitude: -23.5505, longitude: -46.6333 }, // São Paulo\n *   { latitude: -22.9068, longitude: -43.1729 }, // Rio de Janeiro\n * ); // ≈ 360.9\n */\nexport function haversineKm(origin: Coordinate, destination: Coordinate): number {\n    const lat1 = toRadians(origin.latitude);\n    const lat2 = toRadians(destination.latitude);\n    const deltaLat = toRadians(destination.latitude - origin.latitude);\n    const deltaLon = toRadians(destination.longitude - origin.longitude);\n\n    const a =\n        Math.sin(deltaLat / 2) ** 2 + Math.cos(lat1) * Math.cos(lat2) * Math.sin(deltaLon / 2) ** 2;\n\n    return 2 * EARTH_RADIUS_KM * Math.asin(Math.sqrt(a));\n}\n\n/**\n * Total length of a trajectory: the sum of haversine distances between each\n * consecutive pair of points. Returns `0` for an empty or single-point path.\n *\n * @param points - Ordered coordinates along the path.\n * @returns Cumulative distance in kilometers.\n */\nexport function pathLengthKm(points: readonly Coordinate[]): number {\n    let total = 0;\n    for (let i = 1; i < points.length; i += 1) {\n        total += haversineKm(points[i - 1], points[i]);\n    }\n    return total;\n}\n\n/**\n * Initial bearing (forward azimuth) from `origin` to `destination`, in degrees\n * clockwise from true north, normalized to `[0, 360)`. Useful for orienting a\n * heading arrow on a trajectory.\n *\n * @param origin - Start coordinate.\n * @param destination - End coordinate.\n * @returns Bearing in degrees, `[0, 360)`.\n */\nexport function bearingDeg(origin: Coordinate, destination: Coordinate): number {\n    const lat1 = toRadians(origin.latitude);\n    const lat2 = toRadians(destination.latitude);\n    const deltaLon = toRadians(destination.longitude - origin.longitude);\n\n    const y = Math.sin(deltaLon) * Math.cos(lat2);\n    const x =\n        Math.cos(lat1) * Math.sin(lat2) - Math.sin(lat1) * Math.cos(lat2) * Math.cos(deltaLon);\n\n    const bearing = (Math.atan2(y, x) * 180) / Math.PI;\n    return (bearing + 360) % 360;\n}\n"],"names":["EARTH_RADIUS_KM","toRadians","degrees","haversineKm","origin","destination","lat1","lat2","deltaLat","deltaLon","a","pathLengthKm","points","total","i","bearingDeg","y","x"],"mappings":"gFAMO,MAAMA,EAAkB,UAGxB,SAASC,EAAUC,EAAyB,CAC/C,OAAQA,EAAU,KAAK,GAAM,GACjC,CAgBO,SAASC,EAAYC,EAAoBC,EAAiC,CAC7E,MAAMC,EAAOL,EAAUG,EAAO,QAAQ,EAChCG,EAAON,EAAUI,EAAY,QAAQ,EACrCG,EAAWP,EAAUI,EAAY,SAAWD,EAAO,QAAQ,EAC3DK,EAAWR,EAAUI,EAAY,UAAYD,EAAO,SAAS,EAE7DM,EACF,KAAK,IAAIF,EAAW,CAAC,GAAK,EAAI,KAAK,IAAIF,CAAI,EAAI,KAAK,IAAIC,CAAI,EAAI,KAAK,IAAIE,EAAW,CAAC,GAAK,EAE9F,MAAO,GAAIT,EAAkB,KAAK,KAAK,KAAK,KAAKU,CAAC,CAAC,CACvD,CASO,SAASC,EAAaC,EAAuC,CAChE,IAAIC,EAAQ,EACZ,QAASC,EAAI,EAAGA,EAAIF,EAAO,OAAQE,GAAK,EACpCD,GAASV,EAAYS,EAAOE,EAAI,CAAC,EAAGF,EAAOE,CAAC,CAAC,EAEjD,OAAOD,CACX,CAWO,SAASE,EAAWX,EAAoBC,EAAiC,CAC5E,MAAMC,EAAOL,EAAUG,EAAO,QAAQ,EAChCG,EAAON,EAAUI,EAAY,QAAQ,EACrCI,EAAWR,EAAUI,EAAY,UAAYD,EAAO,SAAS,EAE7DY,EAAI,KAAK,IAAIP,CAAQ,EAAI,KAAK,IAAIF,CAAI,EACtCU,EACF,KAAK,IAAIX,CAAI,EAAI,KAAK,IAAIC,CAAI,EAAI,KAAK,IAAID,CAAI,EAAI,KAAK,IAAIC,CAAI,EAAI,KAAK,IAAIE,CAAQ,EAGzF,OADiB,KAAK,MAAMO,EAAGC,CAAC,EAAI,IAAO,KAAK,GAC9B,KAAO,GAC7B"}
+{"version":3,"file":"distance.cjs","names":[],"sources":["../../src/geo/distance.ts"],"sourcesContent":["import type { Coordinate } from \"./types\";\n\n/**\n * Mean Earth radius in kilometers. Same value used by `tempest-fastapi-sdk`\n * (`geo/distance.py`) so client and server distances agree.\n */\nexport const EARTH_RADIUS_KM = 6371.0088;\n\n/** Convert degrees to radians. */\nexport function toRadians(degrees: number): number {\n    return (degrees * Math.PI) / 180;\n}\n\n/**\n * Great-circle distance between two coordinates using the haversine formula\n * (spherical Earth). Mirrors `haversine_km` from `tempest-fastapi-sdk`.\n *\n * @param origin - Start coordinate.\n * @param destination - End coordinate.\n * @returns Distance in kilometers (`>= 0`).\n *\n * @example\n * haversineKm(\n *   { latitude: -23.5505, longitude: -46.6333 }, // São Paulo\n *   { latitude: -22.9068, longitude: -43.1729 }, // Rio de Janeiro\n * ); // ≈ 360.9\n */\nexport function haversineKm(origin: Coordinate, destination: Coordinate): number {\n    const lat1 = toRadians(origin.latitude);\n    const lat2 = toRadians(destination.latitude);\n    const deltaLat = toRadians(destination.latitude - origin.latitude);\n    const deltaLon = toRadians(destination.longitude - origin.longitude);\n\n    const a =\n        Math.sin(deltaLat / 2) ** 2 + Math.cos(lat1) * Math.cos(lat2) * Math.sin(deltaLon / 2) ** 2;\n\n    return 2 * EARTH_RADIUS_KM * Math.asin(Math.sqrt(a));\n}\n\n/**\n * Total length of a trajectory: the sum of haversine distances between each\n * consecutive pair of points. Returns `0` for an empty or single-point path.\n *\n * @param points - Ordered coordinates along the path.\n * @returns Cumulative distance in kilometers.\n */\nexport function pathLengthKm(points: readonly Coordinate[]): number {\n    let total = 0;\n    for (let i = 1; i < points.length; i += 1) {\n        total += haversineKm(points[i - 1], points[i]);\n    }\n    return total;\n}\n\n/**\n * Initial bearing (forward azimuth) from `origin` to `destination`, in degrees\n * clockwise from true north, normalized to `[0, 360)`. Useful for orienting a\n * heading arrow on a trajectory.\n *\n * @param origin - Start coordinate.\n * @param destination - End coordinate.\n * @returns Bearing in degrees, `[0, 360)`.\n */\nexport function bearingDeg(origin: Coordinate, destination: Coordinate): number {\n    const lat1 = toRadians(origin.latitude);\n    const lat2 = toRadians(destination.latitude);\n    const deltaLon = toRadians(destination.longitude - origin.longitude);\n\n    const y = Math.sin(deltaLon) * Math.cos(lat2);\n    const x =\n        Math.cos(lat1) * Math.sin(lat2) - Math.sin(lat1) * Math.cos(lat2) * Math.cos(deltaLon);\n\n    const bearing = (Math.atan2(y, x) * 180) / Math.PI;\n    return (bearing + 360) % 360;\n}\n"],"mappings":"AAMA,IAAa,EAAkB,UAG/B,SAAgB,EAAU,EAAyB,CAC/C,OAAQ,EAAU,KAAK,GAAM,GACjC,CAgBA,SAAgB,EAAY,EAAoB,EAAiC,CAC7E,IAAM,EAAO,EAAU,EAAO,QAAQ,EAChC,EAAO,EAAU,EAAY,QAAQ,EACrC,EAAW,EAAU,EAAY,SAAW,EAAO,QAAQ,EAC3D,EAAW,EAAU,EAAY,UAAY,EAAO,SAAS,EAE7D,EACF,KAAK,IAAI,EAAW,CAAC,GAAK,EAAI,KAAK,IAAI,CAAI,EAAI,KAAK,IAAI,CAAI,EAAI,KAAK,IAAI,EAAW,CAAC,GAAK,EAE9F,MAAO,GAAI,EAAkB,KAAK,KAAK,KAAK,KAAK,CAAC,CAAC,CACvD,CASA,SAAgB,EAAa,EAAuC,CAChE,IAAI,EAAQ,EACZ,IAAK,IAAI,EAAI,EAAG,EAAI,EAAO,OAAQ,GAAK,EACpC,GAAS,EAAY,EAAO,EAAI,GAAI,EAAO,EAAE,EAEjD,OAAO,CACX,CAWA,SAAgB,EAAW,EAAoB,EAAiC,CAC5E,IAAM,EAAO,EAAU,EAAO,QAAQ,EAChC,EAAO,EAAU,EAAY,QAAQ,EACrC,EAAW,EAAU,EAAY,UAAY,EAAO,SAAS,EAE7D,EAAI,KAAK,IAAI,CAAQ,EAAI,KAAK,IAAI,CAAI,EACtC,EACF,KAAK,IAAI,CAAI,EAAI,KAAK,IAAI,CAAI,EAAI,KAAK,IAAI,CAAI,EAAI,KAAK,IAAI,CAAI,EAAI,KAAK,IAAI,CAAQ,EAGzF,OADiB,KAAK,MAAM,EAAG,CAAC,EAAI,IAAO,KAAK,GAC9B,KAAO,GAC7B"}

package/dist/geo/distance.js

@@ -1,26 +1,22 @@
-const h = 6371.0088;
-function e(t) {
-  return t * Math.PI / 180;
+//#region src/geo/distance.ts
+var e = 6371.0088;
+function t(e) {
+	return e * Math.PI / 180;
 }
-function u(t, a) {
-  const n = e(t.latitude), o = e(a.latitude), c = e(a.latitude - t.latitude), s = e(a.longitude - t.longitude), l = Math.sin(c / 2) ** 2 + Math.cos(n) * Math.cos(o) * Math.sin(s / 2) ** 2;
-  return 2 * h * Math.asin(Math.sqrt(l));
+function n(n, r) {
+	let i = t(n.latitude), a = t(r.latitude), o = t(r.latitude - n.latitude), s = t(r.longitude - n.longitude), c = Math.sin(o / 2) ** 2 + Math.cos(i) * Math.cos(a) * Math.sin(s / 2) ** 2;
+	return 2 * e * Math.asin(Math.sqrt(c));
 }
-function i(t) {
-  let a = 0;
-  for (let n = 1; n < t.length; n += 1)
-    a += u(t[n - 1], t[n]);
-  return a;
+function r(e) {
+	let t = 0;
+	for (let r = 1; r < e.length; r += 1) t += n(e[r - 1], e[r]);
+	return t;
 }
-function r(t, a) {
-  const n = e(t.latitude), o = e(a.latitude), c = e(a.longitude - t.longitude), s = Math.sin(c) * Math.cos(o), l = Math.cos(n) * Math.sin(o) - Math.sin(n) * Math.cos(o) * Math.cos(c);
-  return (Math.atan2(s, l) * 180 / Math.PI + 360) % 360;
+function i(e, n) {
+	let r = t(e.latitude), i = t(n.latitude), a = t(n.longitude - e.longitude), o = Math.sin(a) * Math.cos(i), s = Math.cos(r) * Math.sin(i) - Math.sin(r) * Math.cos(i) * Math.cos(a);
+	return (Math.atan2(o, s) * 180 / Math.PI + 360) % 360;
 }
-export {
-  h as EARTH_RADIUS_KM,
-  r as bearingDeg,
-  u as haversineKm,
-  i as pathLengthKm,
-  e as toRadians
-};
-//# sourceMappingURL=distance.js.map
+//#endregion
+export { e as EARTH_RADIUS_KM, i as bearingDeg, n as haversineKm, r as pathLengthKm, t as toRadians };
+
+//# sourceMappingURL=distance.js.map

package/dist/geo/distance.js.map

@@ -1 +1 @@
-{"version":3,"file":"distance.js","sources":["../../src/geo/distance.ts"],"sourcesContent":["import type { Coordinate } from \"./types\";\n\n/**\n * Mean Earth radius in kilometers. Same value used by `tempest-fastapi-sdk`\n * (`geo/distance.py`) so client and server distances agree.\n */\nexport const EARTH_RADIUS_KM = 6371.0088;\n\n/** Convert degrees to radians. */\nexport function toRadians(degrees: number): number {\n    return (degrees * Math.PI) / 180;\n}\n\n/**\n * Great-circle distance between two coordinates using the haversine formula\n * (spherical Earth). Mirrors `haversine_km` from `tempest-fastapi-sdk`.\n *\n * @param origin - Start coordinate.\n * @param destination - End coordinate.\n * @returns Distance in kilometers (`>= 0`).\n *\n * @example\n * haversineKm(\n *   { latitude: -23.5505, longitude: -46.6333 }, // São Paulo\n *   { latitude: -22.9068, longitude: -43.1729 }, // Rio de Janeiro\n * ); // ≈ 360.9\n */\nexport function haversineKm(origin: Coordinate, destination: Coordinate): number {\n    const lat1 = toRadians(origin.latitude);\n    const lat2 = toRadians(destination.latitude);\n    const deltaLat = toRadians(destination.latitude - origin.latitude);\n    const deltaLon = toRadians(destination.longitude - origin.longitude);\n\n    const a =\n        Math.sin(deltaLat / 2) ** 2 + Math.cos(lat1) * Math.cos(lat2) * Math.sin(deltaLon / 2) ** 2;\n\n    return 2 * EARTH_RADIUS_KM * Math.asin(Math.sqrt(a));\n}\n\n/**\n * Total length of a trajectory: the sum of haversine distances between each\n * consecutive pair of points. Returns `0` for an empty or single-point path.\n *\n * @param points - Ordered coordinates along the path.\n * @returns Cumulative distance in kilometers.\n */\nexport function pathLengthKm(points: readonly Coordinate[]): number {\n    let total = 0;\n    for (let i = 1; i < points.length; i += 1) {\n        total += haversineKm(points[i - 1], points[i]);\n    }\n    return total;\n}\n\n/**\n * Initial bearing (forward azimuth) from `origin` to `destination`, in degrees\n * clockwise from true north, normalized to `[0, 360)`. Useful for orienting a\n * heading arrow on a trajectory.\n *\n * @param origin - Start coordinate.\n * @param destination - End coordinate.\n * @returns Bearing in degrees, `[0, 360)`.\n */\nexport function bearingDeg(origin: Coordinate, destination: Coordinate): number {\n    const lat1 = toRadians(origin.latitude);\n    const lat2 = toRadians(destination.latitude);\n    const deltaLon = toRadians(destination.longitude - origin.longitude);\n\n    const y = Math.sin(deltaLon) * Math.cos(lat2);\n    const x =\n        Math.cos(lat1) * Math.sin(lat2) - Math.sin(lat1) * Math.cos(lat2) * Math.cos(deltaLon);\n\n    const bearing = (Math.atan2(y, x) * 180) / Math.PI;\n    return (bearing + 360) % 360;\n}\n"],"names":["EARTH_RADIUS_KM","toRadians","degrees","haversineKm","origin","destination","lat1","lat2","deltaLat","deltaLon","a","pathLengthKm","points","total","i","bearingDeg","y","x"],"mappings":"AAMO,MAAMA,IAAkB;AAGxB,SAASC,EAAUC,GAAyB;AAC/C,SAAQA,IAAU,KAAK,KAAM;AACjC;AAgBO,SAASC,EAAYC,GAAoBC,GAAiC;AAC7E,QAAMC,IAAOL,EAAUG,EAAO,QAAQ,GAChCG,IAAON,EAAUI,EAAY,QAAQ,GACrCG,IAAWP,EAAUI,EAAY,WAAWD,EAAO,QAAQ,GAC3DK,IAAWR,EAAUI,EAAY,YAAYD,EAAO,SAAS,GAE7DM,IACF,KAAK,IAAIF,IAAW,CAAC,KAAK,IAAI,KAAK,IAAIF,CAAI,IAAI,KAAK,IAAIC,CAAI,IAAI,KAAK,IAAIE,IAAW,CAAC,KAAK;AAE9F,SAAO,IAAIT,IAAkB,KAAK,KAAK,KAAK,KAAKU,CAAC,CAAC;AACvD;AASO,SAASC,EAAaC,GAAuC;AAChE,MAAIC,IAAQ;AACZ,WAASC,IAAI,GAAGA,IAAIF,EAAO,QAAQE,KAAK;AACpC,IAAAD,KAASV,EAAYS,EAAOE,IAAI,CAAC,GAAGF,EAAOE,CAAC,CAAC;AAEjD,SAAOD;AACX;AAWO,SAASE,EAAWX,GAAoBC,GAAiC;AAC5E,QAAMC,IAAOL,EAAUG,EAAO,QAAQ,GAChCG,IAAON,EAAUI,EAAY,QAAQ,GACrCI,IAAWR,EAAUI,EAAY,YAAYD,EAAO,SAAS,GAE7DY,IAAI,KAAK,IAAIP,CAAQ,IAAI,KAAK,IAAIF,CAAI,GACtCU,IACF,KAAK,IAAIX,CAAI,IAAI,KAAK,IAAIC,CAAI,IAAI,KAAK,IAAID,CAAI,IAAI,KAAK,IAAIC,CAAI,IAAI,KAAK,IAAIE,CAAQ;AAGzF,UADiB,KAAK,MAAMO,GAAGC,CAAC,IAAI,MAAO,KAAK,KAC9B,OAAO;AAC7B;"}
+{"version":3,"file":"distance.js","names":[],"sources":["../../src/geo/distance.ts"],"sourcesContent":["import type { Coordinate } from \"./types\";\n\n/**\n * Mean Earth radius in kilometers. Same value used by `tempest-fastapi-sdk`\n * (`geo/distance.py`) so client and server distances agree.\n */\nexport const EARTH_RADIUS_KM = 6371.0088;\n\n/** Convert degrees to radians. */\nexport function toRadians(degrees: number): number {\n    return (degrees * Math.PI) / 180;\n}\n\n/**\n * Great-circle distance between two coordinates using the haversine formula\n * (spherical Earth). Mirrors `haversine_km` from `tempest-fastapi-sdk`.\n *\n * @param origin - Start coordinate.\n * @param destination - End coordinate.\n * @returns Distance in kilometers (`>= 0`).\n *\n * @example\n * haversineKm(\n *   { latitude: -23.5505, longitude: -46.6333 }, // São Paulo\n *   { latitude: -22.9068, longitude: -43.1729 }, // Rio de Janeiro\n * ); // ≈ 360.9\n */\nexport function haversineKm(origin: Coordinate, destination: Coordinate): number {\n    const lat1 = toRadians(origin.latitude);\n    const lat2 = toRadians(destination.latitude);\n    const deltaLat = toRadians(destination.latitude - origin.latitude);\n    const deltaLon = toRadians(destination.longitude - origin.longitude);\n\n    const a =\n        Math.sin(deltaLat / 2) ** 2 + Math.cos(lat1) * Math.cos(lat2) * Math.sin(deltaLon / 2) ** 2;\n\n    return 2 * EARTH_RADIUS_KM * Math.asin(Math.sqrt(a));\n}\n\n/**\n * Total length of a trajectory: the sum of haversine distances between each\n * consecutive pair of points. Returns `0` for an empty or single-point path.\n *\n * @param points - Ordered coordinates along the path.\n * @returns Cumulative distance in kilometers.\n */\nexport function pathLengthKm(points: readonly Coordinate[]): number {\n    let total = 0;\n    for (let i = 1; i < points.length; i += 1) {\n        total += haversineKm(points[i - 1], points[i]);\n    }\n    return total;\n}\n\n/**\n * Initial bearing (forward azimuth) from `origin` to `destination`, in degrees\n * clockwise from true north, normalized to `[0, 360)`. Useful for orienting a\n * heading arrow on a trajectory.\n *\n * @param origin - Start coordinate.\n * @param destination - End coordinate.\n * @returns Bearing in degrees, `[0, 360)`.\n */\nexport function bearingDeg(origin: Coordinate, destination: Coordinate): number {\n    const lat1 = toRadians(origin.latitude);\n    const lat2 = toRadians(destination.latitude);\n    const deltaLon = toRadians(destination.longitude - origin.longitude);\n\n    const y = Math.sin(deltaLon) * Math.cos(lat2);\n    const x =\n        Math.cos(lat1) * Math.sin(lat2) - Math.sin(lat1) * Math.cos(lat2) * Math.cos(deltaLon);\n\n    const bearing = (Math.atan2(y, x) * 180) / Math.PI;\n    return (bearing + 360) % 360;\n}\n"],"mappings":";AAMA,IAAa,IAAkB;AAG/B,SAAgB,EAAU,GAAyB;CAC/C,OAAQ,IAAU,KAAK,KAAM;AACjC;AAgBA,SAAgB,EAAY,GAAoB,GAAiC;CAC7E,IAAM,IAAO,EAAU,EAAO,QAAQ,GAChC,IAAO,EAAU,EAAY,QAAQ,GACrC,IAAW,EAAU,EAAY,WAAW,EAAO,QAAQ,GAC3D,IAAW,EAAU,EAAY,YAAY,EAAO,SAAS,GAE7D,IACF,KAAK,IAAI,IAAW,CAAC,KAAK,IAAI,KAAK,IAAI,CAAI,IAAI,KAAK,IAAI,CAAI,IAAI,KAAK,IAAI,IAAW,CAAC,KAAK;CAE9F,OAAO,IAAI,IAAkB,KAAK,KAAK,KAAK,KAAK,CAAC,CAAC;AACvD;AASA,SAAgB,EAAa,GAAuC;CAChE,IAAI,IAAQ;CACZ,KAAK,IAAI,IAAI,GAAG,IAAI,EAAO,QAAQ,KAAK,GACpC,KAAS,EAAY,EAAO,IAAI,IAAI,EAAO,EAAE;CAEjD,OAAO;AACX;AAWA,SAAgB,EAAW,GAAoB,GAAiC;CAC5E,IAAM,IAAO,EAAU,EAAO,QAAQ,GAChC,IAAO,EAAU,EAAY,QAAQ,GACrC,IAAW,EAAU,EAAY,YAAY,EAAO,SAAS,GAE7D,IAAI,KAAK,IAAI,CAAQ,IAAI,KAAK,IAAI,CAAI,GACtC,IACF,KAAK,IAAI,CAAI,IAAI,KAAK,IAAI,CAAI,IAAI,KAAK,IAAI,CAAI,IAAI,KAAK,IAAI,CAAI,IAAI,KAAK,IAAI,CAAQ;CAGzF,QADiB,KAAK,MAAM,GAAG,CAAC,IAAI,MAAO,KAAK,KAC9B,OAAO;AAC7B"}

package/dist/geo/estimate.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const A=require("./distance.cjs"),o=1.3,i=50,s={car:1,motorcycle:.95,bus:1.6};function u(t,r){return r?.[t]??s[t]??1}function E(t,r,e="car",_={}){const{circuityFactor:n=o,carSpeedKmh:c=i,modeDurationFactors:T}=_;if(c<=0)throw new RangeError("carSpeedKmh must be greater than 0");if(n<=0)throw new RangeError("circuityFactor must be greater than 0");const a=A.haversineKm(t,r)*n,F=a/c*60*u(e,T);return{mode:e,distance_km:a,duration_minutes:F,source:"heuristic"}}exports.DEFAULT_CAR_SPEED_KMH=i;exports.DEFAULT_CIRCUITY_FACTOR=o;exports.DEFAULT_MODE_DURATION_FACTORS=s;exports.durationFactor=u;exports.estimateTravel=E;
-//# sourceMappingURL=estimate.cjs.map
+const e=require("./distance.cjs");var t=1.3,n=50,r={car:1,motorcycle:.95,bus:1.6};function i(e,t){return t?.[e]??r[e]??1}function a(n,r,a=`car`,o={}){let{circuityFactor:s=t,carSpeedKmh:c=50,modeDurationFactors:l}=o;if(c<=0)throw RangeError(`carSpeedKmh must be greater than 0`);if(s<=0)throw RangeError(`circuityFactor must be greater than 0`);let u=e.haversineKm(n,r)*s;return{mode:a,distance_km:u,duration_minutes:u/c*60*i(a,l),source:`heuristic`}}exports.DEFAULT_CAR_SPEED_KMH=n,exports.DEFAULT_CIRCUITY_FACTOR=t,exports.DEFAULT_MODE_DURATION_FACTORS=r,exports.durationFactor=i,exports.estimateTravel=a;
+//# sourceMappingURL=estimate.cjs.map

package/dist/geo/estimate.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"estimate.cjs","sources":["../../src/geo/estimate.ts"],"sourcesContent":["import { haversineKm } from \"./distance\";\nimport type { Coordinate, TravelEstimate, TravelMode } from \"./types\";\n\n/**\n * Multiplier applied to the great-circle distance to approximate real road\n * distance. Mirrors `DEFAULT_CIRCUITY_FACTOR` from `tempest-fastapi-sdk`.\n */\nexport const DEFAULT_CIRCUITY_FACTOR = 1.3;\n\n/**\n * Default average car speed in km/h used to derive duration from distance.\n * Mirrors `DEFAULT_CAR_SPEED_KMH` from `tempest-fastapi-sdk`.\n */\nexport const DEFAULT_CAR_SPEED_KMH = 50.0;\n\n/**\n * Per-mode multipliers applied to the car duration. Mirrors\n * `DEFAULT_MODE_DURATION_FACTORS` from `tempest-fastapi-sdk` — motorcycles are\n * a touch faster, buses considerably slower (stops + dedicated lanes).\n */\nexport const DEFAULT_MODE_DURATION_FACTORS: Record<TravelMode, number> = {\n    car: 1.0,\n    motorcycle: 0.95,\n    bus: 1.6,\n};\n\n/**\n * Look up the duration multiplier for a travel mode, falling back to `1.0`\n * for unknown modes. Mirrors `duration_factor` from `tempest-fastapi-sdk`.\n *\n * @param mode - Travel mode.\n * @param factors - Optional override map (partial merges over the defaults).\n * @returns The multiplier for `mode`.\n */\nexport function durationFactor(\n    mode: TravelMode,\n    factors?: Partial<Record<TravelMode, number>>,\n): number {\n    return factors?.[mode] ?? DEFAULT_MODE_DURATION_FACTORS[mode] ?? 1.0;\n}\n\n/** Options for {@link estimateTravel}. */\nexport interface EstimateTravelOptions {\n    /** Distance multiplier over the great-circle line. Default: `1.3`. */\n    circuityFactor?: number;\n    /** Average car speed in km/h. Default: `50`. */\n    carSpeedKmh?: number;\n    /** Per-mode duration multipliers (merged over the defaults). */\n    modeDurationFactors?: Partial<Record<TravelMode, number>>;\n}\n\n/**\n * Offline travel estimate between two coordinates. No network — distance comes\n * from {@link haversineKm} scaled by circuity, duration from a mode-adjusted\n * average speed. Mirrors `estimate_travel` from `tempest-fastapi-sdk`.\n *\n * @param origin - Start coordinate.\n * @param destination - End coordinate.\n * @param mode - Travel mode. Default: `\"car\"`.\n * @param options - Tuning knobs (circuity, speed, per-mode factors).\n * @returns A `\"heuristic\"` {@link TravelEstimate}.\n * @throws {RangeError} If `carSpeedKmh <= 0` or `circuityFactor <= 0`.\n *\n * @example\n * estimateTravel(\n *   { latitude: -23.5505, longitude: -46.6333 },\n *   { latitude: -23.5629, longitude: -46.6544 },\n *   \"car\",\n * ); // { mode: \"car\", distance_km: …, duration_minutes: …, source: \"heuristic\" }\n */\nexport function estimateTravel(\n    origin: Coordinate,\n    destination: Coordinate,\n    mode: TravelMode = \"car\",\n    options: EstimateTravelOptions = {},\n): TravelEstimate {\n    const {\n        circuityFactor = DEFAULT_CIRCUITY_FACTOR,\n        carSpeedKmh = DEFAULT_CAR_SPEED_KMH,\n        modeDurationFactors,\n    } = options;\n\n    if (carSpeedKmh <= 0) {\n        throw new RangeError(\"carSpeedKmh must be greater than 0\");\n    }\n    if (circuityFactor <= 0) {\n        throw new RangeError(\"circuityFactor must be greater than 0\");\n    }\n\n    const distanceKm = haversineKm(origin, destination) * circuityFactor;\n    const carMinutes = (distanceKm / carSpeedKmh) * 60.0;\n    const durationMinutes = carMinutes * durationFactor(mode, modeDurationFactors);\n\n    return {\n        mode,\n        distance_km: distanceKm,\n        duration_minutes: durationMinutes,\n        source: \"heuristic\",\n    };\n}\n"],"names":["DEFAULT_CIRCUITY_FACTOR","DEFAULT_CAR_SPEED_KMH","DEFAULT_MODE_DURATION_FACTORS","durationFactor","mode","factors","estimateTravel","origin","destination","options","circuityFactor","carSpeedKmh","modeDurationFactors","distanceKm","haversineKm","durationMinutes"],"mappings":"kHAOaA,EAA0B,IAM1BC,EAAwB,GAOxBC,EAA4D,CACrE,IAAK,EACL,WAAY,IACZ,IAAK,GACT,EAUO,SAASC,EACZC,EACAC,EACM,CACN,OAAOA,IAAUD,CAAI,GAAKF,EAA8BE,CAAI,GAAK,CACrE,CA+BO,SAASE,EACZC,EACAC,EACAJ,EAAmB,MACnBK,EAAiC,GACnB,CACd,KAAM,CACF,eAAAC,EAAiBV,EACjB,YAAAW,EAAcV,EACd,oBAAAW,CAAA,EACAH,EAEJ,GAAIE,GAAe,EACf,MAAM,IAAI,WAAW,oCAAoC,EAE7D,GAAID,GAAkB,EAClB,MAAM,IAAI,WAAW,uCAAuC,EAGhE,MAAMG,EAAaC,EAAAA,YAAYP,EAAQC,CAAW,EAAIE,EAEhDK,EADcF,EAAaF,EAAe,GACXR,EAAeC,EAAMQ,CAAmB,EAE7E,MAAO,CACH,KAAAR,EACA,YAAaS,EACb,iBAAkBE,EAClB,OAAQ,WAAA,CAEhB"}
+{"version":3,"file":"estimate.cjs","names":[],"sources":["../../src/geo/estimate.ts"],"sourcesContent":["import { haversineKm } from \"./distance\";\nimport type { Coordinate, TravelEstimate, TravelMode } from \"./types\";\n\n/**\n * Multiplier applied to the great-circle distance to approximate real road\n * distance. Mirrors `DEFAULT_CIRCUITY_FACTOR` from `tempest-fastapi-sdk`.\n */\nexport const DEFAULT_CIRCUITY_FACTOR = 1.3;\n\n/**\n * Default average car speed in km/h used to derive duration from distance.\n * Mirrors `DEFAULT_CAR_SPEED_KMH` from `tempest-fastapi-sdk`.\n */\nexport const DEFAULT_CAR_SPEED_KMH = 50.0;\n\n/**\n * Per-mode multipliers applied to the car duration. Mirrors\n * `DEFAULT_MODE_DURATION_FACTORS` from `tempest-fastapi-sdk` — motorcycles are\n * a touch faster, buses considerably slower (stops + dedicated lanes).\n */\nexport const DEFAULT_MODE_DURATION_FACTORS: Record<TravelMode, number> = {\n    car: 1.0,\n    motorcycle: 0.95,\n    bus: 1.6,\n};\n\n/**\n * Look up the duration multiplier for a travel mode, falling back to `1.0`\n * for unknown modes. Mirrors `duration_factor` from `tempest-fastapi-sdk`.\n *\n * @param mode - Travel mode.\n * @param factors - Optional override map (partial merges over the defaults).\n * @returns The multiplier for `mode`.\n */\nexport function durationFactor(\n    mode: TravelMode,\n    factors?: Partial<Record<TravelMode, number>>,\n): number {\n    return factors?.[mode] ?? DEFAULT_MODE_DURATION_FACTORS[mode] ?? 1.0;\n}\n\n/** Options for {@link estimateTravel}. */\nexport interface EstimateTravelOptions {\n    /** Distance multiplier over the great-circle line. Default: `1.3`. */\n    circuityFactor?: number;\n    /** Average car speed in km/h. Default: `50`. */\n    carSpeedKmh?: number;\n    /** Per-mode duration multipliers (merged over the defaults). */\n    modeDurationFactors?: Partial<Record<TravelMode, number>>;\n}\n\n/**\n * Offline travel estimate between two coordinates. No network — distance comes\n * from {@link haversineKm} scaled by circuity, duration from a mode-adjusted\n * average speed. Mirrors `estimate_travel` from `tempest-fastapi-sdk`.\n *\n * @param origin - Start coordinate.\n * @param destination - End coordinate.\n * @param mode - Travel mode. Default: `\"car\"`.\n * @param options - Tuning knobs (circuity, speed, per-mode factors).\n * @returns A `\"heuristic\"` {@link TravelEstimate}.\n * @throws {RangeError} If `carSpeedKmh <= 0` or `circuityFactor <= 0`.\n *\n * @example\n * estimateTravel(\n *   { latitude: -23.5505, longitude: -46.6333 },\n *   { latitude: -23.5629, longitude: -46.6544 },\n *   \"car\",\n * ); // { mode: \"car\", distance_km: …, duration_minutes: …, source: \"heuristic\" }\n */\nexport function estimateTravel(\n    origin: Coordinate,\n    destination: Coordinate,\n    mode: TravelMode = \"car\",\n    options: EstimateTravelOptions = {},\n): TravelEstimate {\n    const {\n        circuityFactor = DEFAULT_CIRCUITY_FACTOR,\n        carSpeedKmh = DEFAULT_CAR_SPEED_KMH,\n        modeDurationFactors,\n    } = options;\n\n    if (carSpeedKmh <= 0) {\n        throw new RangeError(\"carSpeedKmh must be greater than 0\");\n    }\n    if (circuityFactor <= 0) {\n        throw new RangeError(\"circuityFactor must be greater than 0\");\n    }\n\n    const distanceKm = haversineKm(origin, destination) * circuityFactor;\n    const carMinutes = (distanceKm / carSpeedKmh) * 60.0;\n    const durationMinutes = carMinutes * durationFactor(mode, modeDurationFactors);\n\n    return {\n        mode,\n        distance_km: distanceKm,\n        duration_minutes: durationMinutes,\n        source: \"heuristic\",\n    };\n}\n"],"mappings":"kCAOA,IAAa,EAA0B,IAM1B,EAAwB,GAOxB,EAA4D,CACrE,IAAK,EACL,WAAY,IACZ,IAAK,GACT,EAUA,SAAgB,EACZ,EACA,EACM,CACN,OAAO,IAAU,IAAS,EAA8B,IAAS,CACrE,CA+BA,SAAgB,EACZ,EACA,EACA,EAAmB,MACnB,EAAiC,CAAC,EACpB,CACd,GAAM,CACF,iBAAiB,EACjB,cAAA,GACA,uBACA,EAEJ,GAAI,GAAe,EACf,MAAU,WAAW,oCAAoC,EAE7D,GAAI,GAAkB,EAClB,MAAU,WAAW,uCAAuC,EAGhE,IAAM,EAAa,EAAA,YAAY,EAAQ,CAAW,EAAI,EAItD,MAAO,CACH,OACA,YAAa,EACb,iBANgB,EAAa,EAAe,GACX,EAAe,EAAM,CAAmB,EAMzE,OAAQ,WACZ,CACJ"}

package/dist/geo/estimate.js

@@ -1,35 +1,26 @@
-import { haversineKm as u } from "./distance.js";
-const m = 1.3, _ = 50, F = {
-  car: 1,
-  motorcycle: 0.95,
-  bus: 1.6
+import { haversineKm as e } from "./distance.js";
+//#region src/geo/estimate.ts
+var t = 1.3, n = 50, r = {
+	car: 1,
+	motorcycle: .95,
+	bus: 1.6
 };
-function h(t, r) {
-  return r?.[t] ?? F[t] ?? 1;
+function i(e, t) {
+	return t?.[e] ?? r[e] ?? 1;
 }
-function A(t, r, e = "car", a = {}) {
-  const {
-    circuityFactor: n = m,
-    carSpeedKmh: c = _,
-    modeDurationFactors: i
-  } = a;
-  if (c <= 0)
-    throw new RangeError("carSpeedKmh must be greater than 0");
-  if (n <= 0)
-    throw new RangeError("circuityFactor must be greater than 0");
-  const o = u(t, r) * n, s = o / c * 60 * h(e, i);
-  return {
-    mode: e,
-    distance_km: o,
-    duration_minutes: s,
-    source: "heuristic"
-  };
+function a(n, r, a = "car", o = {}) {
+	let { circuityFactor: s = t, carSpeedKmh: c = 50, modeDurationFactors: l } = o;
+	if (c <= 0) throw RangeError("carSpeedKmh must be greater than 0");
+	if (s <= 0) throw RangeError("circuityFactor must be greater than 0");
+	let u = e(n, r) * s;
+	return {
+		mode: a,
+		distance_km: u,
+		duration_minutes: u / c * 60 * i(a, l),
+		source: "heuristic"
+	};
 }
-export {
-  _ as DEFAULT_CAR_SPEED_KMH,
-  m as DEFAULT_CIRCUITY_FACTOR,
-  F as DEFAULT_MODE_DURATION_FACTORS,
-  h as durationFactor,
-  A as estimateTravel
-};
-//# sourceMappingURL=estimate.js.map
+//#endregion
+export { n as DEFAULT_CAR_SPEED_KMH, t as DEFAULT_CIRCUITY_FACTOR, r as DEFAULT_MODE_DURATION_FACTORS, i as durationFactor, a as estimateTravel };
+
+//# sourceMappingURL=estimate.js.map

package/dist/geo/estimate.js.map

@@ -1 +1 @@
-{"version":3,"file":"estimate.js","sources":["../../src/geo/estimate.ts"],"sourcesContent":["import { haversineKm } from \"./distance\";\nimport type { Coordinate, TravelEstimate, TravelMode } from \"./types\";\n\n/**\n * Multiplier applied to the great-circle distance to approximate real road\n * distance. Mirrors `DEFAULT_CIRCUITY_FACTOR` from `tempest-fastapi-sdk`.\n */\nexport const DEFAULT_CIRCUITY_FACTOR = 1.3;\n\n/**\n * Default average car speed in km/h used to derive duration from distance.\n * Mirrors `DEFAULT_CAR_SPEED_KMH` from `tempest-fastapi-sdk`.\n */\nexport const DEFAULT_CAR_SPEED_KMH = 50.0;\n\n/**\n * Per-mode multipliers applied to the car duration. Mirrors\n * `DEFAULT_MODE_DURATION_FACTORS` from `tempest-fastapi-sdk` — motorcycles are\n * a touch faster, buses considerably slower (stops + dedicated lanes).\n */\nexport const DEFAULT_MODE_DURATION_FACTORS: Record<TravelMode, number> = {\n    car: 1.0,\n    motorcycle: 0.95,\n    bus: 1.6,\n};\n\n/**\n * Look up the duration multiplier for a travel mode, falling back to `1.0`\n * for unknown modes. Mirrors `duration_factor` from `tempest-fastapi-sdk`.\n *\n * @param mode - Travel mode.\n * @param factors - Optional override map (partial merges over the defaults).\n * @returns The multiplier for `mode`.\n */\nexport function durationFactor(\n    mode: TravelMode,\n    factors?: Partial<Record<TravelMode, number>>,\n): number {\n    return factors?.[mode] ?? DEFAULT_MODE_DURATION_FACTORS[mode] ?? 1.0;\n}\n\n/** Options for {@link estimateTravel}. */\nexport interface EstimateTravelOptions {\n    /** Distance multiplier over the great-circle line. Default: `1.3`. */\n    circuityFactor?: number;\n    /** Average car speed in km/h. Default: `50`. */\n    carSpeedKmh?: number;\n    /** Per-mode duration multipliers (merged over the defaults). */\n    modeDurationFactors?: Partial<Record<TravelMode, number>>;\n}\n\n/**\n * Offline travel estimate between two coordinates. No network — distance comes\n * from {@link haversineKm} scaled by circuity, duration from a mode-adjusted\n * average speed. Mirrors `estimate_travel` from `tempest-fastapi-sdk`.\n *\n * @param origin - Start coordinate.\n * @param destination - End coordinate.\n * @param mode - Travel mode. Default: `\"car\"`.\n * @param options - Tuning knobs (circuity, speed, per-mode factors).\n * @returns A `\"heuristic\"` {@link TravelEstimate}.\n * @throws {RangeError} If `carSpeedKmh <= 0` or `circuityFactor <= 0`.\n *\n * @example\n * estimateTravel(\n *   { latitude: -23.5505, longitude: -46.6333 },\n *   { latitude: -23.5629, longitude: -46.6544 },\n *   \"car\",\n * ); // { mode: \"car\", distance_km: …, duration_minutes: …, source: \"heuristic\" }\n */\nexport function estimateTravel(\n    origin: Coordinate,\n    destination: Coordinate,\n    mode: TravelMode = \"car\",\n    options: EstimateTravelOptions = {},\n): TravelEstimate {\n    const {\n        circuityFactor = DEFAULT_CIRCUITY_FACTOR,\n        carSpeedKmh = DEFAULT_CAR_SPEED_KMH,\n        modeDurationFactors,\n    } = options;\n\n    if (carSpeedKmh <= 0) {\n        throw new RangeError(\"carSpeedKmh must be greater than 0\");\n    }\n    if (circuityFactor <= 0) {\n        throw new RangeError(\"circuityFactor must be greater than 0\");\n    }\n\n    const distanceKm = haversineKm(origin, destination) * circuityFactor;\n    const carMinutes = (distanceKm / carSpeedKmh) * 60.0;\n    const durationMinutes = carMinutes * durationFactor(mode, modeDurationFactors);\n\n    return {\n        mode,\n        distance_km: distanceKm,\n        duration_minutes: durationMinutes,\n        source: \"heuristic\",\n    };\n}\n"],"names":["DEFAULT_CIRCUITY_FACTOR","DEFAULT_CAR_SPEED_KMH","DEFAULT_MODE_DURATION_FACTORS","durationFactor","mode","factors","estimateTravel","origin","destination","options","circuityFactor","carSpeedKmh","modeDurationFactors","distanceKm","haversineKm","durationMinutes"],"mappings":";AAOO,MAAMA,IAA0B,KAM1BC,IAAwB,IAOxBC,IAA4D;AAAA,EACrE,KAAK;AAAA,EACL,YAAY;AAAA,EACZ,KAAK;AACT;AAUO,SAASC,EACZC,GACAC,GACM;AACN,SAAOA,IAAUD,CAAI,KAAKF,EAA8BE,CAAI,KAAK;AACrE;AA+BO,SAASE,EACZC,GACAC,GACAJ,IAAmB,OACnBK,IAAiC,IACnB;AACd,QAAM;AAAA,IACF,gBAAAC,IAAiBV;AAAA,IACjB,aAAAW,IAAcV;AAAA,IACd,qBAAAW;AAAA,EAAA,IACAH;AAEJ,MAAIE,KAAe;AACf,UAAM,IAAI,WAAW,oCAAoC;AAE7D,MAAID,KAAkB;AAClB,UAAM,IAAI,WAAW,uCAAuC;AAGhE,QAAMG,IAAaC,EAAYP,GAAQC,CAAW,IAAIE,GAEhDK,IADcF,IAAaF,IAAe,KACXR,EAAeC,GAAMQ,CAAmB;AAE7E,SAAO;AAAA,IACH,MAAAR;AAAA,IACA,aAAaS;AAAA,IACb,kBAAkBE;AAAA,IAClB,QAAQ;AAAA,EAAA;AAEhB;"}
+{"version":3,"file":"estimate.js","names":[],"sources":["../../src/geo/estimate.ts"],"sourcesContent":["import { haversineKm } from \"./distance\";\nimport type { Coordinate, TravelEstimate, TravelMode } from \"./types\";\n\n/**\n * Multiplier applied to the great-circle distance to approximate real road\n * distance. Mirrors `DEFAULT_CIRCUITY_FACTOR` from `tempest-fastapi-sdk`.\n */\nexport const DEFAULT_CIRCUITY_FACTOR = 1.3;\n\n/**\n * Default average car speed in km/h used to derive duration from distance.\n * Mirrors `DEFAULT_CAR_SPEED_KMH` from `tempest-fastapi-sdk`.\n */\nexport const DEFAULT_CAR_SPEED_KMH = 50.0;\n\n/**\n * Per-mode multipliers applied to the car duration. Mirrors\n * `DEFAULT_MODE_DURATION_FACTORS` from `tempest-fastapi-sdk` — motorcycles are\n * a touch faster, buses considerably slower (stops + dedicated lanes).\n */\nexport const DEFAULT_MODE_DURATION_FACTORS: Record<TravelMode, number> = {\n    car: 1.0,\n    motorcycle: 0.95,\n    bus: 1.6,\n};\n\n/**\n * Look up the duration multiplier for a travel mode, falling back to `1.0`\n * for unknown modes. Mirrors `duration_factor` from `tempest-fastapi-sdk`.\n *\n * @param mode - Travel mode.\n * @param factors - Optional override map (partial merges over the defaults).\n * @returns The multiplier for `mode`.\n */\nexport function durationFactor(\n    mode: TravelMode,\n    factors?: Partial<Record<TravelMode, number>>,\n): number {\n    return factors?.[mode] ?? DEFAULT_MODE_DURATION_FACTORS[mode] ?? 1.0;\n}\n\n/** Options for {@link estimateTravel}. */\nexport interface EstimateTravelOptions {\n    /** Distance multiplier over the great-circle line. Default: `1.3`. */\n    circuityFactor?: number;\n    /** Average car speed in km/h. Default: `50`. */\n    carSpeedKmh?: number;\n    /** Per-mode duration multipliers (merged over the defaults). */\n    modeDurationFactors?: Partial<Record<TravelMode, number>>;\n}\n\n/**\n * Offline travel estimate between two coordinates. No network — distance comes\n * from {@link haversineKm} scaled by circuity, duration from a mode-adjusted\n * average speed. Mirrors `estimate_travel` from `tempest-fastapi-sdk`.\n *\n * @param origin - Start coordinate.\n * @param destination - End coordinate.\n * @param mode - Travel mode. Default: `\"car\"`.\n * @param options - Tuning knobs (circuity, speed, per-mode factors).\n * @returns A `\"heuristic\"` {@link TravelEstimate}.\n * @throws {RangeError} If `carSpeedKmh <= 0` or `circuityFactor <= 0`.\n *\n * @example\n * estimateTravel(\n *   { latitude: -23.5505, longitude: -46.6333 },\n *   { latitude: -23.5629, longitude: -46.6544 },\n *   \"car\",\n * ); // { mode: \"car\", distance_km: …, duration_minutes: …, source: \"heuristic\" }\n */\nexport function estimateTravel(\n    origin: Coordinate,\n    destination: Coordinate,\n    mode: TravelMode = \"car\",\n    options: EstimateTravelOptions = {},\n): TravelEstimate {\n    const {\n        circuityFactor = DEFAULT_CIRCUITY_FACTOR,\n        carSpeedKmh = DEFAULT_CAR_SPEED_KMH,\n        modeDurationFactors,\n    } = options;\n\n    if (carSpeedKmh <= 0) {\n        throw new RangeError(\"carSpeedKmh must be greater than 0\");\n    }\n    if (circuityFactor <= 0) {\n        throw new RangeError(\"circuityFactor must be greater than 0\");\n    }\n\n    const distanceKm = haversineKm(origin, destination) * circuityFactor;\n    const carMinutes = (distanceKm / carSpeedKmh) * 60.0;\n    const durationMinutes = carMinutes * durationFactor(mode, modeDurationFactors);\n\n    return {\n        mode,\n        distance_km: distanceKm,\n        duration_minutes: durationMinutes,\n        source: \"heuristic\",\n    };\n}\n"],"mappings":";;AAOA,IAAa,IAA0B,KAM1B,IAAwB,IAOxB,IAA4D;CACrE,KAAK;CACL,YAAY;CACZ,KAAK;AACT;AAUA,SAAgB,EACZ,GACA,GACM;CACN,OAAO,IAAU,MAAS,EAA8B,MAAS;AACrE;AA+BA,SAAgB,EACZ,GACA,GACA,IAAmB,OACnB,IAAiC,CAAC,GACpB;CACd,IAAM,EACF,oBAAiB,GACjB,iBAAA,IACA,2BACA;CAEJ,IAAI,KAAe,GACf,MAAU,WAAW,oCAAoC;CAE7D,IAAI,KAAkB,GAClB,MAAU,WAAW,uCAAuC;CAGhE,IAAM,IAAa,EAAY,GAAQ,CAAW,IAAI;CAItD,OAAO;EACH;EACA,aAAa;EACb,kBANgB,IAAa,IAAe,KACX,EAAe,GAAM,CAAmB;EAMzE,QAAQ;CACZ;AACJ"}

package/dist/geo/leaflet-map.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const L=require("react/jsx-runtime"),c=require("react"),p=require("./bounds.cjs");function x({points:t,current:o,tileUrl:s,tileAttribution:f,strokeColor:i}){const l=c.useRef(null),[g,b]=c.useState(null);return c.useEffect(()=>{let e=null,n=!1;return import("leaflet").then(m=>{if(n||!l.current)return;const r=m.default??m;e=r.map(l.current,{attributionControl:!0}),r.tileLayer(s,{attribution:f??"",maxZoom:19}).addTo(e);const u=t.map(h=>[h.latitude,h.longitude]);u.length>0&&(r.polyline(u,{color:i??"#2563eb",weight:4}).addTo(e),r.circleMarker(u[0],{radius:6,color:"#16a34a"}).addTo(e));const d=o??t[t.length-1];d&&r.circleMarker([d.latitude,d.longitude],{radius:6,color:i??"#2563eb"}).addTo(e);const a=p.boundingBox(o?[...t,o]:[...t]);a?e.fitBounds([[a.minLatitude,a.minLongitude],[a.maxLatitude,a.maxLongitude]],{padding:[24,24]}):e.setView([0,0],2)}).catch(()=>{n||b("Leaflet não encontrado. Instale `leaflet` para usar tiles, ou remova `tileUrl` para o plot SVG.")}),()=>{n=!0,e?.remove()}},[t,o,s,f,i]),g?L.jsx("div",{style:{padding:16,fontSize:13,color:"var(--tempest-danger-fg)"},children:g}):L.jsx("div",{ref:l,style:{width:"100%",height:"100%"}})}exports.LeafletTrajectory=x;
-//# sourceMappingURL=leaflet-map.cjs.map
+const e=require("./bounds.cjs");let t=require("react"),n=require("react/jsx-runtime");function r({points:r,current:i,tileUrl:a,tileAttribution:o,strokeColor:s}){let c=(0,t.useRef)(null),[l,u]=(0,t.useState)(null);return(0,t.useEffect)(()=>{let t=null,n=!1;return import(`leaflet`).then(l=>{if(n||!c.current)return;let u=l.default??l;t=u.map(c.current,{attributionControl:!0}),u.tileLayer(a,{attribution:o??``,maxZoom:19}).addTo(t);let d=r.map(e=>[e.latitude,e.longitude]);d.length>0&&(u.polyline(d,{color:s??`#2563eb`,weight:4}).addTo(t),u.circleMarker(d[0],{radius:6,color:`#16a34a`}).addTo(t));let f=i??r[r.length-1];f&&u.circleMarker([f.latitude,f.longitude],{radius:6,color:s??`#2563eb`}).addTo(t);let p=e.boundingBox(i?[...r,i]:[...r]);p?t.fitBounds([[p.minLatitude,p.minLongitude],[p.maxLatitude,p.maxLongitude]],{padding:[24,24]}):t.setView([0,0],2)}).catch(()=>{n||u("Leaflet não encontrado. Instale `leaflet` para usar tiles, ou remova `tileUrl` para o plot SVG.")}),()=>{n=!0,t?.remove()}},[r,i,a,o,s]),l?(0,n.jsx)(`div`,{style:{padding:16,fontSize:13,color:`var(--tempest-danger-fg)`},children:l}):(0,n.jsx)(`div`,{ref:c,style:{width:`100%`,height:`100%`}})}exports.LeafletTrajectory=r;
+//# sourceMappingURL=leaflet-map.cjs.map

package/dist/geo/leaflet-map.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"leaflet-map.cjs","sources":["../../src/geo/leaflet-map.tsx"],"sourcesContent":["import { useEffect, useRef, useState } from \"react\";\nimport { boundingBox } from \"./bounds\";\nimport type { Coordinate } from \"./types\";\n\n/**\n * Minimal structural typing for the slice of the Leaflet API this layer uses.\n * Declared locally so the SDK type-checks and builds even when `leaflet` (an\n * optional peer) is not installed — the real module is loaded at runtime.\n */\ninterface LeafletMapInstance {\n    setView: (center: [number, number], zoom: number) => LeafletMapInstance;\n    fitBounds: (bounds: [[number, number], [number, number]], options?: unknown) => void;\n    remove: () => void;\n}\ninterface LeafletLayer {\n    addTo: (map: LeafletMapInstance) => LeafletLayer;\n}\ninterface LeafletModule {\n    map: (el: HTMLElement, options?: unknown) => LeafletMapInstance;\n    tileLayer: (url: string, options?: unknown) => LeafletLayer;\n    polyline: (latlngs: [number, number][], options?: unknown) => LeafletLayer;\n    circleMarker: (latlng: [number, number], options?: unknown) => LeafletLayer;\n}\n\nexport interface LeafletTrajectoryProps {\n    points: readonly Coordinate[];\n    current?: Coordinate | null;\n    tileUrl: string;\n    tileAttribution?: string;\n    strokeColor?: string;\n}\n\n/**\n * Leaflet-backed tile layer for {@link TrajectoryMap}. Loaded lazily and only\n * when a `tileUrl` is provided. Requires `leaflet` to be installed by the app\n * (optional peer dependency) plus its stylesheet imported once:\n * `import \"leaflet/dist/leaflet.css\"`.\n */\nexport function LeafletTrajectory({\n    points,\n    current,\n    tileUrl,\n    tileAttribution,\n    strokeColor,\n}: LeafletTrajectoryProps) {\n    const nodeRef = useRef<HTMLDivElement>(null);\n    const [error, setError] = useState<string | null>(null);\n\n    useEffect(() => {\n        let map: LeafletMapInstance | null = null;\n        let cancelled = false;\n\n        const specifier = \"leaflet\";\n        import(/* @vite-ignore */ specifier)\n            .then((mod: { default?: LeafletModule } & LeafletModule) => {\n                if (cancelled || !nodeRef.current) return;\n                const L: LeafletModule = mod.default ?? mod;\n\n                map = L.map(nodeRef.current, { attributionControl: true });\n                L.tileLayer(tileUrl, {\n                    attribution: tileAttribution ?? \"\",\n                    maxZoom: 19,\n                }).addTo(map);\n\n                const latlngs = points.map((p): [number, number] => [p.latitude, p.longitude]);\n                if (latlngs.length > 0) {\n                    L.polyline(latlngs, {\n                        color: strokeColor ?? \"#2563eb\",\n                        weight: 4,\n                    }).addTo(map);\n                    L.circleMarker(latlngs[0], { radius: 6, color: \"#16a34a\" }).addTo(map);\n                }\n\n                const marker = current ?? points[points.length - 1];\n                if (marker) {\n                    L.circleMarker([marker.latitude, marker.longitude], {\n                        radius: 6,\n                        color: strokeColor ?? \"#2563eb\",\n                    }).addTo(map);\n                }\n\n                const box = boundingBox(current ? [...points, current] : [...points]);\n                if (box) {\n                    map.fitBounds(\n                        [\n                            [box.minLatitude, box.minLongitude],\n                            [box.maxLatitude, box.maxLongitude],\n                        ],\n                        { padding: [24, 24] },\n                    );\n                } else {\n                    map.setView([0, 0], 2);\n                }\n            })\n            .catch(() => {\n                if (!cancelled) {\n                    setError(\n                        \"Leaflet não encontrado. Instale `leaflet` para usar tiles, ou remova `tileUrl` para o plot SVG.\",\n                    );\n                }\n            });\n\n        return () => {\n            cancelled = true;\n            map?.remove();\n        };\n    }, [points, current, tileUrl, tileAttribution, strokeColor]);\n\n    if (error) {\n        return (\n            <div style={{ padding: 16, fontSize: 13, color: \"var(--tempest-danger-fg)\" }}>\n                {error}\n            </div>\n        );\n    }\n\n    return <div ref={nodeRef} style={{ width: \"100%\", height: \"100%\" }} />;\n}\n"],"names":["LeafletTrajectory","points","current","tileUrl","tileAttribution","strokeColor","nodeRef","useRef","error","setError","useState","useEffect","map","cancelled","mod","L","latlngs","p","marker","box","boundingBox","jsx"],"mappings":"kKAsCO,SAASA,EAAkB,CAC9B,OAAAC,EACA,QAAAC,EACA,QAAAC,EACA,gBAAAC,EACA,YAAAC,CACJ,EAA2B,CACvB,MAAMC,EAAUC,EAAAA,OAAuB,IAAI,EACrC,CAACC,EAAOC,CAAQ,EAAIC,EAAAA,SAAwB,IAAI,EA8DtD,OA5DAC,EAAAA,UAAU,IAAM,CACZ,IAAIC,EAAiC,KACjCC,EAAY,GAGhB,cADkB,WAEb,KAAMC,GAAqD,CACxD,GAAID,GAAa,CAACP,EAAQ,QAAS,OACnC,MAAMS,EAAmBD,EAAI,SAAWA,EAExCF,EAAMG,EAAE,IAAIT,EAAQ,QAAS,CAAE,mBAAoB,GAAM,EACzDS,EAAE,UAAUZ,EAAS,CACjB,YAAaC,GAAmB,GAChC,QAAS,EAAA,CACZ,EAAE,MAAMQ,CAAG,EAEZ,MAAMI,EAAUf,EAAO,IAAKgB,GAAwB,CAACA,EAAE,SAAUA,EAAE,SAAS,CAAC,EACzED,EAAQ,OAAS,IACjBD,EAAE,SAASC,EAAS,CAChB,MAAOX,GAAe,UACtB,OAAQ,CAAA,CACX,EAAE,MAAMO,CAAG,EACZG,EAAE,aAAaC,EAAQ,CAAC,EAAG,CAAE,OAAQ,EAAG,MAAO,SAAA,CAAW,EAAE,MAAMJ,CAAG,GAGzE,MAAMM,EAAShB,GAAWD,EAAOA,EAAO,OAAS,CAAC,EAC9CiB,GACAH,EAAE,aAAa,CAACG,EAAO,SAAUA,EAAO,SAAS,EAAG,CAChD,OAAQ,EACR,MAAOb,GAAe,SAAA,CACzB,EAAE,MAAMO,CAAG,EAGhB,MAAMO,EAAMC,cAAYlB,EAAU,CAAC,GAAGD,EAAQC,CAAO,EAAI,CAAC,GAAGD,CAAM,CAAC,EAChEkB,EACAP,EAAI,UACA,CACI,CAACO,EAAI,YAAaA,EAAI,YAAY,EAClC,CAACA,EAAI,YAAaA,EAAI,YAAY,CAAA,EAEtC,CAAE,QAAS,CAAC,GAAI,EAAE,CAAA,CAAE,EAGxBP,EAAI,QAAQ,CAAC,EAAG,CAAC,EAAG,CAAC,CAE7B,CAAC,EACA,MAAM,IAAM,CACJC,GACDJ,EACI,iGAAA,CAGZ,CAAC,EAEE,IAAM,CACTI,EAAY,GACZD,GAAK,OAAA,CACT,CACJ,EAAG,CAACX,EAAQC,EAASC,EAASC,EAAiBC,CAAW,CAAC,EAEvDG,EAEIa,EAAAA,IAAC,MAAA,CAAI,MAAO,CAAE,QAAS,GAAI,SAAU,GAAI,MAAO,0BAAA,EAC3C,SAAAb,CAAA,CACL,EAIDa,MAAC,MAAA,CAAI,IAAKf,EAAS,MAAO,CAAE,MAAO,OAAQ,OAAQ,MAAA,CAAO,CAAG,CACxE"}
+{"version":3,"file":"leaflet-map.cjs","names":[],"sources":["../../src/geo/leaflet-map.tsx"],"sourcesContent":["import { useEffect, useRef, useState } from \"react\";\nimport { boundingBox } from \"./bounds\";\nimport type { Coordinate } from \"./types\";\n\n/**\n * Minimal structural typing for the slice of the Leaflet API this layer uses.\n * Declared locally so the SDK type-checks and builds even when `leaflet` (an\n * optional peer) is not installed — the real module is loaded at runtime.\n */\ninterface LeafletMapInstance {\n    setView: (center: [number, number], zoom: number) => LeafletMapInstance;\n    fitBounds: (bounds: [[number, number], [number, number]], options?: unknown) => void;\n    remove: () => void;\n}\ninterface LeafletLayer {\n    addTo: (map: LeafletMapInstance) => LeafletLayer;\n}\ninterface LeafletModule {\n    map: (el: HTMLElement, options?: unknown) => LeafletMapInstance;\n    tileLayer: (url: string, options?: unknown) => LeafletLayer;\n    polyline: (latlngs: [number, number][], options?: unknown) => LeafletLayer;\n    circleMarker: (latlng: [number, number], options?: unknown) => LeafletLayer;\n}\n\nexport interface LeafletTrajectoryProps {\n    points: readonly Coordinate[];\n    current?: Coordinate | null;\n    tileUrl: string;\n    tileAttribution?: string;\n    strokeColor?: string;\n}\n\n/**\n * Leaflet-backed tile layer for {@link TrajectoryMap}. Loaded lazily and only\n * when a `tileUrl` is provided. Requires `leaflet` to be installed by the app\n * (optional peer dependency) plus its stylesheet imported once:\n * `import \"leaflet/dist/leaflet.css\"`.\n */\nexport function LeafletTrajectory({\n    points,\n    current,\n    tileUrl,\n    tileAttribution,\n    strokeColor,\n}: LeafletTrajectoryProps) {\n    const nodeRef = useRef<HTMLDivElement>(null);\n    const [error, setError] = useState<string | null>(null);\n\n    useEffect(() => {\n        let map: LeafletMapInstance | null = null;\n        let cancelled = false;\n\n        const specifier = \"leaflet\";\n        import(/* @vite-ignore */ specifier)\n            .then((mod: { default?: LeafletModule } & LeafletModule) => {\n                if (cancelled || !nodeRef.current) return;\n                const L: LeafletModule = mod.default ?? mod;\n\n                map = L.map(nodeRef.current, { attributionControl: true });\n                L.tileLayer(tileUrl, {\n                    attribution: tileAttribution ?? \"\",\n                    maxZoom: 19,\n                }).addTo(map);\n\n                const latlngs = points.map((p): [number, number] => [p.latitude, p.longitude]);\n                if (latlngs.length > 0) {\n                    L.polyline(latlngs, {\n                        color: strokeColor ?? \"#2563eb\",\n                        weight: 4,\n                    }).addTo(map);\n                    L.circleMarker(latlngs[0], { radius: 6, color: \"#16a34a\" }).addTo(map);\n                }\n\n                const marker = current ?? points[points.length - 1];\n                if (marker) {\n                    L.circleMarker([marker.latitude, marker.longitude], {\n                        radius: 6,\n                        color: strokeColor ?? \"#2563eb\",\n                    }).addTo(map);\n                }\n\n                const box = boundingBox(current ? [...points, current] : [...points]);\n                if (box) {\n                    map.fitBounds(\n                        [\n                            [box.minLatitude, box.minLongitude],\n                            [box.maxLatitude, box.maxLongitude],\n                        ],\n                        { padding: [24, 24] },\n                    );\n                } else {\n                    map.setView([0, 0], 2);\n                }\n            })\n            .catch(() => {\n                if (!cancelled) {\n                    setError(\n                        \"Leaflet não encontrado. Instale `leaflet` para usar tiles, ou remova `tileUrl` para o plot SVG.\",\n                    );\n                }\n            });\n\n        return () => {\n            cancelled = true;\n            map?.remove();\n        };\n    }, [points, current, tileUrl, tileAttribution, strokeColor]);\n\n    if (error) {\n        return (\n            <div style={{ padding: 16, fontSize: 13, color: \"var(--tempest-danger-fg)\" }}>\n                {error}\n            </div>\n        );\n    }\n\n    return <div ref={nodeRef} style={{ width: \"100%\", height: \"100%\" }} />;\n}\n"],"mappings":"sFAsCA,SAAgB,EAAkB,CAC9B,SACA,UACA,UACA,kBACA,eACuB,CACvB,IAAM,GAAA,EAAA,EAAA,OAAA,CAAiC,IAAI,EACrC,CAAC,EAAO,IAAA,EAAA,EAAA,SAAA,CAAoC,IAAI,EAsEtD,OApEA,EAAA,EAAA,UAAA,KAAgB,CACZ,IAAI,EAAiC,KACjC,EAAY,GAoDhB,OAjDA,OAA0B,UAAU,CAC/B,KAAM,GAAqD,CACxD,GAAI,GAAa,CAAC,EAAQ,QAAS,OACnC,IAAM,EAAmB,EAAI,SAAW,EAExC,EAAM,EAAE,IAAI,EAAQ,QAAS,CAAE,mBAAoB,EAAK,CAAC,EACzD,EAAE,UAAU,EAAS,CACjB,YAAa,GAAmB,GAChC,QAAS,EACb,CAAC,CAAC,CAAC,MAAM,CAAG,EAEZ,IAAM,EAAU,EAAO,IAAK,GAAwB,CAAC,EAAE,SAAU,EAAE,SAAS,CAAC,EACzE,EAAQ,OAAS,IACjB,EAAE,SAAS,EAAS,CAChB,MAAO,GAAe,UACtB,OAAQ,CACZ,CAAC,CAAC,CAAC,MAAM,CAAG,EACZ,EAAE,aAAa,EAAQ,GAAI,CAAE,OAAQ,EAAG,MAAO,SAAU,CAAC,CAAC,CAAC,MAAM,CAAG,GAGzE,IAAM,EAAS,GAAW,EAAO,EAAO,OAAS,GAC7C,GACA,EAAE,aAAa,CAAC,EAAO,SAAU,EAAO,SAAS,EAAG,CAChD,OAAQ,EACR,MAAO,GAAe,SAC1B,CAAC,CAAC,CAAC,MAAM,CAAG,EAGhB,IAAM,EAAM,EAAA,YAAY,EAAU,CAAC,GAAG,EAAQ,CAAO,EAAI,CAAC,GAAG,CAAM,CAAC,EAChE,EACA,EAAI,UACA,CACI,CAAC,EAAI,YAAa,EAAI,YAAY,EAClC,CAAC,EAAI,YAAa,EAAI,YAAY,CACtC,EACA,CAAE,QAAS,CAAC,GAAI,EAAE,CAAE,CACxB,EAEA,EAAI,QAAQ,CAAC,EAAG,CAAC,EAAG,CAAC,CAE7B,CAAC,CAAC,CACD,UAAY,CACJ,GACD,EACI,iGACJ,CAER,CAAC,MAEQ,CACT,EAAY,GACZ,GAAK,OAAO,CAChB,CACJ,EAAG,CAAC,EAAQ,EAAS,EAAS,EAAiB,CAAW,CAAC,EAEvD,GAEI,EAAA,EAAA,IAAA,CAAC,MAAD,CAAK,MAAO,CAAE,QAAS,GAAI,SAAU,GAAI,MAAO,0BAA2B,WACtE,CACA,CAAA,GAIN,EAAA,EAAA,IAAA,CAAC,MAAD,CAAK,IAAK,EAAS,MAAO,CAAE,MAAO,OAAQ,OAAQ,MAAO,CAAI,CAAA,CACzE"}