tempest-react-sdk 0.22.0 → 0.24.0

package/dist/geo/TrajectoryMap.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"TrajectoryMap.cjs","names":[],"sources":["../../src/geo/TrajectoryMap.tsx"],"sourcesContent":["import { lazy, Suspense, useEffect, useMemo, useRef, useState, type HTMLAttributes } from \"react\";\nimport { cn } from \"@/utils/cn\";\nimport { boundingBox, expandBounds } from \"./bounds\";\nimport { haversineKm } from \"./distance\";\nimport { fitProjection, type PixelPoint } from \"./projection\";\nimport type { Coordinate, GeoMarker } from \"./types\";\nimport styles from \"./TrajectoryMap.module.css\";\n\n// Leaflet layer is loaded on demand — only when a `tileUrl` is supplied, so\n// apps that stick to the tile-free SVG never pull leaflet into their bundle.\nconst LeafletTrajectory = lazy(() =>\n    import(\"./leaflet-map\").then((m) => ({ default: m.LeafletTrajectory })),\n);\n\nexport interface TrajectoryMapProps extends Omit<HTMLAttributes<HTMLDivElement>, \"children\"> {\n    /** Ordered coordinates forming the trajectory. */\n    points: readonly Coordinate[];\n    /** Optional \"current position\" marker, drawn on top of the path. */\n    current?: Coordinate | null;\n    /** Viewport height in pixels. Default: `320`. */\n    height?: number;\n    /** Inner padding in pixels kept clear on every edge. Default: `24`. */\n    padding?: number;\n    /** Draw a light reference grid behind the path (SVG mode). Default: `true`. */\n    showGrid?: boolean;\n    /** Draw a distance scale bar (SVG mode). Default: `true`. */\n    showScale?: boolean;\n    /** Path stroke color. Default: the primary token. */\n    strokeColor?: string;\n    /**\n     * Tile URL template (`{z}/{x}/{y}`) of a map server **you host**. When set,\n     * the map upgrades to a real Leaflet tile layer (requires `leaflet` to be\n     * installed). Omit for the zero-dependency, zero-network SVG plot.\n     */\n    tileUrl?: string;\n    /** Attribution text shown over the tile layer. */\n    tileAttribution?: string;\n    /** Accessible label for the map region. Default: `\"Trajetória\"`. */\n    label?: string;\n    /** Point markers to overlay (e.g. stops, POIs). Included in the auto-fit. */\n    markers?: readonly GeoMarker[];\n    /** Fired when a marker is clicked. */\n    onMarkerClick?: (marker: GeoMarker, index: number) => void;\n}\n\nconst NICE_KM_STEPS = [0.05, 0.1, 0.25, 0.5, 1, 2, 5, 10, 25, 50, 100, 250, 500, 1000] as const;\n\n/** Pick the largest \"nice\" distance whose bar fits within `maxPixels`. */\nfunction pickScaleKm(kmPerPixel: number, maxPixels: number): { km: number; pixels: number } {\n    const maxKm = kmPerPixel * maxPixels;\n    let chosen: number = NICE_KM_STEPS[0];\n    for (const step of NICE_KM_STEPS) {\n        if (step <= maxKm) chosen = step;\n    }\n    return { km: chosen, pixels: chosen / kmPerPixel };\n}\n\n/** Format a distance in km for the scale bar (meters below 1 km). */\nfunction formatScale(km: number): string {\n    return km < 1 ? `${Math.round(km * 1000)} m` : `${km % 1 === 0 ? km : km.toFixed(1)} km`;\n}\n\n/**\n * Plot a GPS trajectory. By default it renders a **tile-free SVG** map (Web\n * Mercator projection, auto-fit to the points, optional grid + scale bar) —\n * 100% self-contained, no external tiles or paid API. Pass `tileUrl` pointing\n * at a map server **you host** to upgrade to a real Leaflet tile layer.\n *\n * @example\n * // Zero-dependency SVG plot\n * <TrajectoryMap points={points} current={lastPoint} height={360} />\n *\n * @example\n * // Real tiles from your own server (requires `leaflet` installed)\n * <TrajectoryMap points={points} tileUrl=\"https://tiles.internal/{z}/{x}/{y}.png\" />\n */\nexport function TrajectoryMap({\n    points,\n    current,\n    height = 320,\n    padding = 24,\n    showGrid = true,\n    showScale = true,\n    strokeColor,\n    tileUrl,\n    tileAttribution,\n    label = \"Trajetória\",\n    markers,\n    onMarkerClick,\n    className,\n    style,\n    ...rest\n}: TrajectoryMapProps) {\n    const containerRef = useRef<HTMLDivElement>(null);\n    const [width, setWidth] = useState<number>(600);\n\n    useEffect(() => {\n        const node = containerRef.current;\n        if (!node || typeof ResizeObserver === \"undefined\") return;\n        const observer = new ResizeObserver((entries) => {\n            const measured = entries[0]?.contentRect.width;\n            if (measured && measured > 0) setWidth(measured);\n        });\n        observer.observe(node);\n        return () => observer.disconnect();\n    }, []);\n\n    const allPoints = useMemo<Coordinate[]>(\n        () => [...points, ...(current ? [current] : []), ...(markers ?? [])],\n        [points, current, markers],\n    );\n\n    const svg = useMemo(() => {\n        const box = boundingBox(allPoints);\n        if (!box) return null;\n\n        const projection = fitProjection(expandBounds(box, 0.12), width, height, { padding });\n        const pixels: PixelPoint[] = points.map((p) => projection.project(p));\n        const polyline = pixels.map((p) => `${p.x.toFixed(1)},${p.y.toFixed(1)}`).join(\" \");\n\n        const startPixel = pixels[0] ?? null;\n        const endPixel = pixels.length > 0 ? pixels[pixels.length - 1] : null;\n        const currentPixel = current ? projection.project(current) : null;\n\n        // Distance-per-pixel at the map center, for the scale bar: measure the\n        // center → east-edge span in both km (haversine) and pixels (projected).\n        const centerCoord = {\n            latitude: (box.minLatitude + box.maxLatitude) / 2,\n            longitude: (box.minLongitude + box.maxLongitude) / 2,\n        };\n        const center = projection.project(centerCoord);\n        const eastRef = projection.project({ ...centerCoord, longitude: box.maxLongitude });\n        const edgeKm = haversineKm(centerCoord, { ...centerCoord, longitude: box.maxLongitude });\n        const edgePixels = Math.abs(eastRef.x - center.x) || 1;\n        const kmPerPixel = edgeKm / edgePixels || 0;\n\n        const markerPixels = (markers ?? []).map((m) => ({ marker: m, p: projection.project(m) }));\n\n        return { polyline, startPixel, endPixel, currentPixel, kmPerPixel, markerPixels };\n    }, [allPoints, points, current, markers, width, height, padding]);\n\n    // ── Leaflet tile mode ────────────────────────────────────────────────────\n    if (tileUrl) {\n        return (\n            <div\n                ref={containerRef}\n                className={cn(styles.map, className)}\n                style={{ height, ...style }}\n                role=\"img\"\n                aria-label={label}\n                {...rest}\n            >\n                <Suspense fallback={<div className={styles.loading}>Carregando mapa…</div>}>\n                    <LeafletTrajectory\n                        points={points}\n                        current={current}\n                        tileUrl={tileUrl}\n                        tileAttribution={tileAttribution}\n                        strokeColor={strokeColor}\n                    />\n                </Suspense>\n            </div>\n        );\n    }\n\n    // ── Tile-free SVG mode ─────────────────────────────────────────────────────\n    const scale =\n        showScale && svg && svg.kmPerPixel > 0\n            ? pickScaleKm(svg.kmPerPixel, Math.min(120, width * 0.35))\n            : null;\n\n    return (\n        <div\n            ref={containerRef}\n            className={cn(styles.map, className)}\n            style={{ height, ...style }}\n            role=\"img\"\n            aria-label={label}\n            {...rest}\n        >\n            {!svg ? (\n                <div className={styles.empty}>Sem pontos de trajetória ainda.</div>\n            ) : (\n                <svg\n                    className={styles.svg}\n                    width=\"100%\"\n                    height={height}\n                    viewBox={`0 0 ${width} ${height}`}\n                    preserveAspectRatio=\"xMidYMid meet\"\n                >\n                    {showGrid && (\n                        <g className={styles.grid}>\n                            {[0.25, 0.5, 0.75].map((f) => (\n                                <line\n                                    key={`h${f}`}\n                                    x1={0}\n                                    y1={height * f}\n                                    x2={width}\n                                    y2={height * f}\n                                />\n                            ))}\n                            {[0.25, 0.5, 0.75].map((f) => (\n                                <line\n                                    key={`v${f}`}\n                                    x1={width * f}\n                                    y1={0}\n                                    x2={width * f}\n                                    y2={height}\n                                />\n                            ))}\n                        </g>\n                    )}\n\n                    {svg.polyline && (\n                        <polyline\n                            className={styles.path}\n                            points={svg.polyline}\n                            fill=\"none\"\n                            stroke={strokeColor}\n                            data-testid=\"trajectory-path\"\n                        />\n                    )}\n\n                    {svg.startPixel && (\n                        <circle\n                            className={styles.start}\n                            cx={svg.startPixel.x}\n                            cy={svg.startPixel.y}\n                            r={5}\n                        />\n                    )}\n                    {svg.endPixel && !current && (\n                        <circle\n                            className={styles.end}\n                            cx={svg.endPixel.x}\n                            cy={svg.endPixel.y}\n                            r={5}\n                        />\n                    )}\n                    {svg.currentPixel && (\n                        <>\n                            <circle\n                                className={styles.pulse}\n                                cx={svg.currentPixel.x}\n                                cy={svg.currentPixel.y}\n                                r={10}\n                            />\n                            <circle\n                                className={styles.current}\n                                cx={svg.currentPixel.x}\n                                cy={svg.currentPixel.y}\n                                r={5}\n                            />\n                        </>\n                    )}\n\n                    {svg.markerPixels.map(({ marker, p }, i) => {\n                        const interactive = Boolean(onMarkerClick);\n                        return (\n                            <circle\n                                key={marker.id ?? i}\n                                className={styles.marker}\n                                cx={p.x}\n                                cy={p.y}\n                                r={marker.radius ?? 6}\n                                style={marker.color ? { fill: marker.color } : undefined}\n                                data-marker-id={marker.id ?? i}\n                                tabIndex={interactive ? 0 : undefined}\n                                role={interactive ? \"button\" : undefined}\n                                aria-label={marker.label}\n                                onClick={interactive ? () => onMarkerClick?.(marker, i) : undefined}\n                                onKeyDown={\n                                    interactive\n                                        ? (e) => {\n                                              if (e.key === \"Enter\" || e.key === \" \") {\n                                                  e.preventDefault();\n                                                  onMarkerClick?.(marker, i);\n                                              }\n                                          }\n                                        : undefined\n                                }\n                            >\n                                {marker.label ? <title>{marker.label}</title> : null}\n                            </circle>\n                        );\n                    })}\n\n                    {scale && (\n                        <g\n                            className={styles.scale}\n                            transform={`translate(${padding}, ${height - padding})`}\n                        >\n                            <line x1={0} y1={0} x2={scale.pixels} y2={0} />\n                            <line x1={0} y1={-4} x2={0} y2={4} />\n                            <line x1={scale.pixels} y1={-4} x2={scale.pixels} y2={4} />\n                            <text x={scale.pixels / 2} y={-8} textAnchor=\"middle\">\n                                {formatScale(scale.km)}\n                            </text>\n                        </g>\n                    )}\n                </svg>\n            )}\n        </div>\n    );\n}\n"],"mappings":"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"}

package/dist/geo/TrajectoryMap.js

@@ -0,0 +1,241 @@
+import { cn as e } from "../utils/cn.js";
+import { haversineKm as t } from "./distance.js";
+import { boundingBox as n, expandBounds as r } from "./bounds.js";
+import { fitProjection as i } from "./projection.js";
+import a from "./TrajectoryMap.module.js";
+import { Suspense as o, lazy as s, useEffect as c, useMemo as l, useRef as u, useState as d } from "react";
+import { Fragment as f, jsx as p, jsxs as m } from "react/jsx-runtime";
+//#region src/geo/TrajectoryMap.tsx
+var h = s(() => import("./leaflet-map.js").then((e) => ({ default: e.LeafletTrajectory }))), g = [
+	.05,
+	.1,
+	.25,
+	.5,
+	1,
+	2,
+	5,
+	10,
+	25,
+	50,
+	100,
+	250,
+	500,
+	1e3
+];
+function _(e, t) {
+	let n = e * t, r = g[0];
+	for (let e of g) e <= n && (r = e);
+	return {
+		km: r,
+		pixels: r / e
+	};
+}
+function v(e) {
+	return e < 1 ? `${Math.round(e * 1e3)} m` : `${e % 1 == 0 ? e : e.toFixed(1)} km`;
+}
+function y({ points: s, current: g, height: y = 320, padding: b = 24, showGrid: x = !0, showScale: S = !0, strokeColor: C, tileUrl: w, tileAttribution: T, label: E = "Trajetória", markers: D, onMarkerClick: O, className: k, style: A, ...j }) {
+	let M = u(null), [N, P] = d(600);
+	c(() => {
+		let e = M.current;
+		if (!e || typeof ResizeObserver > "u") return;
+		let t = new ResizeObserver((e) => {
+			let t = e[0]?.contentRect.width;
+			t && t > 0 && P(t);
+		});
+		return t.observe(e), () => t.disconnect();
+	}, []);
+	let F = l(() => [
+		...s,
+		...g ? [g] : [],
+		...D ?? []
+	], [
+		s,
+		g,
+		D
+	]), I = l(() => {
+		let e = n(F);
+		if (!e) return null;
+		let a = i(r(e, .12), N, y, { padding: b }), o = s.map((e) => a.project(e)), c = o.map((e) => `${e.x.toFixed(1)},${e.y.toFixed(1)}`).join(" "), l = o[0] ?? null, u = o.length > 0 ? o[o.length - 1] : null, d = g ? a.project(g) : null, f = {
+			latitude: (e.minLatitude + e.maxLatitude) / 2,
+			longitude: (e.minLongitude + e.maxLongitude) / 2
+		}, p = a.project(f), m = a.project({
+			...f,
+			longitude: e.maxLongitude
+		});
+		return {
+			polyline: c,
+			startPixel: l,
+			endPixel: u,
+			currentPixel: d,
+			kmPerPixel: t(f, {
+				...f,
+				longitude: e.maxLongitude
+			}) / (Math.abs(m.x - p.x) || 1) || 0,
+			markerPixels: (D ?? []).map((e) => ({
+				marker: e,
+				p: a.project(e)
+			}))
+		};
+	}, [
+		F,
+		s,
+		g,
+		D,
+		N,
+		y,
+		b
+	]);
+	if (w) return /* @__PURE__ */ p("div", {
+		ref: M,
+		className: e(a.map, k),
+		style: {
+			height: y,
+			...A
+		},
+		role: "img",
+		"aria-label": E,
+		...j,
+		children: /* @__PURE__ */ p(o, {
+			fallback: /* @__PURE__ */ p("div", {
+				className: a.loading,
+				children: "Carregando mapa…"
+			}),
+			children: /* @__PURE__ */ p(h, {
+				points: s,
+				current: g,
+				tileUrl: w,
+				tileAttribution: T,
+				strokeColor: C
+			})
+		})
+	});
+	let L = S && I && I.kmPerPixel > 0 ? _(I.kmPerPixel, Math.min(120, N * .35)) : null;
+	return /* @__PURE__ */ p("div", {
+		ref: M,
+		className: e(a.map, k),
+		style: {
+			height: y,
+			...A
+		},
+		role: "img",
+		"aria-label": E,
+		...j,
+		children: I ? /* @__PURE__ */ m("svg", {
+			className: a.svg,
+			width: "100%",
+			height: y,
+			viewBox: `0 0 ${N} ${y}`,
+			preserveAspectRatio: "xMidYMid meet",
+			children: [
+				x && /* @__PURE__ */ m("g", {
+					className: a.grid,
+					children: [[
+						.25,
+						.5,
+						.75
+					].map((e) => /* @__PURE__ */ p("line", {
+						x1: 0,
+						y1: y * e,
+						x2: N,
+						y2: y * e
+					}, `h${e}`)), [
+						.25,
+						.5,
+						.75
+					].map((e) => /* @__PURE__ */ p("line", {
+						x1: N * e,
+						y1: 0,
+						x2: N * e,
+						y2: y
+					}, `v${e}`))]
+				}),
+				I.polyline && /* @__PURE__ */ p("polyline", {
+					className: a.path,
+					points: I.polyline,
+					fill: "none",
+					stroke: C,
+					"data-testid": "trajectory-path"
+				}),
+				I.startPixel && /* @__PURE__ */ p("circle", {
+					className: a.start,
+					cx: I.startPixel.x,
+					cy: I.startPixel.y,
+					r: 5
+				}),
+				I.endPixel && !g && /* @__PURE__ */ p("circle", {
+					className: a.end,
+					cx: I.endPixel.x,
+					cy: I.endPixel.y,
+					r: 5
+				}),
+				I.currentPixel && /* @__PURE__ */ m(f, { children: [/* @__PURE__ */ p("circle", {
+					className: a.pulse,
+					cx: I.currentPixel.x,
+					cy: I.currentPixel.y,
+					r: 10
+				}), /* @__PURE__ */ p("circle", {
+					className: a.current,
+					cx: I.currentPixel.x,
+					cy: I.currentPixel.y,
+					r: 5
+				})] }),
+				I.markerPixels.map(({ marker: e, p: t }, n) => {
+					let r = !!O;
+					return /* @__PURE__ */ p("circle", {
+						className: a.marker,
+						cx: t.x,
+						cy: t.y,
+						r: e.radius ?? 6,
+						style: e.color ? { fill: e.color } : void 0,
+						"data-marker-id": e.id ?? n,
+						tabIndex: r ? 0 : void 0,
+						role: r ? "button" : void 0,
+						"aria-label": e.label,
+						onClick: r ? () => O?.(e, n) : void 0,
+						onKeyDown: r ? (t) => {
+							(t.key === "Enter" || t.key === " ") && (t.preventDefault(), O?.(e, n));
+						} : void 0,
+						children: e.label ? /* @__PURE__ */ p("title", { children: e.label }) : null
+					}, e.id ?? n);
+				}),
+				L && /* @__PURE__ */ m("g", {
+					className: a.scale,
+					transform: `translate(${b}, ${y - b})`,
+					children: [
+						/* @__PURE__ */ p("line", {
+							x1: 0,
+							y1: 0,
+							x2: L.pixels,
+							y2: 0
+						}),
+						/* @__PURE__ */ p("line", {
+							x1: 0,
+							y1: -4,
+							x2: 0,
+							y2: 4
+						}),
+						/* @__PURE__ */ p("line", {
+							x1: L.pixels,
+							y1: -4,
+							x2: L.pixels,
+							y2: 4
+						}),
+						/* @__PURE__ */ p("text", {
+							x: L.pixels / 2,
+							y: -8,
+							textAnchor: "middle",
+							children: v(L.km)
+						})
+					]
+				})
+			]
+		}) : /* @__PURE__ */ p("div", {
+			className: a.empty,
+			children: "Sem pontos de trajetória ainda."
+		})
+	});
+}
+//#endregion
+export { y as TrajectoryMap };
+
+//# sourceMappingURL=TrajectoryMap.js.map

package/dist/geo/TrajectoryMap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TrajectoryMap.js","names":[],"sources":["../../src/geo/TrajectoryMap.tsx"],"sourcesContent":["import { lazy, Suspense, useEffect, useMemo, useRef, useState, type HTMLAttributes } from \"react\";\nimport { cn } from \"@/utils/cn\";\nimport { boundingBox, expandBounds } from \"./bounds\";\nimport { haversineKm } from \"./distance\";\nimport { fitProjection, type PixelPoint } from \"./projection\";\nimport type { Coordinate, GeoMarker } from \"./types\";\nimport styles from \"./TrajectoryMap.module.css\";\n\n// Leaflet layer is loaded on demand — only when a `tileUrl` is supplied, so\n// apps that stick to the tile-free SVG never pull leaflet into their bundle.\nconst LeafletTrajectory = lazy(() =>\n    import(\"./leaflet-map\").then((m) => ({ default: m.LeafletTrajectory })),\n);\n\nexport interface TrajectoryMapProps extends Omit<HTMLAttributes<HTMLDivElement>, \"children\"> {\n    /** Ordered coordinates forming the trajectory. */\n    points: readonly Coordinate[];\n    /** Optional \"current position\" marker, drawn on top of the path. */\n    current?: Coordinate | null;\n    /** Viewport height in pixels. Default: `320`. */\n    height?: number;\n    /** Inner padding in pixels kept clear on every edge. Default: `24`. */\n    padding?: number;\n    /** Draw a light reference grid behind the path (SVG mode). Default: `true`. */\n    showGrid?: boolean;\n    /** Draw a distance scale bar (SVG mode). Default: `true`. */\n    showScale?: boolean;\n    /** Path stroke color. Default: the primary token. */\n    strokeColor?: string;\n    /**\n     * Tile URL template (`{z}/{x}/{y}`) of a map server **you host**. When set,\n     * the map upgrades to a real Leaflet tile layer (requires `leaflet` to be\n     * installed). Omit for the zero-dependency, zero-network SVG plot.\n     */\n    tileUrl?: string;\n    /** Attribution text shown over the tile layer. */\n    tileAttribution?: string;\n    /** Accessible label for the map region. Default: `\"Trajetória\"`. */\n    label?: string;\n    /** Point markers to overlay (e.g. stops, POIs). Included in the auto-fit. */\n    markers?: readonly GeoMarker[];\n    /** Fired when a marker is clicked. */\n    onMarkerClick?: (marker: GeoMarker, index: number) => void;\n}\n\nconst NICE_KM_STEPS = [0.05, 0.1, 0.25, 0.5, 1, 2, 5, 10, 25, 50, 100, 250, 500, 1000] as const;\n\n/** Pick the largest \"nice\" distance whose bar fits within `maxPixels`. */\nfunction pickScaleKm(kmPerPixel: number, maxPixels: number): { km: number; pixels: number } {\n    const maxKm = kmPerPixel * maxPixels;\n    let chosen: number = NICE_KM_STEPS[0];\n    for (const step of NICE_KM_STEPS) {\n        if (step <= maxKm) chosen = step;\n    }\n    return { km: chosen, pixels: chosen / kmPerPixel };\n}\n\n/** Format a distance in km for the scale bar (meters below 1 km). */\nfunction formatScale(km: number): string {\n    return km < 1 ? `${Math.round(km * 1000)} m` : `${km % 1 === 0 ? km : km.toFixed(1)} km`;\n}\n\n/**\n * Plot a GPS trajectory. By default it renders a **tile-free SVG** map (Web\n * Mercator projection, auto-fit to the points, optional grid + scale bar) —\n * 100% self-contained, no external tiles or paid API. Pass `tileUrl` pointing\n * at a map server **you host** to upgrade to a real Leaflet tile layer.\n *\n * @example\n * // Zero-dependency SVG plot\n * <TrajectoryMap points={points} current={lastPoint} height={360} />\n *\n * @example\n * // Real tiles from your own server (requires `leaflet` installed)\n * <TrajectoryMap points={points} tileUrl=\"https://tiles.internal/{z}/{x}/{y}.png\" />\n */\nexport function TrajectoryMap({\n    points,\n    current,\n    height = 320,\n    padding = 24,\n    showGrid = true,\n    showScale = true,\n    strokeColor,\n    tileUrl,\n    tileAttribution,\n    label = \"Trajetória\",\n    markers,\n    onMarkerClick,\n    className,\n    style,\n    ...rest\n}: TrajectoryMapProps) {\n    const containerRef = useRef<HTMLDivElement>(null);\n    const [width, setWidth] = useState<number>(600);\n\n    useEffect(() => {\n        const node = containerRef.current;\n        if (!node || typeof ResizeObserver === \"undefined\") return;\n        const observer = new ResizeObserver((entries) => {\n            const measured = entries[0]?.contentRect.width;\n            if (measured && measured > 0) setWidth(measured);\n        });\n        observer.observe(node);\n        return () => observer.disconnect();\n    }, []);\n\n    const allPoints = useMemo<Coordinate[]>(\n        () => [...points, ...(current ? [current] : []), ...(markers ?? [])],\n        [points, current, markers],\n    );\n\n    const svg = useMemo(() => {\n        const box = boundingBox(allPoints);\n        if (!box) return null;\n\n        const projection = fitProjection(expandBounds(box, 0.12), width, height, { padding });\n        const pixels: PixelPoint[] = points.map((p) => projection.project(p));\n        const polyline = pixels.map((p) => `${p.x.toFixed(1)},${p.y.toFixed(1)}`).join(\" \");\n\n        const startPixel = pixels[0] ?? null;\n        const endPixel = pixels.length > 0 ? pixels[pixels.length - 1] : null;\n        const currentPixel = current ? projection.project(current) : null;\n\n        // Distance-per-pixel at the map center, for the scale bar: measure the\n        // center → east-edge span in both km (haversine) and pixels (projected).\n        const centerCoord = {\n            latitude: (box.minLatitude + box.maxLatitude) / 2,\n            longitude: (box.minLongitude + box.maxLongitude) / 2,\n        };\n        const center = projection.project(centerCoord);\n        const eastRef = projection.project({ ...centerCoord, longitude: box.maxLongitude });\n        const edgeKm = haversineKm(centerCoord, { ...centerCoord, longitude: box.maxLongitude });\n        const edgePixels = Math.abs(eastRef.x - center.x) || 1;\n        const kmPerPixel = edgeKm / edgePixels || 0;\n\n        const markerPixels = (markers ?? []).map((m) => ({ marker: m, p: projection.project(m) }));\n\n        return { polyline, startPixel, endPixel, currentPixel, kmPerPixel, markerPixels };\n    }, [allPoints, points, current, markers, width, height, padding]);\n\n    // ── Leaflet tile mode ────────────────────────────────────────────────────\n    if (tileUrl) {\n        return (\n            <div\n                ref={containerRef}\n                className={cn(styles.map, className)}\n                style={{ height, ...style }}\n                role=\"img\"\n                aria-label={label}\n                {...rest}\n            >\n                <Suspense fallback={<div className={styles.loading}>Carregando mapa…</div>}>\n                    <LeafletTrajectory\n                        points={points}\n                        current={current}\n                        tileUrl={tileUrl}\n                        tileAttribution={tileAttribution}\n                        strokeColor={strokeColor}\n                    />\n                </Suspense>\n            </div>\n        );\n    }\n\n    // ── Tile-free SVG mode ─────────────────────────────────────────────────────\n    const scale =\n        showScale && svg && svg.kmPerPixel > 0\n            ? pickScaleKm(svg.kmPerPixel, Math.min(120, width * 0.35))\n            : null;\n\n    return (\n        <div\n            ref={containerRef}\n            className={cn(styles.map, className)}\n            style={{ height, ...style }}\n            role=\"img\"\n            aria-label={label}\n            {...rest}\n        >\n            {!svg ? (\n                <div className={styles.empty}>Sem pontos de trajetória ainda.</div>\n            ) : (\n                <svg\n                    className={styles.svg}\n                    width=\"100%\"\n                    height={height}\n                    viewBox={`0 0 ${width} ${height}`}\n                    preserveAspectRatio=\"xMidYMid meet\"\n                >\n                    {showGrid && (\n                        <g className={styles.grid}>\n                            {[0.25, 0.5, 0.75].map((f) => (\n                                <line\n                                    key={`h${f}`}\n                                    x1={0}\n                                    y1={height * f}\n                                    x2={width}\n                                    y2={height * f}\n                                />\n                            ))}\n                            {[0.25, 0.5, 0.75].map((f) => (\n                                <line\n                                    key={`v${f}`}\n                                    x1={width * f}\n                                    y1={0}\n                                    x2={width * f}\n                                    y2={height}\n                                />\n                            ))}\n                        </g>\n                    )}\n\n                    {svg.polyline && (\n                        <polyline\n                            className={styles.path}\n                            points={svg.polyline}\n                            fill=\"none\"\n                            stroke={strokeColor}\n                            data-testid=\"trajectory-path\"\n                        />\n                    )}\n\n                    {svg.startPixel && (\n                        <circle\n                            className={styles.start}\n                            cx={svg.startPixel.x}\n                            cy={svg.startPixel.y}\n                            r={5}\n                        />\n                    )}\n                    {svg.endPixel && !current && (\n                        <circle\n                            className={styles.end}\n                            cx={svg.endPixel.x}\n                            cy={svg.endPixel.y}\n                            r={5}\n                        />\n                    )}\n                    {svg.currentPixel && (\n                        <>\n                            <circle\n                                className={styles.pulse}\n                                cx={svg.currentPixel.x}\n                                cy={svg.currentPixel.y}\n                                r={10}\n                            />\n                            <circle\n                                className={styles.current}\n                                cx={svg.currentPixel.x}\n                                cy={svg.currentPixel.y}\n                                r={5}\n                            />\n                        </>\n                    )}\n\n                    {svg.markerPixels.map(({ marker, p }, i) => {\n                        const interactive = Boolean(onMarkerClick);\n                        return (\n                            <circle\n                                key={marker.id ?? i}\n                                className={styles.marker}\n                                cx={p.x}\n                                cy={p.y}\n                                r={marker.radius ?? 6}\n                                style={marker.color ? { fill: marker.color } : undefined}\n                                data-marker-id={marker.id ?? i}\n                                tabIndex={interactive ? 0 : undefined}\n                                role={interactive ? \"button\" : undefined}\n                                aria-label={marker.label}\n                                onClick={interactive ? () => onMarkerClick?.(marker, i) : undefined}\n                                onKeyDown={\n                                    interactive\n                                        ? (e) => {\n                                              if (e.key === \"Enter\" || e.key === \" \") {\n                                                  e.preventDefault();\n                                                  onMarkerClick?.(marker, i);\n                                              }\n                                          }\n                                        : undefined\n                                }\n                            >\n                                {marker.label ? <title>{marker.label}</title> : null}\n                            </circle>\n                        );\n                    })}\n\n                    {scale && (\n                        <g\n                            className={styles.scale}\n                            transform={`translate(${padding}, ${height - padding})`}\n                        >\n                            <line x1={0} y1={0} x2={scale.pixels} y2={0} />\n                            <line x1={0} y1={-4} x2={0} y2={4} />\n                            <line x1={scale.pixels} y1={-4} x2={scale.pixels} y2={4} />\n                            <text x={scale.pixels / 2} y={-8} textAnchor=\"middle\">\n                                {formatScale(scale.km)}\n                            </text>\n                        </g>\n                    )}\n                </svg>\n            )}\n        </div>\n    );\n}\n"],"mappings":"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"}

package/dist/geo/TrajectoryMap.module.cjs

@@ -0,0 +1,2 @@
+var e=`tempest_map_3qgBX`,t=`tempest_svg_Da-XM`,n=`tempest_empty_QQGkP`,r=`tempest_loading_R6YCf`,i=`tempest_grid_xFsTS`,a=`tempest_path_-A7Sl`,o=`tempest_start_OPmUL`,s=`tempest_end_7SX7p`,c=`tempest_current_WFLJk`,l=`tempest_pulse_DUzgL`,u=`tempest_tempest-geo-pulse_9O0Rj`,d=`tempest_marker_HB3Rb`,f=`tempest_scale_YuwqB`,p={map:e,svg:t,empty:n,loading:r,grid:i,path:a,start:o,end:s,current:c,pulse:l,tempestGeoPulse:u,marker:d,scale:f};exports.current=c,exports.default=p,exports.empty=n,exports.end=s,exports.grid=i,exports.loading=r,exports.map=e,exports.marker=d,exports.path=a,exports.pulse=l,exports.scale=f,exports.start=o,exports.svg=t,exports.tempestGeoPulse=u;
+//# sourceMappingURL=TrajectoryMap.module.cjs.map

package/dist/geo/TrajectoryMap.module.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"TrajectoryMap.module.cjs","names":[],"sources":["../../src/geo/TrajectoryMap.module.css"],"sourcesContent":[".map {\n    position: relative;\n    width: 100%;\n    overflow: hidden;\n    background: var(--tempest-surface-2);\n    border: 1px solid var(--tempest-border);\n    border-radius: var(--tempest-radius-lg);\n    font-family: var(--tempest-font-sans);\n}\n\n.svg {\n    display: block;\n    width: 100%;\n}\n\n.empty,\n.loading {\n    display: flex;\n    align-items: center;\n    justify-content: center;\n    height: 100%;\n    color: var(--tempest-text-muted);\n    font-size: var(--tempest-text-sm);\n}\n\n.grid line {\n    stroke: var(--tempest-border);\n    stroke-width: 1;\n    stroke-dasharray: 3 5;\n    opacity: 0.5;\n}\n\n.path {\n    stroke: var(--tempest-primary);\n    stroke-width: 3;\n    stroke-linecap: round;\n    stroke-linejoin: round;\n}\n\n.start {\n    fill: var(--tempest-success-solid);\n    stroke: var(--tempest-surface);\n    stroke-width: 2;\n}\n\n.end {\n    fill: var(--tempest-primary);\n    stroke: var(--tempest-surface);\n    stroke-width: 2;\n}\n\n.current {\n    fill: var(--tempest-primary);\n    stroke: var(--tempest-surface);\n    stroke-width: 2;\n}\n\n.pulse {\n    fill: var(--tempest-primary);\n    opacity: 0.25;\n    transform-origin: center;\n    transform-box: fill-box;\n    animation: tempest-geo-pulse 1.8s ease-out infinite;\n}\n\n@media (prefers-reduced-motion: reduce) {\n    .pulse {\n        animation: none;\n    }\n}\n\n@keyframes tempest-geo-pulse {\n    0% {\n        transform: scale(0.6);\n        opacity: 0.35;\n    }\n    100% {\n        transform: scale(1.6);\n        opacity: 0;\n    }\n}\n\n.marker {\n    fill: var(--tempest-primary);\n    stroke: var(--tempest-surface);\n    stroke-width: 2;\n}\n\n.marker[role=\"button\"] {\n    cursor: pointer;\n}\n\n.marker[role=\"button\"]:focus-visible {\n    outline: none;\n    stroke: var(--tempest-primary-active);\n    stroke-width: 3;\n}\n\n.scale line {\n    stroke: var(--tempest-text);\n    stroke-width: 2;\n}\n\n.scale text {\n    fill: var(--tempest-text);\n    font-size: var(--tempest-text-xs);\n    font-family: var(--tempest-font-sans);\n}\n"],"mappings":""}

package/dist/geo/TrajectoryMap.module.js

@@ -0,0 +1,20 @@
+//#region src/geo/TrajectoryMap.module.css
+var e = "tempest_map_3qgBX", t = "tempest_svg_Da-XM", n = "tempest_empty_QQGkP", r = "tempest_loading_R6YCf", i = "tempest_grid_xFsTS", a = "tempest_path_-A7Sl", o = "tempest_start_OPmUL", s = "tempest_end_7SX7p", c = "tempest_current_WFLJk", l = "tempest_pulse_DUzgL", u = "tempest_tempest-geo-pulse_9O0Rj", d = "tempest_marker_HB3Rb", f = "tempest_scale_YuwqB", p = {
+	map: e,
+	svg: t,
+	empty: n,
+	loading: r,
+	grid: i,
+	path: a,
+	start: o,
+	end: s,
+	current: c,
+	pulse: l,
+	tempestGeoPulse: u,
+	marker: d,
+	scale: f
+};
+//#endregion
+export { c as current, p as default, n as empty, s as end, i as grid, r as loading, e as map, d as marker, a as path, l as pulse, f as scale, o as start, t as svg, u as tempestGeoPulse };
+
+//# sourceMappingURL=TrajectoryMap.module.js.map

package/dist/geo/TrajectoryMap.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TrajectoryMap.module.js","names":[],"sources":["../../src/geo/TrajectoryMap.module.css"],"sourcesContent":[".map {\n    position: relative;\n    width: 100%;\n    overflow: hidden;\n    background: var(--tempest-surface-2);\n    border: 1px solid var(--tempest-border);\n    border-radius: var(--tempest-radius-lg);\n    font-family: var(--tempest-font-sans);\n}\n\n.svg {\n    display: block;\n    width: 100%;\n}\n\n.empty,\n.loading {\n    display: flex;\n    align-items: center;\n    justify-content: center;\n    height: 100%;\n    color: var(--tempest-text-muted);\n    font-size: var(--tempest-text-sm);\n}\n\n.grid line {\n    stroke: var(--tempest-border);\n    stroke-width: 1;\n    stroke-dasharray: 3 5;\n    opacity: 0.5;\n}\n\n.path {\n    stroke: var(--tempest-primary);\n    stroke-width: 3;\n    stroke-linecap: round;\n    stroke-linejoin: round;\n}\n\n.start {\n    fill: var(--tempest-success-solid);\n    stroke: var(--tempest-surface);\n    stroke-width: 2;\n}\n\n.end {\n    fill: var(--tempest-primary);\n    stroke: var(--tempest-surface);\n    stroke-width: 2;\n}\n\n.current {\n    fill: var(--tempest-primary);\n    stroke: var(--tempest-surface);\n    stroke-width: 2;\n}\n\n.pulse {\n    fill: var(--tempest-primary);\n    opacity: 0.25;\n    transform-origin: center;\n    transform-box: fill-box;\n    animation: tempest-geo-pulse 1.8s ease-out infinite;\n}\n\n@media (prefers-reduced-motion: reduce) {\n    .pulse {\n        animation: none;\n    }\n}\n\n@keyframes tempest-geo-pulse {\n    0% {\n        transform: scale(0.6);\n        opacity: 0.35;\n    }\n    100% {\n        transform: scale(1.6);\n        opacity: 0;\n    }\n}\n\n.marker {\n    fill: var(--tempest-primary);\n    stroke: var(--tempest-surface);\n    stroke-width: 2;\n}\n\n.marker[role=\"button\"] {\n    cursor: pointer;\n}\n\n.marker[role=\"button\"]:focus-visible {\n    outline: none;\n    stroke: var(--tempest-primary-active);\n    stroke-width: 3;\n}\n\n.scale line {\n    stroke: var(--tempest-text);\n    stroke-width: 2;\n}\n\n.scale text {\n    fill: var(--tempest-text);\n    font-size: var(--tempest-text-xs);\n    font-family: var(--tempest-font-sans);\n}\n"],"mappings":""}

package/dist/geo/bounds.cjs

@@ -0,0 +1,2 @@
+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 t(e){return{latitude:(e.minLatitude+e.maxLatitude)/2,longitude:(e.minLongitude+e.maxLongitude)/2}}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}}exports.boundingBox=e,exports.boundsCenter=t,exports.expandBounds=n;
+//# sourceMappingURL=bounds.cjs.map

package/dist/geo/bounds.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounds.cjs","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,EAAiD,CACzE,GAAI,EAAO,SAAW,EAAG,OAAO,KAEhC,IAAI,EAAc,EAAO,EAAE,CAAC,SACxB,EAAc,EAAO,EAAE,CAAC,SACxB,EAAe,EAAO,EAAE,CAAC,UACzB,EAAe,EAAO,EAAE,CAAC,UAE7B,IAAK,IAAM,KAAS,EACZ,EAAM,SAAW,IAAa,EAAc,EAAM,UAClD,EAAM,SAAW,IAAa,EAAc,EAAM,UAClD,EAAM,UAAY,IAAc,EAAe,EAAM,WACrD,EAAM,UAAY,IAAc,EAAe,EAAM,WAG7D,MAAO,CAAE,cAAa,cAAa,eAAc,cAAa,CAClE,CAGA,SAAgB,EAAa,EAA+B,CACxD,MAAO,CACH,UAAW,EAAO,YAAc,EAAO,aAAe,EACtD,WAAY,EAAO,aAAe,EAAO,cAAgB,CAC7D,CACJ,CAYA,SAAgB,EAAa,EAAmB,EAAQ,GAAgB,CACpE,IAAM,EAAU,EAAO,YAAc,EAAO,YACtC,EAAU,EAAO,aAAe,EAAO,aACvC,EAAS,EAAU,GAAS,KAC5B,EAAS,EAAU,GAAS,KAElC,MAAO,CACH,YAAa,EAAO,YAAc,EAClC,YAAa,EAAO,YAAc,EAClC,aAAc,EAAO,aAAe,EACpC,aAAc,EAAO,aAAe,CACxC,CACJ"}

package/dist/geo/bounds.js

@@ -0,0 +1,31 @@
+//#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 t(e) {
+	return {
+		latitude: (e.minLatitude + e.maxLatitude) / 2,
+		longitude: (e.minLongitude + e.maxLongitude) / 2
+	};
+}
+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
+	};
+}
+//#endregion
+export { e as boundingBox, t as boundsCenter, n as expandBounds };
+
+//# sourceMappingURL=bounds.js.map

package/dist/geo/bounds.js.map

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,2 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,58 @@
+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;
+		}
+	};
+}
+//#endregion
+export { t as createPositionTracker };
+
+//# sourceMappingURL=create-position-tracker.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,2 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,22 @@
+//#region src/geo/distance.ts
+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;
+}
+//#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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,2 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,26 @@
+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 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(n, r) * s;
+	return {
+		mode: a,
+		distance_km: u,
+		duration_minutes: u / c * 60 * i(a, l),
+		source: "heuristic"
+	};
+}
+//#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

@@ -0,0 +1 @@
+{"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"}