tempest-react-sdk 0.23.0 → 0.24.0

package/dist/geo/leaflet-map.js

@@ -1,51 +1,63 @@
-import { jsx as p } from "react/jsx-runtime";
-import { useRef as L, useState as x, useEffect as b } from "react";
-import { boundingBox as v } from "./bounds.js";
-function j({
-  points: t,
-  current: o,
-  tileUrl: f,
-  tileAttribution: c,
-  strokeColor: i
-}) {
-  const l = L(null), [s, h] = x(null);
-  return b(() => {
-    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(f, {
-        attribution: c ?? "",
-        maxZoom: 19
-      }).addTo(e);
-      const d = t.map((g) => [g.latitude, g.longitude]);
-      d.length > 0 && (r.polyline(d, {
-        color: i ?? "#2563eb",
-        weight: 4
-      }).addTo(e), r.circleMarker(d[0], { radius: 6, color: "#16a34a" }).addTo(e));
-      const u = o ?? t[t.length - 1];
-      u && r.circleMarker([u.latitude, u.longitude], {
-        radius: 6,
-        color: i ?? "#2563eb"
-      }).addTo(e);
-      const a = v(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 || h(
-        "Leaflet não encontrado. Instale `leaflet` para usar tiles, ou remova `tileUrl` para o plot SVG."
-      );
-    }), () => {
-      n = !0, e?.remove();
-    };
-  }, [t, o, f, c, i]), s ? /* @__PURE__ */ p("div", { style: { padding: 16, fontSize: 13, color: "var(--tempest-danger-fg)" }, children: s }) : /* @__PURE__ */ p("div", { ref: l, style: { width: "100%", height: "100%" } });
+import { boundingBox as e } from "./bounds.js";
+import { useEffect as t, useRef as n, useState as r } from "react";
+import { jsx as i } from "react/jsx-runtime";
+//#region src/geo/leaflet-map.tsx
+function a({ points: a, current: o, tileUrl: s, tileAttribution: c, strokeColor: l }) {
+	let u = n(null), [d, f] = r(null);
+	return t(() => {
+		let t = null, n = !1;
+		return import(
+			/* @vite-ignore */
+			"leaflet"
+).then((r) => {
+			if (n || !u.current) return;
+			let i = r.default ?? r;
+			t = i.map(u.current, { attributionControl: !0 }), i.tileLayer(s, {
+				attribution: c ?? "",
+				maxZoom: 19
+			}).addTo(t);
+			let d = a.map((e) => [e.latitude, e.longitude]);
+			d.length > 0 && (i.polyline(d, {
+				color: l ?? "#2563eb",
+				weight: 4
+			}).addTo(t), i.circleMarker(d[0], {
+				radius: 6,
+				color: "#16a34a"
+			}).addTo(t));
+			let f = o ?? a[a.length - 1];
+			f && i.circleMarker([f.latitude, f.longitude], {
+				radius: 6,
+				color: l ?? "#2563eb"
+			}).addTo(t);
+			let p = e(o ? [...a, o] : [...a]);
+			p ? t.fitBounds([[p.minLatitude, p.minLongitude], [p.maxLatitude, p.maxLongitude]], { padding: [24, 24] }) : t.setView([0, 0], 2);
+		}).catch(() => {
+			n || f("Leaflet não encontrado. Instale `leaflet` para usar tiles, ou remova `tileUrl` para o plot SVG.");
+		}), () => {
+			n = !0, t?.remove();
+		};
+	}, [
+		a,
+		o,
+		s,
+		c,
+		l
+	]), d ? /* @__PURE__ */ i("div", {
+		style: {
+			padding: 16,
+			fontSize: 13,
+			color: "var(--tempest-danger-fg)"
+		},
+		children: d
+	}) : /* @__PURE__ */ i("div", {
+		ref: u,
+		style: {
+			width: "100%",
+			height: "100%"
+		}
+	});
 }
-export {
-  j as LeafletTrajectory
-};
-//# sourceMappingURL=leaflet-map.js.map
+//#endregion
+export { a as LeafletTrajectory };
+
+//# sourceMappingURL=leaflet-map.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"leaflet-map.js","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":";;;AAsCO,SAASA,EAAkB;AAAA,EAC9B,QAAAC;AAAA,EACA,SAAAC;AAAA,EACA,SAAAC;AAAA,EACA,iBAAAC;AAAA,EACA,aAAAC;AACJ,GAA2B;AACvB,QAAMC,IAAUC,EAAuB,IAAI,GACrC,CAACC,GAAOC,CAAQ,IAAIC,EAAwB,IAAI;AA8DtD,SA5DAC,EAAU,MAAM;AACZ,QAAIC,IAAiC,MACjCC,IAAY;AAGhB,kBADkB,WAEb,KAAK,CAACC,MAAqD;AACxD,UAAID,KAAa,CAACP,EAAQ,QAAS;AACnC,YAAMS,IAAmBD,EAAI,WAAWA;AAExC,MAAAF,IAAMG,EAAE,IAAIT,EAAQ,SAAS,EAAE,oBAAoB,IAAM,GACzDS,EAAE,UAAUZ,GAAS;AAAA,QACjB,aAAaC,KAAmB;AAAA,QAChC,SAAS;AAAA,MAAA,CACZ,EAAE,MAAMQ,CAAG;AAEZ,YAAMI,IAAUf,EAAO,IAAI,CAACgB,MAAwB,CAACA,EAAE,UAAUA,EAAE,SAAS,CAAC;AAC7E,MAAID,EAAQ,SAAS,MACjBD,EAAE,SAASC,GAAS;AAAA,QAChB,OAAOX,KAAe;AAAA,QACtB,QAAQ;AAAA,MAAA,CACX,EAAE,MAAMO,CAAG,GACZG,EAAE,aAAaC,EAAQ,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,UAAA,CAAW,EAAE,MAAMJ,CAAG;AAGzE,YAAMM,IAAShB,KAAWD,EAAOA,EAAO,SAAS,CAAC;AAClD,MAAIiB,KACAH,EAAE,aAAa,CAACG,EAAO,UAAUA,EAAO,SAAS,GAAG;AAAA,QAChD,QAAQ;AAAA,QACR,OAAOb,KAAe;AAAA,MAAA,CACzB,EAAE,MAAMO,CAAG;AAGhB,YAAMO,IAAMC,EAAYlB,IAAU,CAAC,GAAGD,GAAQC,CAAO,IAAI,CAAC,GAAGD,CAAM,CAAC;AACpE,MAAIkB,IACAP,EAAI;AAAA,QACA;AAAA,UACI,CAACO,EAAI,aAAaA,EAAI,YAAY;AAAA,UAClC,CAACA,EAAI,aAAaA,EAAI,YAAY;AAAA,QAAA;AAAA,QAEtC,EAAE,SAAS,CAAC,IAAI,EAAE,EAAA;AAAA,MAAE,IAGxBP,EAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;AAAA,IAE7B,CAAC,EACA,MAAM,MAAM;AACT,MAAKC,KACDJ;AAAA,QACI;AAAA,MAAA;AAAA,IAGZ,CAAC,GAEE,MAAM;AACT,MAAAI,IAAY,IACZD,GAAK,OAAA;AAAA,IACT;AAAA,EACJ,GAAG,CAACX,GAAQC,GAASC,GAASC,GAAiBC,CAAW,CAAC,GAEvDG,IAEI,gBAAAa,EAAC,OAAA,EAAI,OAAO,EAAE,SAAS,IAAI,UAAU,IAAI,OAAO,2BAAA,GAC3C,UAAAb,EAAA,CACL,IAID,gBAAAa,EAAC,OAAA,EAAI,KAAKf,GAAS,OAAO,EAAE,OAAO,QAAQ,QAAQ,OAAA,EAAO,CAAG;AACxE;"}
+{"version":3,"file":"leaflet-map.js","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":";;;;AAsCA,SAAgB,EAAkB,EAC9B,WACA,YACA,YACA,oBACA,kBACuB;CACvB,IAAM,IAAU,EAAuB,IAAI,GACrC,CAAC,GAAO,KAAY,EAAwB,IAAI;CAsEtD,OApEA,QAAgB;EACZ,IAAI,IAAiC,MACjC,IAAY;EAoDhB,OAjDA;;GAA0B;CAAU,CAC/B,MAAM,MAAqD;GACxD,IAAI,KAAa,CAAC,EAAQ,SAAS;GACnC,IAAM,IAAmB,EAAI,WAAW;GAGxC,AADA,IAAM,EAAE,IAAI,EAAQ,SAAS,EAAE,oBAAoB,GAAK,CAAC,GACzD,EAAE,UAAU,GAAS;IACjB,aAAa,KAAmB;IAChC,SAAS;GACb,CAAC,CAAC,CAAC,MAAM,CAAG;GAEZ,IAAM,IAAU,EAAO,KAAK,MAAwB,CAAC,EAAE,UAAU,EAAE,SAAS,CAAC;GAC7E,AAAI,EAAQ,SAAS,MACjB,EAAE,SAAS,GAAS;IAChB,OAAO,KAAe;IACtB,QAAQ;GACZ,CAAC,CAAC,CAAC,MAAM,CAAG,GACZ,EAAE,aAAa,EAAQ,IAAI;IAAE,QAAQ;IAAG,OAAO;GAAU,CAAC,CAAC,CAAC,MAAM,CAAG;GAGzE,IAAM,IAAS,KAAW,EAAO,EAAO,SAAS;GACjD,AAAI,KACA,EAAE,aAAa,CAAC,EAAO,UAAU,EAAO,SAAS,GAAG;IAChD,QAAQ;IACR,OAAO,KAAe;GAC1B,CAAC,CAAC,CAAC,MAAM,CAAG;GAGhB,IAAM,IAAM,EAAY,IAAU,CAAC,GAAG,GAAQ,CAAO,IAAI,CAAC,GAAG,CAAM,CAAC;GACpE,AAAI,IACA,EAAI,UACA,CACI,CAAC,EAAI,aAAa,EAAI,YAAY,GAClC,CAAC,EAAI,aAAa,EAAI,YAAY,CACtC,GACA,EAAE,SAAS,CAAC,IAAI,EAAE,EAAE,CACxB,IAEA,EAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;EAE7B,CAAC,CAAC,CACD,YAAY;GACT,AAAK,KACD,EACI,iGACJ;EAER,CAAC,SAEQ;GAET,AADA,IAAY,IACZ,GAAK,OAAO;EAChB;CACJ,GAAG;EAAC;EAAQ;EAAS;EAAS;EAAiB;CAAW,CAAC,GAEvD,IAEI,kBAAC,OAAD;EAAK,OAAO;GAAE,SAAS;GAAI,UAAU;GAAI,OAAO;EAA2B;YACtE;CACA,CAAA,IAIN,kBAAC,OAAD;EAAK,KAAK;EAAS,OAAO;GAAE,OAAO;GAAQ,QAAQ;EAAO;CAAI,CAAA;AACzE"}

package/dist/geo/projection.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const g=require("./types.cjs"),s=85.05112878;function i(t){const n=Math.max(-s,Math.min(s,g.clampLatitude(t.latitude)))*Math.PI/180,c=(t.longitude+180)/360,e=(1-Math.log(Math.tan(n)+1/Math.cos(n))/Math.PI)/2;return{x:c,y:e}}function j(t){const o=t.x*360-180,n=Math.PI*(1-2*t.y);return{latitude:Math.atan(Math.sinh(n))*180/Math.PI,longitude:o}}function y(t,o,n,c={}){const{padding:e=16}=c,r=i({latitude:t.maxLatitude,longitude:t.minLongitude}),u=i({latitude:t.minLatitude,longitude:t.maxLongitude}),M=u.x-r.x||Number.EPSILON,l=u.y-r.y||Number.EPSILON,d=Math.max(1,o-e*2),h=Math.max(1,n-e*2),a=Math.min(d/M,h/l),p=e+(d-M*a)/2,x=e+(h-l*a)/2;return{project:f=>{const m=i(f);return{x:p+(m.x-r.x)*a,y:x+(m.y-r.y)*a}},scale:a,width:o,height:n}}exports.MERCATOR_MAX_LATITUDE=s;exports.fitProjection=y;exports.projectMercator=i;exports.unprojectMercator=j;
-//# sourceMappingURL=projection.cjs.map
+const e=require("./types.cjs");var t=85.05112878;function n(n){let r=Math.max(-85.05112878,Math.min(t,e.clampLatitude(n.latitude)))*Math.PI/180;return{x:(n.longitude+180)/360,y:(1-Math.log(Math.tan(r)+1/Math.cos(r))/Math.PI)/2}}function r(e){let t=e.x*360-180,n=Math.PI*(1-2*e.y);return{latitude:Math.atan(Math.sinh(n))*180/Math.PI,longitude:t}}function i(e,t,r,i={}){let{padding:a=16}=i,o=n({latitude:e.maxLatitude,longitude:e.minLongitude}),s=n({latitude:e.minLatitude,longitude:e.maxLongitude}),c=s.x-o.x||2**-52,l=s.y-o.y||2**-52,u=Math.max(1,t-a*2),d=Math.max(1,r-a*2),f=Math.min(u/c,d/l),p=a+(u-c*f)/2,m=a+(d-l*f)/2;return{project:e=>{let t=n(e);return{x:p+(t.x-o.x)*f,y:m+(t.y-o.y)*f}},scale:f,width:t,height:r}}exports.MERCATOR_MAX_LATITUDE=t,exports.fitProjection=i,exports.projectMercator=n,exports.unprojectMercator=r;
+//# sourceMappingURL=projection.cjs.map

package/dist/geo/projection.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"projection.cjs","sources":["../../src/geo/projection.ts"],"sourcesContent":["import { clampLatitude } from \"./types\";\nimport type { Coordinate, GeoBounds } from \"./types\";\n\n/**\n * A point projected onto the unit Web Mercator plane. Both axes are in `[0, 1]`\n * — `x` grows east, `y` grows south (screen convention).\n */\nexport interface MercatorPoint {\n    x: number;\n    y: number;\n}\n\n/** A pixel coordinate inside the plotting viewport. */\nexport interface PixelPoint {\n    x: number;\n    y: number;\n}\n\n/**\n * Web Mercator (EPSG:3857) latitude clamp. Latitudes beyond this diverge to\n * infinity in the projection, so tile maps cap here.\n */\nexport const MERCATOR_MAX_LATITUDE = 85.05112878;\n\n/**\n * Project a geographic coordinate onto the unit Web Mercator plane. This is the\n * same projection tile servers use, so a self-hosted tile layer and the\n * tile-free SVG plot line up pixel-for-pixel.\n *\n * @param coord - Coordinate to project.\n * @returns `{ x, y }` in `[0, 1]`.\n */\nexport function projectMercator(coord: Coordinate): MercatorPoint {\n    const lat = Math.max(\n        -MERCATOR_MAX_LATITUDE,\n        Math.min(MERCATOR_MAX_LATITUDE, clampLatitude(coord.latitude)),\n    );\n    const latRad = (lat * Math.PI) / 180;\n    const x = (coord.longitude + 180) / 360;\n    const y = (1 - Math.log(Math.tan(latRad) + 1 / Math.cos(latRad)) / Math.PI) / 2;\n    return { x, y };\n}\n\n/**\n * Inverse of {@link projectMercator}: recover a coordinate from a unit-plane\n * point.\n *\n * @param point - `{ x, y }` in `[0, 1]`.\n * @returns The geographic coordinate.\n */\nexport function unprojectMercator(point: MercatorPoint): Coordinate {\n    const longitude = point.x * 360 - 180;\n    const n = Math.PI * (1 - 2 * point.y);\n    const latitude = (Math.atan(Math.sinh(n)) * 180) / Math.PI;\n    return { latitude, longitude };\n}\n\n/** A ready-to-use mapping from coordinates to viewport pixels. */\nexport interface FittedProjection {\n    /** Project a coordinate to a pixel inside the viewport. */\n    project: (coord: Coordinate) => PixelPoint;\n    /** Uniform scale (unit-plane → pixels) actually used, after aspect fit. */\n    scale: number;\n    /** Viewport width in pixels. */\n    width: number;\n    /** Viewport height in pixels. */\n    height: number;\n}\n\n/** Options for {@link fitProjection}. */\nexport interface FitProjectionOptions {\n    /** Inner padding in pixels kept clear on every edge. Default: `16`. */\n    padding?: number;\n}\n\n/**\n * Build a projection that fits `bounds` into a `width × height` viewport while\n * preserving aspect ratio (uniform scale, centered). This is what powers the\n * tile-free trajectory plot: project the bounds, scale to the SVG box, keep\n * shapes undistorted.\n *\n * @param bounds - Geographic extent to fit.\n * @param width - Viewport width in pixels.\n * @param height - Viewport height in pixels.\n * @param options - Padding tuning.\n * @returns A {@link FittedProjection} with a `project(coord)` mapper.\n */\nexport function fitProjection(\n    bounds: GeoBounds,\n    width: number,\n    height: number,\n    options: FitProjectionOptions = {},\n): FittedProjection {\n    const { padding = 16 } = options;\n\n    const topLeft = projectMercator({\n        latitude: bounds.maxLatitude,\n        longitude: bounds.minLongitude,\n    });\n    const bottomRight = projectMercator({\n        latitude: bounds.minLatitude,\n        longitude: bounds.maxLongitude,\n    });\n\n    const spanX = bottomRight.x - topLeft.x || Number.EPSILON;\n    const spanY = bottomRight.y - topLeft.y || Number.EPSILON;\n\n    const innerWidth = Math.max(1, width - padding * 2);\n    const innerHeight = Math.max(1, height - padding * 2);\n\n    // Uniform scale keeps the trajectory undistorted; fit the tighter axis.\n    const scale = Math.min(innerWidth / spanX, innerHeight / spanY);\n\n    // Center the projected content within the padded box.\n    const offsetX = padding + (innerWidth - spanX * scale) / 2;\n    const offsetY = padding + (innerHeight - spanY * scale) / 2;\n\n    const project = (coord: Coordinate): PixelPoint => {\n        const projected = projectMercator(coord);\n        return {\n            x: offsetX + (projected.x - topLeft.x) * scale,\n            y: offsetY + (projected.y - topLeft.y) * scale,\n        };\n    };\n\n    return { project, scale, width, height };\n}\n"],"names":["MERCATOR_MAX_LATITUDE","projectMercator","coord","latRad","clampLatitude","x","y","unprojectMercator","point","longitude","fitProjection","bounds","width","height","options","padding","topLeft","bottomRight","spanX","spanY","innerWidth","innerHeight","scale","offsetX","offsetY","projected"],"mappings":"+GAsBaA,EAAwB,YAU9B,SAASC,EAAgBC,EAAkC,CAK9D,MAAMC,EAJM,KAAK,IACb,CAACH,EACD,KAAK,IAAIA,EAAuBI,EAAAA,cAAcF,EAAM,QAAQ,CAAC,CAAA,EAE3C,KAAK,GAAM,IAC3BG,GAAKH,EAAM,UAAY,KAAO,IAC9BI,GAAK,EAAI,KAAK,IAAI,KAAK,IAAIH,CAAM,EAAI,EAAI,KAAK,IAAIA,CAAM,CAAC,EAAI,KAAK,IAAM,EAC9E,MAAO,CAAE,EAAAE,EAAG,EAAAC,CAAA,CAChB,CASO,SAASC,EAAkBC,EAAkC,CAChE,MAAMC,EAAYD,EAAM,EAAI,IAAM,IAC5B,EAAI,KAAK,IAAM,EAAI,EAAIA,EAAM,GAEnC,MAAO,CAAE,SADS,KAAK,KAAK,KAAK,KAAK,CAAC,CAAC,EAAI,IAAO,KAAK,GACrC,UAAAC,CAAA,CACvB,CAgCO,SAASC,EACZC,EACAC,EACAC,EACAC,EAAgC,CAAA,EAChB,CAChB,KAAM,CAAE,QAAAC,EAAU,EAAA,EAAOD,EAEnBE,EAAUf,EAAgB,CAC5B,SAAUU,EAAO,YACjB,UAAWA,EAAO,YAAA,CACrB,EACKM,EAAchB,EAAgB,CAChC,SAAUU,EAAO,YACjB,UAAWA,EAAO,YAAA,CACrB,EAEKO,EAAQD,EAAY,EAAID,EAAQ,GAAK,OAAO,QAC5CG,EAAQF,EAAY,EAAID,EAAQ,GAAK,OAAO,QAE5CI,EAAa,KAAK,IAAI,EAAGR,EAAQG,EAAU,CAAC,EAC5CM,EAAc,KAAK,IAAI,EAAGR,EAASE,EAAU,CAAC,EAG9CO,EAAQ,KAAK,IAAIF,EAAaF,EAAOG,EAAcF,CAAK,EAGxDI,EAAUR,GAAWK,EAAaF,EAAQI,GAAS,EACnDE,EAAUT,GAAWM,EAAcF,EAAQG,GAAS,EAU1D,MAAO,CAAE,QARQpB,GAAkC,CAC/C,MAAMuB,EAAYxB,EAAgBC,CAAK,EACvC,MAAO,CACH,EAAGqB,GAAWE,EAAU,EAAIT,EAAQ,GAAKM,EACzC,EAAGE,GAAWC,EAAU,EAAIT,EAAQ,GAAKM,CAAA,CAEjD,EAEkB,MAAAA,EAAO,MAAAV,EAAO,OAAAC,CAAA,CACpC"}
+{"version":3,"file":"projection.cjs","names":[],"sources":["../../src/geo/projection.ts"],"sourcesContent":["import { clampLatitude } from \"./types\";\nimport type { Coordinate, GeoBounds } from \"./types\";\n\n/**\n * A point projected onto the unit Web Mercator plane. Both axes are in `[0, 1]`\n * — `x` grows east, `y` grows south (screen convention).\n */\nexport interface MercatorPoint {\n    x: number;\n    y: number;\n}\n\n/** A pixel coordinate inside the plotting viewport. */\nexport interface PixelPoint {\n    x: number;\n    y: number;\n}\n\n/**\n * Web Mercator (EPSG:3857) latitude clamp. Latitudes beyond this diverge to\n * infinity in the projection, so tile maps cap here.\n */\nexport const MERCATOR_MAX_LATITUDE = 85.05112878;\n\n/**\n * Project a geographic coordinate onto the unit Web Mercator plane. This is the\n * same projection tile servers use, so a self-hosted tile layer and the\n * tile-free SVG plot line up pixel-for-pixel.\n *\n * @param coord - Coordinate to project.\n * @returns `{ x, y }` in `[0, 1]`.\n */\nexport function projectMercator(coord: Coordinate): MercatorPoint {\n    const lat = Math.max(\n        -MERCATOR_MAX_LATITUDE,\n        Math.min(MERCATOR_MAX_LATITUDE, clampLatitude(coord.latitude)),\n    );\n    const latRad = (lat * Math.PI) / 180;\n    const x = (coord.longitude + 180) / 360;\n    const y = (1 - Math.log(Math.tan(latRad) + 1 / Math.cos(latRad)) / Math.PI) / 2;\n    return { x, y };\n}\n\n/**\n * Inverse of {@link projectMercator}: recover a coordinate from a unit-plane\n * point.\n *\n * @param point - `{ x, y }` in `[0, 1]`.\n * @returns The geographic coordinate.\n */\nexport function unprojectMercator(point: MercatorPoint): Coordinate {\n    const longitude = point.x * 360 - 180;\n    const n = Math.PI * (1 - 2 * point.y);\n    const latitude = (Math.atan(Math.sinh(n)) * 180) / Math.PI;\n    return { latitude, longitude };\n}\n\n/** A ready-to-use mapping from coordinates to viewport pixels. */\nexport interface FittedProjection {\n    /** Project a coordinate to a pixel inside the viewport. */\n    project: (coord: Coordinate) => PixelPoint;\n    /** Uniform scale (unit-plane → pixels) actually used, after aspect fit. */\n    scale: number;\n    /** Viewport width in pixels. */\n    width: number;\n    /** Viewport height in pixels. */\n    height: number;\n}\n\n/** Options for {@link fitProjection}. */\nexport interface FitProjectionOptions {\n    /** Inner padding in pixels kept clear on every edge. Default: `16`. */\n    padding?: number;\n}\n\n/**\n * Build a projection that fits `bounds` into a `width × height` viewport while\n * preserving aspect ratio (uniform scale, centered). This is what powers the\n * tile-free trajectory plot: project the bounds, scale to the SVG box, keep\n * shapes undistorted.\n *\n * @param bounds - Geographic extent to fit.\n * @param width - Viewport width in pixels.\n * @param height - Viewport height in pixels.\n * @param options - Padding tuning.\n * @returns A {@link FittedProjection} with a `project(coord)` mapper.\n */\nexport function fitProjection(\n    bounds: GeoBounds,\n    width: number,\n    height: number,\n    options: FitProjectionOptions = {},\n): FittedProjection {\n    const { padding = 16 } = options;\n\n    const topLeft = projectMercator({\n        latitude: bounds.maxLatitude,\n        longitude: bounds.minLongitude,\n    });\n    const bottomRight = projectMercator({\n        latitude: bounds.minLatitude,\n        longitude: bounds.maxLongitude,\n    });\n\n    const spanX = bottomRight.x - topLeft.x || Number.EPSILON;\n    const spanY = bottomRight.y - topLeft.y || Number.EPSILON;\n\n    const innerWidth = Math.max(1, width - padding * 2);\n    const innerHeight = Math.max(1, height - padding * 2);\n\n    // Uniform scale keeps the trajectory undistorted; fit the tighter axis.\n    const scale = Math.min(innerWidth / spanX, innerHeight / spanY);\n\n    // Center the projected content within the padded box.\n    const offsetX = padding + (innerWidth - spanX * scale) / 2;\n    const offsetY = padding + (innerHeight - spanY * scale) / 2;\n\n    const project = (coord: Coordinate): PixelPoint => {\n        const projected = projectMercator(coord);\n        return {\n            x: offsetX + (projected.x - topLeft.x) * scale,\n            y: offsetY + (projected.y - topLeft.y) * scale,\n        };\n    };\n\n    return { project, scale, width, height };\n}\n"],"mappings":"+BAsBA,IAAa,EAAwB,YAUrC,SAAgB,EAAgB,EAAkC,CAK9D,IAAM,EAJM,KAAK,IACb,aACA,KAAK,IAAI,EAAuB,EAAA,cAAc,EAAM,QAAQ,CAAC,CAEjD,EAAM,KAAK,GAAM,IAGjC,MAAO,CAAE,GAFE,EAAM,UAAY,KAAO,IAExB,GADD,EAAI,KAAK,IAAI,KAAK,IAAI,CAAM,EAAI,EAAI,KAAK,IAAI,CAAM,CAAC,EAAI,KAAK,IAAM,CAChE,CAClB,CASA,SAAgB,EAAkB,EAAkC,CAChE,IAAM,EAAY,EAAM,EAAI,IAAM,IAC5B,EAAI,KAAK,IAAM,EAAI,EAAI,EAAM,GAEnC,MAAO,CAAE,SADS,KAAK,KAAK,KAAK,KAAK,CAAC,CAAC,EAAI,IAAO,KAAK,GACrC,WAAU,CACjC,CAgCA,SAAgB,EACZ,EACA,EACA,EACA,EAAgC,CAAC,EACjB,CAChB,GAAM,CAAE,UAAU,IAAO,EAEnB,EAAU,EAAgB,CAC5B,SAAU,EAAO,YACjB,UAAW,EAAO,YACtB,CAAC,EACK,EAAc,EAAgB,CAChC,SAAU,EAAO,YACjB,UAAW,EAAO,YACtB,CAAC,EAEK,EAAQ,EAAY,EAAI,EAAQ,UAChC,EAAQ,EAAY,EAAI,EAAQ,UAEhC,EAAa,KAAK,IAAI,EAAG,EAAQ,EAAU,CAAC,EAC5C,EAAc,KAAK,IAAI,EAAG,EAAS,EAAU,CAAC,EAG9C,EAAQ,KAAK,IAAI,EAAa,EAAO,EAAc,CAAK,EAGxD,EAAU,GAAW,EAAa,EAAQ,GAAS,EACnD,EAAU,GAAW,EAAc,EAAQ,GAAS,EAU1D,MAAO,CAAE,QARQ,GAAkC,CAC/C,IAAM,EAAY,EAAgB,CAAK,EACvC,MAAO,CACH,EAAG,GAAW,EAAU,EAAI,EAAQ,GAAK,EACzC,EAAG,GAAW,EAAU,EAAI,EAAQ,GAAK,CAC7C,CACJ,EAEkB,QAAO,QAAO,QAAO,CAC3C"}

package/dist/geo/projection.js

@@ -1,36 +1,42 @@
-import { clampLatitude as g } from "./types.js";
-const d = 85.05112878;
-function r(t) {
-  const n = Math.max(
-    -d,
-    Math.min(d, g(t.latitude))
-  ) * Math.PI / 180, c = (t.longitude + 180) / 360, o = (1 - Math.log(Math.tan(n) + 1 / Math.cos(n)) / Math.PI) / 2;
-  return { x: c, y: o };
+import { clampLatitude as e } from "./types.js";
+//#region src/geo/projection.ts
+var t = 85.05112878;
+function n(n) {
+	let r = Math.max(-85.05112878, Math.min(t, e(n.latitude))) * Math.PI / 180;
+	return {
+		x: (n.longitude + 180) / 360,
+		y: (1 - Math.log(Math.tan(r) + 1 / Math.cos(r)) / Math.PI) / 2
+	};
 }
-function I(t) {
-  const a = t.x * 360 - 180, n = Math.PI * (1 - 2 * t.y);
-  return { latitude: Math.atan(Math.sinh(n)) * 180 / Math.PI, longitude: a };
+function r(e) {
+	let t = e.x * 360 - 180, n = Math.PI * (1 - 2 * e.y);
+	return {
+		latitude: Math.atan(Math.sinh(n)) * 180 / Math.PI,
+		longitude: t
+	};
 }
-function P(t, a, n, c = {}) {
-  const { padding: o = 16 } = c, i = r({
-    latitude: t.maxLatitude,
-    longitude: t.minLongitude
-  }), s = r({
-    latitude: t.minLatitude,
-    longitude: t.maxLongitude
-  }), u = s.x - i.x || Number.EPSILON, M = s.y - i.y || Number.EPSILON, h = Math.max(1, a - o * 2), l = Math.max(1, n - o * 2), e = Math.min(h / u, l / M), x = o + (h - u * e) / 2, p = o + (l - M * e) / 2;
-  return { project: (f) => {
-    const m = r(f);
-    return {
-      x: x + (m.x - i.x) * e,
-      y: p + (m.y - i.y) * e
-    };
-  }, scale: e, width: a, height: n };
+function i(e, t, r, i = {}) {
+	let { padding: a = 16 } = i, o = n({
+		latitude: e.maxLatitude,
+		longitude: e.minLongitude
+	}), s = n({
+		latitude: e.minLatitude,
+		longitude: e.maxLongitude
+	}), c = s.x - o.x || 2 ** -52, l = s.y - o.y || 2 ** -52, u = Math.max(1, t - a * 2), d = Math.max(1, r - a * 2), f = Math.min(u / c, d / l), p = a + (u - c * f) / 2, m = a + (d - l * f) / 2;
+	return {
+		project: (e) => {
+			let t = n(e);
+			return {
+				x: p + (t.x - o.x) * f,
+				y: m + (t.y - o.y) * f
+			};
+		},
+		scale: f,
+		width: t,
+		height: r
+	};
 }
-export {
-  d as MERCATOR_MAX_LATITUDE,
-  P as fitProjection,
-  r as projectMercator,
-  I as unprojectMercator
-};
-//# sourceMappingURL=projection.js.map
+//#endregion
+export { t as MERCATOR_MAX_LATITUDE, i as fitProjection, n as projectMercator, r as unprojectMercator };
+
+//# sourceMappingURL=projection.js.map

package/dist/geo/projection.js.map

@@ -1 +1 @@
-{"version":3,"file":"projection.js","sources":["../../src/geo/projection.ts"],"sourcesContent":["import { clampLatitude } from \"./types\";\nimport type { Coordinate, GeoBounds } from \"./types\";\n\n/**\n * A point projected onto the unit Web Mercator plane. Both axes are in `[0, 1]`\n * — `x` grows east, `y` grows south (screen convention).\n */\nexport interface MercatorPoint {\n    x: number;\n    y: number;\n}\n\n/** A pixel coordinate inside the plotting viewport. */\nexport interface PixelPoint {\n    x: number;\n    y: number;\n}\n\n/**\n * Web Mercator (EPSG:3857) latitude clamp. Latitudes beyond this diverge to\n * infinity in the projection, so tile maps cap here.\n */\nexport const MERCATOR_MAX_LATITUDE = 85.05112878;\n\n/**\n * Project a geographic coordinate onto the unit Web Mercator plane. This is the\n * same projection tile servers use, so a self-hosted tile layer and the\n * tile-free SVG plot line up pixel-for-pixel.\n *\n * @param coord - Coordinate to project.\n * @returns `{ x, y }` in `[0, 1]`.\n */\nexport function projectMercator(coord: Coordinate): MercatorPoint {\n    const lat = Math.max(\n        -MERCATOR_MAX_LATITUDE,\n        Math.min(MERCATOR_MAX_LATITUDE, clampLatitude(coord.latitude)),\n    );\n    const latRad = (lat * Math.PI) / 180;\n    const x = (coord.longitude + 180) / 360;\n    const y = (1 - Math.log(Math.tan(latRad) + 1 / Math.cos(latRad)) / Math.PI) / 2;\n    return { x, y };\n}\n\n/**\n * Inverse of {@link projectMercator}: recover a coordinate from a unit-plane\n * point.\n *\n * @param point - `{ x, y }` in `[0, 1]`.\n * @returns The geographic coordinate.\n */\nexport function unprojectMercator(point: MercatorPoint): Coordinate {\n    const longitude = point.x * 360 - 180;\n    const n = Math.PI * (1 - 2 * point.y);\n    const latitude = (Math.atan(Math.sinh(n)) * 180) / Math.PI;\n    return { latitude, longitude };\n}\n\n/** A ready-to-use mapping from coordinates to viewport pixels. */\nexport interface FittedProjection {\n    /** Project a coordinate to a pixel inside the viewport. */\n    project: (coord: Coordinate) => PixelPoint;\n    /** Uniform scale (unit-plane → pixels) actually used, after aspect fit. */\n    scale: number;\n    /** Viewport width in pixels. */\n    width: number;\n    /** Viewport height in pixels. */\n    height: number;\n}\n\n/** Options for {@link fitProjection}. */\nexport interface FitProjectionOptions {\n    /** Inner padding in pixels kept clear on every edge. Default: `16`. */\n    padding?: number;\n}\n\n/**\n * Build a projection that fits `bounds` into a `width × height` viewport while\n * preserving aspect ratio (uniform scale, centered). This is what powers the\n * tile-free trajectory plot: project the bounds, scale to the SVG box, keep\n * shapes undistorted.\n *\n * @param bounds - Geographic extent to fit.\n * @param width - Viewport width in pixels.\n * @param height - Viewport height in pixels.\n * @param options - Padding tuning.\n * @returns A {@link FittedProjection} with a `project(coord)` mapper.\n */\nexport function fitProjection(\n    bounds: GeoBounds,\n    width: number,\n    height: number,\n    options: FitProjectionOptions = {},\n): FittedProjection {\n    const { padding = 16 } = options;\n\n    const topLeft = projectMercator({\n        latitude: bounds.maxLatitude,\n        longitude: bounds.minLongitude,\n    });\n    const bottomRight = projectMercator({\n        latitude: bounds.minLatitude,\n        longitude: bounds.maxLongitude,\n    });\n\n    const spanX = bottomRight.x - topLeft.x || Number.EPSILON;\n    const spanY = bottomRight.y - topLeft.y || Number.EPSILON;\n\n    const innerWidth = Math.max(1, width - padding * 2);\n    const innerHeight = Math.max(1, height - padding * 2);\n\n    // Uniform scale keeps the trajectory undistorted; fit the tighter axis.\n    const scale = Math.min(innerWidth / spanX, innerHeight / spanY);\n\n    // Center the projected content within the padded box.\n    const offsetX = padding + (innerWidth - spanX * scale) / 2;\n    const offsetY = padding + (innerHeight - spanY * scale) / 2;\n\n    const project = (coord: Coordinate): PixelPoint => {\n        const projected = projectMercator(coord);\n        return {\n            x: offsetX + (projected.x - topLeft.x) * scale,\n            y: offsetY + (projected.y - topLeft.y) * scale,\n        };\n    };\n\n    return { project, scale, width, height };\n}\n"],"names":["MERCATOR_MAX_LATITUDE","projectMercator","coord","latRad","clampLatitude","x","y","unprojectMercator","point","longitude","fitProjection","bounds","width","height","options","padding","topLeft","bottomRight","spanX","spanY","innerWidth","innerHeight","scale","offsetX","offsetY","projected"],"mappings":";AAsBO,MAAMA,IAAwB;AAU9B,SAASC,EAAgBC,GAAkC;AAK9D,QAAMC,IAJM,KAAK;AAAA,IACb,CAACH;AAAA,IACD,KAAK,IAAIA,GAAuBI,EAAcF,EAAM,QAAQ,CAAC;AAAA,EAAA,IAE3C,KAAK,KAAM,KAC3BG,KAAKH,EAAM,YAAY,OAAO,KAC9BI,KAAK,IAAI,KAAK,IAAI,KAAK,IAAIH,CAAM,IAAI,IAAI,KAAK,IAAIA,CAAM,CAAC,IAAI,KAAK,MAAM;AAC9E,SAAO,EAAE,GAAAE,GAAG,GAAAC,EAAA;AAChB;AASO,SAASC,EAAkBC,GAAkC;AAChE,QAAMC,IAAYD,EAAM,IAAI,MAAM,KAC5B,IAAI,KAAK,MAAM,IAAI,IAAIA,EAAM;AAEnC,SAAO,EAAE,UADS,KAAK,KAAK,KAAK,KAAK,CAAC,CAAC,IAAI,MAAO,KAAK,IACrC,WAAAC,EAAA;AACvB;AAgCO,SAASC,EACZC,GACAC,GACAC,GACAC,IAAgC,CAAA,GAChB;AAChB,QAAM,EAAE,SAAAC,IAAU,GAAA,IAAOD,GAEnBE,IAAUf,EAAgB;AAAA,IAC5B,UAAUU,EAAO;AAAA,IACjB,WAAWA,EAAO;AAAA,EAAA,CACrB,GACKM,IAAchB,EAAgB;AAAA,IAChC,UAAUU,EAAO;AAAA,IACjB,WAAWA,EAAO;AAAA,EAAA,CACrB,GAEKO,IAAQD,EAAY,IAAID,EAAQ,KAAK,OAAO,SAC5CG,IAAQF,EAAY,IAAID,EAAQ,KAAK,OAAO,SAE5CI,IAAa,KAAK,IAAI,GAAGR,IAAQG,IAAU,CAAC,GAC5CM,IAAc,KAAK,IAAI,GAAGR,IAASE,IAAU,CAAC,GAG9CO,IAAQ,KAAK,IAAIF,IAAaF,GAAOG,IAAcF,CAAK,GAGxDI,IAAUR,KAAWK,IAAaF,IAAQI,KAAS,GACnDE,IAAUT,KAAWM,IAAcF,IAAQG,KAAS;AAU1D,SAAO,EAAE,SARO,CAACpB,MAAkC;AAC/C,UAAMuB,IAAYxB,EAAgBC,CAAK;AACvC,WAAO;AAAA,MACH,GAAGqB,KAAWE,EAAU,IAAIT,EAAQ,KAAKM;AAAA,MACzC,GAAGE,KAAWC,EAAU,IAAIT,EAAQ,KAAKM;AAAA,IAAA;AAAA,EAEjD,GAEkB,OAAAA,GAAO,OAAAV,GAAO,QAAAC,EAAA;AACpC;"}
+{"version":3,"file":"projection.js","names":[],"sources":["../../src/geo/projection.ts"],"sourcesContent":["import { clampLatitude } from \"./types\";\nimport type { Coordinate, GeoBounds } from \"./types\";\n\n/**\n * A point projected onto the unit Web Mercator plane. Both axes are in `[0, 1]`\n * — `x` grows east, `y` grows south (screen convention).\n */\nexport interface MercatorPoint {\n    x: number;\n    y: number;\n}\n\n/** A pixel coordinate inside the plotting viewport. */\nexport interface PixelPoint {\n    x: number;\n    y: number;\n}\n\n/**\n * Web Mercator (EPSG:3857) latitude clamp. Latitudes beyond this diverge to\n * infinity in the projection, so tile maps cap here.\n */\nexport const MERCATOR_MAX_LATITUDE = 85.05112878;\n\n/**\n * Project a geographic coordinate onto the unit Web Mercator plane. This is the\n * same projection tile servers use, so a self-hosted tile layer and the\n * tile-free SVG plot line up pixel-for-pixel.\n *\n * @param coord - Coordinate to project.\n * @returns `{ x, y }` in `[0, 1]`.\n */\nexport function projectMercator(coord: Coordinate): MercatorPoint {\n    const lat = Math.max(\n        -MERCATOR_MAX_LATITUDE,\n        Math.min(MERCATOR_MAX_LATITUDE, clampLatitude(coord.latitude)),\n    );\n    const latRad = (lat * Math.PI) / 180;\n    const x = (coord.longitude + 180) / 360;\n    const y = (1 - Math.log(Math.tan(latRad) + 1 / Math.cos(latRad)) / Math.PI) / 2;\n    return { x, y };\n}\n\n/**\n * Inverse of {@link projectMercator}: recover a coordinate from a unit-plane\n * point.\n *\n * @param point - `{ x, y }` in `[0, 1]`.\n * @returns The geographic coordinate.\n */\nexport function unprojectMercator(point: MercatorPoint): Coordinate {\n    const longitude = point.x * 360 - 180;\n    const n = Math.PI * (1 - 2 * point.y);\n    const latitude = (Math.atan(Math.sinh(n)) * 180) / Math.PI;\n    return { latitude, longitude };\n}\n\n/** A ready-to-use mapping from coordinates to viewport pixels. */\nexport interface FittedProjection {\n    /** Project a coordinate to a pixel inside the viewport. */\n    project: (coord: Coordinate) => PixelPoint;\n    /** Uniform scale (unit-plane → pixels) actually used, after aspect fit. */\n    scale: number;\n    /** Viewport width in pixels. */\n    width: number;\n    /** Viewport height in pixels. */\n    height: number;\n}\n\n/** Options for {@link fitProjection}. */\nexport interface FitProjectionOptions {\n    /** Inner padding in pixels kept clear on every edge. Default: `16`. */\n    padding?: number;\n}\n\n/**\n * Build a projection that fits `bounds` into a `width × height` viewport while\n * preserving aspect ratio (uniform scale, centered). This is what powers the\n * tile-free trajectory plot: project the bounds, scale to the SVG box, keep\n * shapes undistorted.\n *\n * @param bounds - Geographic extent to fit.\n * @param width - Viewport width in pixels.\n * @param height - Viewport height in pixels.\n * @param options - Padding tuning.\n * @returns A {@link FittedProjection} with a `project(coord)` mapper.\n */\nexport function fitProjection(\n    bounds: GeoBounds,\n    width: number,\n    height: number,\n    options: FitProjectionOptions = {},\n): FittedProjection {\n    const { padding = 16 } = options;\n\n    const topLeft = projectMercator({\n        latitude: bounds.maxLatitude,\n        longitude: bounds.minLongitude,\n    });\n    const bottomRight = projectMercator({\n        latitude: bounds.minLatitude,\n        longitude: bounds.maxLongitude,\n    });\n\n    const spanX = bottomRight.x - topLeft.x || Number.EPSILON;\n    const spanY = bottomRight.y - topLeft.y || Number.EPSILON;\n\n    const innerWidth = Math.max(1, width - padding * 2);\n    const innerHeight = Math.max(1, height - padding * 2);\n\n    // Uniform scale keeps the trajectory undistorted; fit the tighter axis.\n    const scale = Math.min(innerWidth / spanX, innerHeight / spanY);\n\n    // Center the projected content within the padded box.\n    const offsetX = padding + (innerWidth - spanX * scale) / 2;\n    const offsetY = padding + (innerHeight - spanY * scale) / 2;\n\n    const project = (coord: Coordinate): PixelPoint => {\n        const projected = projectMercator(coord);\n        return {\n            x: offsetX + (projected.x - topLeft.x) * scale,\n            y: offsetY + (projected.y - topLeft.y) * scale,\n        };\n    };\n\n    return { project, scale, width, height };\n}\n"],"mappings":";;AAsBA,IAAa,IAAwB;AAUrC,SAAgB,EAAgB,GAAkC;CAK9D,IAAM,IAJM,KAAK,IACb,cACA,KAAK,IAAI,GAAuB,EAAc,EAAM,QAAQ,CAAC,CAEjD,IAAM,KAAK,KAAM;CAGjC,OAAO;EAAE,IAFE,EAAM,YAAY,OAAO;EAExB,IADD,IAAI,KAAK,IAAI,KAAK,IAAI,CAAM,IAAI,IAAI,KAAK,IAAI,CAAM,CAAC,IAAI,KAAK,MAAM;CAChE;AAClB;AASA,SAAgB,EAAkB,GAAkC;CAChE,IAAM,IAAY,EAAM,IAAI,MAAM,KAC5B,IAAI,KAAK,MAAM,IAAI,IAAI,EAAM;CAEnC,OAAO;EAAE,UADS,KAAK,KAAK,KAAK,KAAK,CAAC,CAAC,IAAI,MAAO,KAAK;EACrC;CAAU;AACjC;AAgCA,SAAgB,EACZ,GACA,GACA,GACA,IAAgC,CAAC,GACjB;CAChB,IAAM,EAAE,aAAU,OAAO,GAEnB,IAAU,EAAgB;EAC5B,UAAU,EAAO;EACjB,WAAW,EAAO;CACtB,CAAC,GACK,IAAc,EAAgB;EAChC,UAAU,EAAO;EACjB,WAAW,EAAO;CACtB,CAAC,GAEK,IAAQ,EAAY,IAAI,EAAQ,eAChC,IAAQ,EAAY,IAAI,EAAQ,eAEhC,IAAa,KAAK,IAAI,GAAG,IAAQ,IAAU,CAAC,GAC5C,IAAc,KAAK,IAAI,GAAG,IAAS,IAAU,CAAC,GAG9C,IAAQ,KAAK,IAAI,IAAa,GAAO,IAAc,CAAK,GAGxD,IAAU,KAAW,IAAa,IAAQ,KAAS,GACnD,IAAU,KAAW,IAAc,IAAQ,KAAS;CAU1D,OAAO;EAAE,UARQ,MAAkC;GAC/C,IAAM,IAAY,EAAgB,CAAK;GACvC,OAAO;IACH,GAAG,KAAW,EAAU,IAAI,EAAQ,KAAK;IACzC,GAAG,KAAW,EAAU,IAAI,EAAQ,KAAK;GAC7C;EACJ;EAEkB;EAAO;EAAO;CAAO;AAC3C"}

package/dist/geo/routing.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const f=require("./estimate.cjs");function S(s){const{baseUrl:a,fetch:u=globalThis.fetch,modeDurationFactors:i}=s,d=a.replace(/\/+$/,"");return{async route(o,n,l={}){const c=l.mode??"car",m=`${o.longitude},${o.latitude};${n.longitude},${n.latitude}`,$=`${d}/route/v1/driving/${m}?overview=false`;let e;try{e=await(await u($)).json()}catch(r){throw new Error(`OSRM request failed: ${String(r)}`,{cause:r})}const t=e.routes?.[0];if(e.code!=="Ok"||!t)throw new Error(`OSRM returned no route (code: ${e.code??"unknown"})`);const w=t.distance/1e3,M=t.duration/60*f.durationFactor(c,i);return{mode:c,distance_km:w,duration_minutes:M,source:"osrm"}}}}exports.createOSRMBackend=S;
-//# sourceMappingURL=routing.cjs.map
+const e=require("./estimate.cjs");function t(t){let{baseUrl:n,fetch:r=globalThis.fetch,modeDurationFactors:i}=t,a=n.replace(/\/+$/,``);return{async route(t,n,o={}){let s=o.mode??`car`,c=`${t.longitude},${t.latitude};${n.longitude},${n.latitude}`,l=`${a}/route/v1/driving/${c}?overview=false`,u;try{u=await(await r(l)).json()}catch(e){throw Error(`OSRM request failed: ${String(e)}`,{cause:e})}let d=u.routes?.[0];if(u.code!==`Ok`||!d)throw Error(`OSRM returned no route (code: ${u.code??`unknown`})`);return{mode:s,distance_km:d.distance/1e3,duration_minutes:d.duration/60*e.durationFactor(s,i),source:`osrm`}}}}exports.createOSRMBackend=t;
+//# sourceMappingURL=routing.cjs.map

package/dist/geo/routing.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"routing.cjs","sources":["../../src/geo/routing.ts"],"sourcesContent":["import { durationFactor } from \"./estimate\";\nimport type { Coordinate, TravelEstimate, TravelMode } from \"./types\";\n\n/**\n * Pluggable routing backend. A backend turns two coordinates into a\n * {@link TravelEstimate}. Mirrors the `RoutingBackend` protocol from\n * `tempest-fastapi-sdk` so client and server share the same contract.\n *\n * Implement this to route against your own self-hosted engine (OSRM, Valhalla,\n * GraphHopper). The offline {@link estimateTravel} heuristic satisfies the same\n * shape without any network.\n */\nexport interface RoutingBackend {\n    route: (\n        origin: Coordinate,\n        destination: Coordinate,\n        options?: { mode?: TravelMode },\n    ) => Promise<TravelEstimate>;\n}\n\n/** Options for {@link createOSRMBackend}. */\nexport interface OSRMBackendOptions {\n    /**\n     * Base URL of an **OSRM** HTTP server. There is no default on purpose — this\n     * SDK ships no external endpoint. Point it at a routing engine **you host**.\n     */\n    baseUrl: string;\n    /** `fetch` implementation. Default: the global `fetch`. */\n    fetch?: typeof globalThis.fetch;\n    /** Per-mode duration multipliers applied over the car profile. */\n    modeDurationFactors?: Partial<Record<TravelMode, number>>;\n}\n\ninterface OSRMRoute {\n    distance: number;\n    duration: number;\n}\n\ninterface OSRMResponse {\n    code?: string;\n    routes?: OSRMRoute[];\n}\n\n/**\n * Build a {@link RoutingBackend} backed by an OSRM server **you host**. OSRM\n * only serves a driving profile, so motorcycle/bus durations are derived by\n * scaling the car duration through {@link durationFactor} — same approach as\n * the FastAPI SDK's `OSRMBackend`.\n *\n * !!! warning\n *     This makes a network request to `baseUrl`. It is opt-in: nothing in the\n *     SDK calls it unless you construct it and pass your own server URL. For a\n *     zero-network estimate, use {@link estimateTravel} instead.\n *\n * @param options - Server URL, optional `fetch`, per-mode factors.\n * @returns A backend whose `route()` queries OSRM.\n *\n * @example\n * const backend = createOSRMBackend({ baseUrl: \"https://osrm.internal\" });\n * const estimate = await backend.route(origin, destination, { mode: \"car\" });\n */\nexport function createOSRMBackend(options: OSRMBackendOptions): RoutingBackend {\n    const { baseUrl, fetch = globalThis.fetch, modeDurationFactors } = options;\n    const trimmedBaseUrl = baseUrl.replace(/\\/+$/, \"\");\n\n    return {\n        async route(origin, destination, routeOptions = {}): Promise<TravelEstimate> {\n            const mode = routeOptions.mode ?? \"car\";\n            const coords = `${origin.longitude},${origin.latitude};${destination.longitude},${destination.latitude}`;\n            const url = `${trimmedBaseUrl}/route/v1/driving/${coords}?overview=false`;\n\n            let payload: OSRMResponse;\n            try {\n                const response = await fetch(url);\n                payload = (await response.json()) as OSRMResponse;\n            } catch (cause) {\n                throw new Error(`OSRM request failed: ${String(cause)}`, { cause });\n            }\n\n            const route = payload.routes?.[0];\n            if (payload.code !== \"Ok\" || !route) {\n                throw new Error(`OSRM returned no route (code: ${payload.code ?? \"unknown\"})`);\n            }\n\n            const distanceKm = route.distance / 1000.0;\n            const carMinutes = route.duration / 60.0;\n            const durationMinutes = carMinutes * durationFactor(mode, modeDurationFactors);\n\n            return {\n                mode,\n                distance_km: distanceKm,\n                duration_minutes: durationMinutes,\n                source: \"osrm\",\n            };\n        },\n    };\n}\n"],"names":["createOSRMBackend","options","baseUrl","fetch","modeDurationFactors","trimmedBaseUrl","origin","destination","routeOptions","mode","coords","url","payload","cause","route","distanceKm","durationMinutes","durationFactor"],"mappings":"kHA6DO,SAASA,EAAkBC,EAA6C,CAC3E,KAAM,CAAE,QAAAC,EAAS,MAAAC,EAAQ,WAAW,MAAO,oBAAAC,GAAwBH,EAC7DI,EAAiBH,EAAQ,QAAQ,OAAQ,EAAE,EAEjD,MAAO,CACH,MAAM,MAAMI,EAAQC,EAAaC,EAAe,CAAA,EAA6B,CACzE,MAAMC,EAAOD,EAAa,MAAQ,MAC5BE,EAAS,GAAGJ,EAAO,SAAS,IAAIA,EAAO,QAAQ,IAAIC,EAAY,SAAS,IAAIA,EAAY,QAAQ,GAChGI,EAAM,GAAGN,CAAc,qBAAqBK,CAAM,kBAExD,IAAIE,EACJ,GAAI,CAEAA,EAAW,MADM,MAAMT,EAAMQ,CAAG,GACN,KAAA,CAC9B,OAASE,EAAO,CACZ,MAAM,IAAI,MAAM,wBAAwB,OAAOA,CAAK,CAAC,GAAI,CAAE,MAAAA,EAAO,CACtE,CAEA,MAAMC,EAAQF,EAAQ,SAAS,CAAC,EAChC,GAAIA,EAAQ,OAAS,MAAQ,CAACE,EAC1B,MAAM,IAAI,MAAM,iCAAiCF,EAAQ,MAAQ,SAAS,GAAG,EAGjF,MAAMG,EAAaD,EAAM,SAAW,IAE9BE,EADaF,EAAM,SAAW,GACCG,iBAAeR,EAAML,CAAmB,EAE7E,MAAO,CACH,KAAAK,EACA,YAAaM,EACb,iBAAkBC,EAClB,OAAQ,MAAA,CAEhB,CAAA,CAER"}
+{"version":3,"file":"routing.cjs","names":[],"sources":["../../src/geo/routing.ts"],"sourcesContent":["import { durationFactor } from \"./estimate\";\nimport type { Coordinate, TravelEstimate, TravelMode } from \"./types\";\n\n/**\n * Pluggable routing backend. A backend turns two coordinates into a\n * {@link TravelEstimate}. Mirrors the `RoutingBackend` protocol from\n * `tempest-fastapi-sdk` so client and server share the same contract.\n *\n * Implement this to route against your own self-hosted engine (OSRM, Valhalla,\n * GraphHopper). The offline {@link estimateTravel} heuristic satisfies the same\n * shape without any network.\n */\nexport interface RoutingBackend {\n    route: (\n        origin: Coordinate,\n        destination: Coordinate,\n        options?: { mode?: TravelMode },\n    ) => Promise<TravelEstimate>;\n}\n\n/** Options for {@link createOSRMBackend}. */\nexport interface OSRMBackendOptions {\n    /**\n     * Base URL of an **OSRM** HTTP server. There is no default on purpose — this\n     * SDK ships no external endpoint. Point it at a routing engine **you host**.\n     */\n    baseUrl: string;\n    /** `fetch` implementation. Default: the global `fetch`. */\n    fetch?: typeof globalThis.fetch;\n    /** Per-mode duration multipliers applied over the car profile. */\n    modeDurationFactors?: Partial<Record<TravelMode, number>>;\n}\n\ninterface OSRMRoute {\n    distance: number;\n    duration: number;\n}\n\ninterface OSRMResponse {\n    code?: string;\n    routes?: OSRMRoute[];\n}\n\n/**\n * Build a {@link RoutingBackend} backed by an OSRM server **you host**. OSRM\n * only serves a driving profile, so motorcycle/bus durations are derived by\n * scaling the car duration through {@link durationFactor} — same approach as\n * the FastAPI SDK's `OSRMBackend`.\n *\n * !!! warning\n *     This makes a network request to `baseUrl`. It is opt-in: nothing in the\n *     SDK calls it unless you construct it and pass your own server URL. For a\n *     zero-network estimate, use {@link estimateTravel} instead.\n *\n * @param options - Server URL, optional `fetch`, per-mode factors.\n * @returns A backend whose `route()` queries OSRM.\n *\n * @example\n * const backend = createOSRMBackend({ baseUrl: \"https://osrm.internal\" });\n * const estimate = await backend.route(origin, destination, { mode: \"car\" });\n */\nexport function createOSRMBackend(options: OSRMBackendOptions): RoutingBackend {\n    const { baseUrl, fetch = globalThis.fetch, modeDurationFactors } = options;\n    const trimmedBaseUrl = baseUrl.replace(/\\/+$/, \"\");\n\n    return {\n        async route(origin, destination, routeOptions = {}): Promise<TravelEstimate> {\n            const mode = routeOptions.mode ?? \"car\";\n            const coords = `${origin.longitude},${origin.latitude};${destination.longitude},${destination.latitude}`;\n            const url = `${trimmedBaseUrl}/route/v1/driving/${coords}?overview=false`;\n\n            let payload: OSRMResponse;\n            try {\n                const response = await fetch(url);\n                payload = (await response.json()) as OSRMResponse;\n            } catch (cause) {\n                throw new Error(`OSRM request failed: ${String(cause)}`, { cause });\n            }\n\n            const route = payload.routes?.[0];\n            if (payload.code !== \"Ok\" || !route) {\n                throw new Error(`OSRM returned no route (code: ${payload.code ?? \"unknown\"})`);\n            }\n\n            const distanceKm = route.distance / 1000.0;\n            const carMinutes = route.duration / 60.0;\n            const durationMinutes = carMinutes * durationFactor(mode, modeDurationFactors);\n\n            return {\n                mode,\n                distance_km: distanceKm,\n                duration_minutes: durationMinutes,\n                source: \"osrm\",\n            };\n        },\n    };\n}\n"],"mappings":"kCA6DA,SAAgB,EAAkB,EAA6C,CAC3E,GAAM,CAAE,UAAS,QAAQ,WAAW,MAAO,uBAAwB,EAC7D,EAAiB,EAAQ,QAAQ,OAAQ,EAAE,EAEjD,MAAO,CACH,MAAM,MAAM,EAAQ,EAAa,EAAe,CAAC,EAA4B,CACzE,IAAM,EAAO,EAAa,MAAQ,MAC5B,EAAS,GAAG,EAAO,UAAU,GAAG,EAAO,SAAS,GAAG,EAAY,UAAU,GAAG,EAAY,WACxF,EAAM,GAAG,EAAe,oBAAoB,EAAO,iBAErD,EACJ,GAAI,CAEA,EAAW,MAAM,MADM,EAAM,CAAG,EAAA,CACN,KAAK,CACnC,OAAS,EAAO,CACZ,MAAU,MAAM,wBAAwB,OAAO,CAAK,IAAK,CAAE,OAAM,CAAC,CACtE,CAEA,IAAM,EAAQ,EAAQ,SAAS,GAC/B,GAAI,EAAQ,OAAS,MAAQ,CAAC,EAC1B,MAAU,MAAM,iCAAiC,EAAQ,MAAQ,UAAU,EAAE,EAOjF,MAAO,CACH,OACA,YANe,EAAM,SAAW,IAOhC,iBANe,EAAM,SAAW,GACC,EAAA,eAAe,EAAM,CAAmB,EAMzE,OAAQ,MACZ,CACJ,CACJ,CACJ"}

package/dist/geo/routing.js

@@ -1,29 +1,25 @@
-import { durationFactor as h } from "./estimate.js";
-function g(s) {
-  const { baseUrl: a, fetch: u = globalThis.fetch, modeDurationFactors: i } = s, d = a.replace(/\/+$/, "");
-  return {
-    async route(r, n, l = {}) {
-      const c = l.mode ?? "car", m = `${r.longitude},${r.latitude};${n.longitude},${n.latitude}`, $ = `${d}/route/v1/driving/${m}?overview=false`;
-      let e;
-      try {
-        e = await (await u($)).json();
-      } catch (o) {
-        throw new Error(`OSRM request failed: ${String(o)}`, { cause: o });
-      }
-      const t = e.routes?.[0];
-      if (e.code !== "Ok" || !t)
-        throw new Error(`OSRM returned no route (code: ${e.code ?? "unknown"})`);
-      const w = t.distance / 1e3, f = t.duration / 60 * h(c, i);
-      return {
-        mode: c,
-        distance_km: w,
-        duration_minutes: f,
-        source: "osrm"
-      };
-    }
-  };
+import { durationFactor as e } from "./estimate.js";
+//#region src/geo/routing.ts
+function t(t) {
+	let { baseUrl: n, fetch: r = globalThis.fetch, modeDurationFactors: i } = t, a = n.replace(/\/+$/, "");
+	return { async route(t, n, o = {}) {
+		let s = o.mode ?? "car", c = `${t.longitude},${t.latitude};${n.longitude},${n.latitude}`, l = `${a}/route/v1/driving/${c}?overview=false`, u;
+		try {
+			u = await (await r(l)).json();
+		} catch (e) {
+			throw Error(`OSRM request failed: ${String(e)}`, { cause: e });
+		}
+		let d = u.routes?.[0];
+		if (u.code !== "Ok" || !d) throw Error(`OSRM returned no route (code: ${u.code ?? "unknown"})`);
+		return {
+			mode: s,
+			distance_km: d.distance / 1e3,
+			duration_minutes: d.duration / 60 * e(s, i),
+			source: "osrm"
+		};
+	} };
 }
-export {
-  g as createOSRMBackend
-};
-//# sourceMappingURL=routing.js.map
+//#endregion
+export { t as createOSRMBackend };
+
+//# sourceMappingURL=routing.js.map

package/dist/geo/routing.js.map

@@ -1 +1 @@
-{"version":3,"file":"routing.js","sources":["../../src/geo/routing.ts"],"sourcesContent":["import { durationFactor } from \"./estimate\";\nimport type { Coordinate, TravelEstimate, TravelMode } from \"./types\";\n\n/**\n * Pluggable routing backend. A backend turns two coordinates into a\n * {@link TravelEstimate}. Mirrors the `RoutingBackend` protocol from\n * `tempest-fastapi-sdk` so client and server share the same contract.\n *\n * Implement this to route against your own self-hosted engine (OSRM, Valhalla,\n * GraphHopper). The offline {@link estimateTravel} heuristic satisfies the same\n * shape without any network.\n */\nexport interface RoutingBackend {\n    route: (\n        origin: Coordinate,\n        destination: Coordinate,\n        options?: { mode?: TravelMode },\n    ) => Promise<TravelEstimate>;\n}\n\n/** Options for {@link createOSRMBackend}. */\nexport interface OSRMBackendOptions {\n    /**\n     * Base URL of an **OSRM** HTTP server. There is no default on purpose — this\n     * SDK ships no external endpoint. Point it at a routing engine **you host**.\n     */\n    baseUrl: string;\n    /** `fetch` implementation. Default: the global `fetch`. */\n    fetch?: typeof globalThis.fetch;\n    /** Per-mode duration multipliers applied over the car profile. */\n    modeDurationFactors?: Partial<Record<TravelMode, number>>;\n}\n\ninterface OSRMRoute {\n    distance: number;\n    duration: number;\n}\n\ninterface OSRMResponse {\n    code?: string;\n    routes?: OSRMRoute[];\n}\n\n/**\n * Build a {@link RoutingBackend} backed by an OSRM server **you host**. OSRM\n * only serves a driving profile, so motorcycle/bus durations are derived by\n * scaling the car duration through {@link durationFactor} — same approach as\n * the FastAPI SDK's `OSRMBackend`.\n *\n * !!! warning\n *     This makes a network request to `baseUrl`. It is opt-in: nothing in the\n *     SDK calls it unless you construct it and pass your own server URL. For a\n *     zero-network estimate, use {@link estimateTravel} instead.\n *\n * @param options - Server URL, optional `fetch`, per-mode factors.\n * @returns A backend whose `route()` queries OSRM.\n *\n * @example\n * const backend = createOSRMBackend({ baseUrl: \"https://osrm.internal\" });\n * const estimate = await backend.route(origin, destination, { mode: \"car\" });\n */\nexport function createOSRMBackend(options: OSRMBackendOptions): RoutingBackend {\n    const { baseUrl, fetch = globalThis.fetch, modeDurationFactors } = options;\n    const trimmedBaseUrl = baseUrl.replace(/\\/+$/, \"\");\n\n    return {\n        async route(origin, destination, routeOptions = {}): Promise<TravelEstimate> {\n            const mode = routeOptions.mode ?? \"car\";\n            const coords = `${origin.longitude},${origin.latitude};${destination.longitude},${destination.latitude}`;\n            const url = `${trimmedBaseUrl}/route/v1/driving/${coords}?overview=false`;\n\n            let payload: OSRMResponse;\n            try {\n                const response = await fetch(url);\n                payload = (await response.json()) as OSRMResponse;\n            } catch (cause) {\n                throw new Error(`OSRM request failed: ${String(cause)}`, { cause });\n            }\n\n            const route = payload.routes?.[0];\n            if (payload.code !== \"Ok\" || !route) {\n                throw new Error(`OSRM returned no route (code: ${payload.code ?? \"unknown\"})`);\n            }\n\n            const distanceKm = route.distance / 1000.0;\n            const carMinutes = route.duration / 60.0;\n            const durationMinutes = carMinutes * durationFactor(mode, modeDurationFactors);\n\n            return {\n                mode,\n                distance_km: distanceKm,\n                duration_minutes: durationMinutes,\n                source: \"osrm\",\n            };\n        },\n    };\n}\n"],"names":["createOSRMBackend","options","baseUrl","fetch","modeDurationFactors","trimmedBaseUrl","origin","destination","routeOptions","mode","coords","url","payload","cause","route","distanceKm","durationMinutes","durationFactor"],"mappings":";AA6DO,SAASA,EAAkBC,GAA6C;AAC3E,QAAM,EAAE,SAAAC,GAAS,OAAAC,IAAQ,WAAW,OAAO,qBAAAC,MAAwBH,GAC7DI,IAAiBH,EAAQ,QAAQ,QAAQ,EAAE;AAEjD,SAAO;AAAA,IACH,MAAM,MAAMI,GAAQC,GAAaC,IAAe,CAAA,GAA6B;AACzE,YAAMC,IAAOD,EAAa,QAAQ,OAC5BE,IAAS,GAAGJ,EAAO,SAAS,IAAIA,EAAO,QAAQ,IAAIC,EAAY,SAAS,IAAIA,EAAY,QAAQ,IAChGI,IAAM,GAAGN,CAAc,qBAAqBK,CAAM;AAExD,UAAIE;AACJ,UAAI;AAEA,QAAAA,IAAW,OADM,MAAMT,EAAMQ,CAAG,GACN,KAAA;AAAA,MAC9B,SAASE,GAAO;AACZ,cAAM,IAAI,MAAM,wBAAwB,OAAOA,CAAK,CAAC,IAAI,EAAE,OAAAA,GAAO;AAAA,MACtE;AAEA,YAAMC,IAAQF,EAAQ,SAAS,CAAC;AAChC,UAAIA,EAAQ,SAAS,QAAQ,CAACE;AAC1B,cAAM,IAAI,MAAM,iCAAiCF,EAAQ,QAAQ,SAAS,GAAG;AAGjF,YAAMG,IAAaD,EAAM,WAAW,KAE9BE,IADaF,EAAM,WAAW,KACCG,EAAeR,GAAML,CAAmB;AAE7E,aAAO;AAAA,QACH,MAAAK;AAAA,QACA,aAAaM;AAAA,QACb,kBAAkBC;AAAA,QAClB,QAAQ;AAAA,MAAA;AAAA,IAEhB;AAAA,EAAA;AAER;"}
+{"version":3,"file":"routing.js","names":[],"sources":["../../src/geo/routing.ts"],"sourcesContent":["import { durationFactor } from \"./estimate\";\nimport type { Coordinate, TravelEstimate, TravelMode } from \"./types\";\n\n/**\n * Pluggable routing backend. A backend turns two coordinates into a\n * {@link TravelEstimate}. Mirrors the `RoutingBackend` protocol from\n * `tempest-fastapi-sdk` so client and server share the same contract.\n *\n * Implement this to route against your own self-hosted engine (OSRM, Valhalla,\n * GraphHopper). The offline {@link estimateTravel} heuristic satisfies the same\n * shape without any network.\n */\nexport interface RoutingBackend {\n    route: (\n        origin: Coordinate,\n        destination: Coordinate,\n        options?: { mode?: TravelMode },\n    ) => Promise<TravelEstimate>;\n}\n\n/** Options for {@link createOSRMBackend}. */\nexport interface OSRMBackendOptions {\n    /**\n     * Base URL of an **OSRM** HTTP server. There is no default on purpose — this\n     * SDK ships no external endpoint. Point it at a routing engine **you host**.\n     */\n    baseUrl: string;\n    /** `fetch` implementation. Default: the global `fetch`. */\n    fetch?: typeof globalThis.fetch;\n    /** Per-mode duration multipliers applied over the car profile. */\n    modeDurationFactors?: Partial<Record<TravelMode, number>>;\n}\n\ninterface OSRMRoute {\n    distance: number;\n    duration: number;\n}\n\ninterface OSRMResponse {\n    code?: string;\n    routes?: OSRMRoute[];\n}\n\n/**\n * Build a {@link RoutingBackend} backed by an OSRM server **you host**. OSRM\n * only serves a driving profile, so motorcycle/bus durations are derived by\n * scaling the car duration through {@link durationFactor} — same approach as\n * the FastAPI SDK's `OSRMBackend`.\n *\n * !!! warning\n *     This makes a network request to `baseUrl`. It is opt-in: nothing in the\n *     SDK calls it unless you construct it and pass your own server URL. For a\n *     zero-network estimate, use {@link estimateTravel} instead.\n *\n * @param options - Server URL, optional `fetch`, per-mode factors.\n * @returns A backend whose `route()` queries OSRM.\n *\n * @example\n * const backend = createOSRMBackend({ baseUrl: \"https://osrm.internal\" });\n * const estimate = await backend.route(origin, destination, { mode: \"car\" });\n */\nexport function createOSRMBackend(options: OSRMBackendOptions): RoutingBackend {\n    const { baseUrl, fetch = globalThis.fetch, modeDurationFactors } = options;\n    const trimmedBaseUrl = baseUrl.replace(/\\/+$/, \"\");\n\n    return {\n        async route(origin, destination, routeOptions = {}): Promise<TravelEstimate> {\n            const mode = routeOptions.mode ?? \"car\";\n            const coords = `${origin.longitude},${origin.latitude};${destination.longitude},${destination.latitude}`;\n            const url = `${trimmedBaseUrl}/route/v1/driving/${coords}?overview=false`;\n\n            let payload: OSRMResponse;\n            try {\n                const response = await fetch(url);\n                payload = (await response.json()) as OSRMResponse;\n            } catch (cause) {\n                throw new Error(`OSRM request failed: ${String(cause)}`, { cause });\n            }\n\n            const route = payload.routes?.[0];\n            if (payload.code !== \"Ok\" || !route) {\n                throw new Error(`OSRM returned no route (code: ${payload.code ?? \"unknown\"})`);\n            }\n\n            const distanceKm = route.distance / 1000.0;\n            const carMinutes = route.duration / 60.0;\n            const durationMinutes = carMinutes * durationFactor(mode, modeDurationFactors);\n\n            return {\n                mode,\n                distance_km: distanceKm,\n                duration_minutes: durationMinutes,\n                source: \"osrm\",\n            };\n        },\n    };\n}\n"],"mappings":";;AA6DA,SAAgB,EAAkB,GAA6C;CAC3E,IAAM,EAAE,YAAS,WAAQ,WAAW,OAAO,2BAAwB,GAC7D,IAAiB,EAAQ,QAAQ,QAAQ,EAAE;CAEjD,OAAO,EACH,MAAM,MAAM,GAAQ,GAAa,IAAe,CAAC,GAA4B;EACzE,IAAM,IAAO,EAAa,QAAQ,OAC5B,IAAS,GAAG,EAAO,UAAU,GAAG,EAAO,SAAS,GAAG,EAAY,UAAU,GAAG,EAAY,YACxF,IAAM,GAAG,EAAe,oBAAoB,EAAO,kBAErD;EACJ,IAAI;GAEA,IAAW,OAAM,MADM,EAAM,CAAG,EAAA,CACN,KAAK;EACnC,SAAS,GAAO;GACZ,MAAU,MAAM,wBAAwB,OAAO,CAAK,KAAK,EAAE,SAAM,CAAC;EACtE;EAEA,IAAM,IAAQ,EAAQ,SAAS;EAC/B,IAAI,EAAQ,SAAS,QAAQ,CAAC,GAC1B,MAAU,MAAM,iCAAiC,EAAQ,QAAQ,UAAU,EAAE;EAOjF,OAAO;GACH;GACA,aANe,EAAM,WAAW;GAOhC,kBANe,EAAM,WAAW,KACC,EAAe,GAAM,CAAmB;GAMzE,QAAQ;EACZ;CACJ,EACJ;AACJ"}

package/dist/geo/types.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function e(t){return Number.isFinite(t)&&t>=-90&&t<=90}function n(t){return Number.isFinite(t)&&t>=-180&&t<=180}function o(t){if(typeof t!="object"||t===null)return!1;const i=t;return typeof i.latitude=="number"&&typeof i.longitude=="number"&&e(i.latitude)&&n(i.longitude)}function r(t){return Math.min(90,Math.max(-90,t))}function u(t){return((t+180)%360+360)%360-180}exports.clampLatitude=r;exports.isCoordinate=o;exports.isValidLatitude=e;exports.isValidLongitude=n;exports.normalizeLongitude=u;
-//# sourceMappingURL=types.cjs.map
+function e(e){return Number.isFinite(e)&&e>=-90&&e<=90}function t(e){return Number.isFinite(e)&&e>=-180&&e<=180}function n(n){if(typeof n!=`object`||!n)return!1;let r=n;return typeof r.latitude==`number`&&typeof r.longitude==`number`&&e(r.latitude)&&t(r.longitude)}function r(e){return Math.min(90,Math.max(-90,e))}function i(e){return((e+180)%360+360)%360-180}exports.clampLatitude=r,exports.isCoordinate=n,exports.isValidLatitude=e,exports.isValidLongitude=t,exports.normalizeLongitude=i;
+//# sourceMappingURL=types.cjs.map

package/dist/geo/types.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.cjs","sources":["../../src/geo/types.ts"],"sourcesContent":["/**\n * WGS84 geographic coordinate. Mirrors the `Coordinate` schema from\n * `tempest-fastapi-sdk` (`geo/schemas.py`) — `latitude` in `[-90, 90]`,\n * `longitude` in `[-180, 180]`, serialized snake_case on the wire.\n */\nexport interface Coordinate {\n    /** WGS84 latitude in degrees, `[-90, 90]`. E.g. `-23.5505`. */\n    latitude: number;\n    /** WGS84 longitude in degrees, `[-180, 180]`. E.g. `-46.6333`. */\n    longitude: number;\n}\n\n/**\n * A pin plotted on a map: a {@link Coordinate} plus optional presentation and\n * an identity used for click callbacks. Shared by `TrajectoryMap` and the\n * Brazil maps' `markers` prop.\n */\nexport interface GeoMarker extends Coordinate {\n    /** Stable identity (returned by click handlers). Falls back to the index. */\n    id?: string;\n    /** Tooltip / accessible label for the pin. */\n    label?: string;\n    /** Fill color. Defaults to the primary token. */\n    color?: string;\n    /** Radius in pixels. Default: 6. */\n    radius?: number;\n}\n\n/**\n * A single sample in a recorded trajectory: a {@link Coordinate} stamped with\n * the epoch millisecond it was captured, plus the optional accuracy radius\n * reported by the Geolocation API.\n */\nexport interface TrackPoint extends Coordinate {\n    /** Capture time in epoch milliseconds (`GeolocationPosition.timestamp`). */\n    timestamp: number;\n    /** Horizontal accuracy radius in meters, if the device reported one. */\n    accuracy?: number;\n}\n\n/**\n * Travel mode. Mirrors the `TravelMode` string enum from `tempest-fastapi-sdk`\n * (`geo/enums.py`) — the on-the-wire value is the raw string.\n */\nexport type TravelMode = \"car\" | \"motorcycle\" | \"bus\";\n\n/**\n * Estimated travel between two coordinates. Mirrors the `TravelEstimate`\n * schema from `tempest-fastapi-sdk` (`geo/schemas.py`), snake_case preserved so\n * a response deserializes straight into this type.\n */\nexport interface TravelEstimate {\n    /** Travel mode the estimate was computed for. */\n    mode: TravelMode;\n    /** Great-circle distance scaled by circuity, in kilometers (`>= 0`). */\n    distance_km: number;\n    /** Estimated duration in minutes (`>= 0`). */\n    duration_minutes: number;\n    /** How the estimate was produced. `\"heuristic\"` (offline) or `\"osrm\"`. */\n    source: \"heuristic\" | \"osrm\";\n}\n\n/**\n * Axis-aligned geographic bounding box. `min`/`max` follow the same degree\n * ranges as {@link Coordinate}.\n */\nexport interface GeoBounds {\n    minLatitude: number;\n    maxLatitude: number;\n    minLongitude: number;\n    maxLongitude: number;\n}\n\n/** True when `value` is a finite latitude in `[-90, 90]`. */\nexport function isValidLatitude(value: number): boolean {\n    return Number.isFinite(value) && value >= -90 && value <= 90;\n}\n\n/** True when `value` is a finite longitude in `[-180, 180]`. */\nexport function isValidLongitude(value: number): boolean {\n    return Number.isFinite(value) && value >= -180 && value <= 180;\n}\n\n/**\n * Type guard for {@link Coordinate}: an object with finite, in-range\n * `latitude` and `longitude`.\n */\nexport function isCoordinate(value: unknown): value is Coordinate {\n    if (typeof value !== \"object\" || value === null) return false;\n    const candidate = value as Record<string, unknown>;\n    return (\n        typeof candidate.latitude === \"number\" &&\n        typeof candidate.longitude === \"number\" &&\n        isValidLatitude(candidate.latitude) &&\n        isValidLongitude(candidate.longitude)\n    );\n}\n\n/** Clamp a latitude into the valid `[-90, 90]` range. */\nexport function clampLatitude(latitude: number): number {\n    return Math.min(90, Math.max(-90, latitude));\n}\n\n/**\n * Normalize a longitude into the `[-180, 180]` range, wrapping values that\n * cross the antimeridian (e.g. `190` → `-170`).\n */\nexport function normalizeLongitude(longitude: number): number {\n    const wrapped = ((((longitude + 180) % 360) + 360) % 360) - 180;\n    return wrapped;\n}\n"],"names":["isValidLatitude","value","isValidLongitude","isCoordinate","candidate","clampLatitude","latitude","normalizeLongitude","longitude"],"mappings":"gFA0EO,SAASA,EAAgBC,EAAwB,CACpD,OAAO,OAAO,SAASA,CAAK,GAAKA,GAAS,KAAOA,GAAS,EAC9D,CAGO,SAASC,EAAiBD,EAAwB,CACrD,OAAO,OAAO,SAASA,CAAK,GAAKA,GAAS,MAAQA,GAAS,GAC/D,CAMO,SAASE,EAAaF,EAAqC,CAC9D,GAAI,OAAOA,GAAU,UAAYA,IAAU,KAAM,MAAO,GACxD,MAAMG,EAAYH,EAClB,OACI,OAAOG,EAAU,UAAa,UAC9B,OAAOA,EAAU,WAAc,UAC/BJ,EAAgBI,EAAU,QAAQ,GAClCF,EAAiBE,EAAU,SAAS,CAE5C,CAGO,SAASC,EAAcC,EAA0B,CACpD,OAAO,KAAK,IAAI,GAAI,KAAK,IAAI,IAAKA,CAAQ,CAAC,CAC/C,CAMO,SAASC,EAAmBC,EAA2B,CAE1D,QADoBA,EAAY,KAAO,IAAO,KAAO,IAAO,GAEhE"}
+{"version":3,"file":"types.cjs","names":[],"sources":["../../src/geo/types.ts"],"sourcesContent":["/**\n * WGS84 geographic coordinate. Mirrors the `Coordinate` schema from\n * `tempest-fastapi-sdk` (`geo/schemas.py`) — `latitude` in `[-90, 90]`,\n * `longitude` in `[-180, 180]`, serialized snake_case on the wire.\n */\nexport interface Coordinate {\n    /** WGS84 latitude in degrees, `[-90, 90]`. E.g. `-23.5505`. */\n    latitude: number;\n    /** WGS84 longitude in degrees, `[-180, 180]`. E.g. `-46.6333`. */\n    longitude: number;\n}\n\n/**\n * A pin plotted on a map: a {@link Coordinate} plus optional presentation and\n * an identity used for click callbacks. Shared by `TrajectoryMap` and the\n * Brazil maps' `markers` prop.\n */\nexport interface GeoMarker extends Coordinate {\n    /** Stable identity (returned by click handlers). Falls back to the index. */\n    id?: string;\n    /** Tooltip / accessible label for the pin. */\n    label?: string;\n    /** Fill color. Defaults to the primary token. */\n    color?: string;\n    /** Radius in pixels. Default: 6. */\n    radius?: number;\n}\n\n/**\n * A single sample in a recorded trajectory: a {@link Coordinate} stamped with\n * the epoch millisecond it was captured, plus the optional accuracy radius\n * reported by the Geolocation API.\n */\nexport interface TrackPoint extends Coordinate {\n    /** Capture time in epoch milliseconds (`GeolocationPosition.timestamp`). */\n    timestamp: number;\n    /** Horizontal accuracy radius in meters, if the device reported one. */\n    accuracy?: number;\n}\n\n/**\n * Travel mode. Mirrors the `TravelMode` string enum from `tempest-fastapi-sdk`\n * (`geo/enums.py`) — the on-the-wire value is the raw string.\n */\nexport type TravelMode = \"car\" | \"motorcycle\" | \"bus\";\n\n/**\n * Estimated travel between two coordinates. Mirrors the `TravelEstimate`\n * schema from `tempest-fastapi-sdk` (`geo/schemas.py`), snake_case preserved so\n * a response deserializes straight into this type.\n */\nexport interface TravelEstimate {\n    /** Travel mode the estimate was computed for. */\n    mode: TravelMode;\n    /** Great-circle distance scaled by circuity, in kilometers (`>= 0`). */\n    distance_km: number;\n    /** Estimated duration in minutes (`>= 0`). */\n    duration_minutes: number;\n    /** How the estimate was produced. `\"heuristic\"` (offline) or `\"osrm\"`. */\n    source: \"heuristic\" | \"osrm\";\n}\n\n/**\n * Axis-aligned geographic bounding box. `min`/`max` follow the same degree\n * ranges as {@link Coordinate}.\n */\nexport interface GeoBounds {\n    minLatitude: number;\n    maxLatitude: number;\n    minLongitude: number;\n    maxLongitude: number;\n}\n\n/** True when `value` is a finite latitude in `[-90, 90]`. */\nexport function isValidLatitude(value: number): boolean {\n    return Number.isFinite(value) && value >= -90 && value <= 90;\n}\n\n/** True when `value` is a finite longitude in `[-180, 180]`. */\nexport function isValidLongitude(value: number): boolean {\n    return Number.isFinite(value) && value >= -180 && value <= 180;\n}\n\n/**\n * Type guard for {@link Coordinate}: an object with finite, in-range\n * `latitude` and `longitude`.\n */\nexport function isCoordinate(value: unknown): value is Coordinate {\n    if (typeof value !== \"object\" || value === null) return false;\n    const candidate = value as Record<string, unknown>;\n    return (\n        typeof candidate.latitude === \"number\" &&\n        typeof candidate.longitude === \"number\" &&\n        isValidLatitude(candidate.latitude) &&\n        isValidLongitude(candidate.longitude)\n    );\n}\n\n/** Clamp a latitude into the valid `[-90, 90]` range. */\nexport function clampLatitude(latitude: number): number {\n    return Math.min(90, Math.max(-90, latitude));\n}\n\n/**\n * Normalize a longitude into the `[-180, 180]` range, wrapping values that\n * cross the antimeridian (e.g. `190` → `-170`).\n */\nexport function normalizeLongitude(longitude: number): number {\n    const wrapped = ((((longitude + 180) % 360) + 360) % 360) - 180;\n    return wrapped;\n}\n"],"mappings":"AA0EA,SAAgB,EAAgB,EAAwB,CACpD,OAAO,OAAO,SAAS,CAAK,GAAK,GAAS,KAAO,GAAS,EAC9D,CAGA,SAAgB,EAAiB,EAAwB,CACrD,OAAO,OAAO,SAAS,CAAK,GAAK,GAAS,MAAQ,GAAS,GAC/D,CAMA,SAAgB,EAAa,EAAqC,CAC9D,GAAI,OAAO,GAAU,WAAY,EAAgB,MAAO,GACxD,IAAM,EAAY,EAClB,OACI,OAAO,EAAU,UAAa,UAC9B,OAAO,EAAU,WAAc,UAC/B,EAAgB,EAAU,QAAQ,GAClC,EAAiB,EAAU,SAAS,CAE5C,CAGA,SAAgB,EAAc,EAA0B,CACpD,OAAO,KAAK,IAAI,GAAI,KAAK,IAAI,IAAK,CAAQ,CAAC,CAC/C,CAMA,SAAgB,EAAmB,EAA2B,CAE1D,QADoB,EAAY,KAAO,IAAO,KAAO,IAAO,GAEhE"}

package/dist/geo/types.js

@@ -1,25 +1,22 @@
-function i(t) {
-  return Number.isFinite(t) && t >= -90 && t <= 90;
+//#region src/geo/types.ts
+function e(e) {
+	return Number.isFinite(e) && e >= -90 && e <= 90;
 }
-function e(t) {
-  return Number.isFinite(t) && t >= -180 && t <= 180;
+function t(e) {
+	return Number.isFinite(e) && e >= -180 && e <= 180;
 }
-function r(t) {
-  if (typeof t != "object" || t === null) return !1;
-  const n = t;
-  return typeof n.latitude == "number" && typeof n.longitude == "number" && i(n.latitude) && e(n.longitude);
+function n(n) {
+	if (typeof n != "object" || !n) return !1;
+	let r = n;
+	return typeof r.latitude == "number" && typeof r.longitude == "number" && e(r.latitude) && t(r.longitude);
 }
-function o(t) {
-  return Math.min(90, Math.max(-90, t));
+function r(e) {
+	return Math.min(90, Math.max(-90, e));
 }
-function u(t) {
-  return ((t + 180) % 360 + 360) % 360 - 180;
+function i(e) {
+	return ((e + 180) % 360 + 360) % 360 - 180;
 }
-export {
-  o as clampLatitude,
-  r as isCoordinate,
-  i as isValidLatitude,
-  e as isValidLongitude,
-  u as normalizeLongitude
-};
-//# sourceMappingURL=types.js.map
+//#endregion
+export { r as clampLatitude, n as isCoordinate, e as isValidLatitude, t as isValidLongitude, i as normalizeLongitude };
+
+//# sourceMappingURL=types.js.map

package/dist/geo/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sources":["../../src/geo/types.ts"],"sourcesContent":["/**\n * WGS84 geographic coordinate. Mirrors the `Coordinate` schema from\n * `tempest-fastapi-sdk` (`geo/schemas.py`) — `latitude` in `[-90, 90]`,\n * `longitude` in `[-180, 180]`, serialized snake_case on the wire.\n */\nexport interface Coordinate {\n    /** WGS84 latitude in degrees, `[-90, 90]`. E.g. `-23.5505`. */\n    latitude: number;\n    /** WGS84 longitude in degrees, `[-180, 180]`. E.g. `-46.6333`. */\n    longitude: number;\n}\n\n/**\n * A pin plotted on a map: a {@link Coordinate} plus optional presentation and\n * an identity used for click callbacks. Shared by `TrajectoryMap` and the\n * Brazil maps' `markers` prop.\n */\nexport interface GeoMarker extends Coordinate {\n    /** Stable identity (returned by click handlers). Falls back to the index. */\n    id?: string;\n    /** Tooltip / accessible label for the pin. */\n    label?: string;\n    /** Fill color. Defaults to the primary token. */\n    color?: string;\n    /** Radius in pixels. Default: 6. */\n    radius?: number;\n}\n\n/**\n * A single sample in a recorded trajectory: a {@link Coordinate} stamped with\n * the epoch millisecond it was captured, plus the optional accuracy radius\n * reported by the Geolocation API.\n */\nexport interface TrackPoint extends Coordinate {\n    /** Capture time in epoch milliseconds (`GeolocationPosition.timestamp`). */\n    timestamp: number;\n    /** Horizontal accuracy radius in meters, if the device reported one. */\n    accuracy?: number;\n}\n\n/**\n * Travel mode. Mirrors the `TravelMode` string enum from `tempest-fastapi-sdk`\n * (`geo/enums.py`) — the on-the-wire value is the raw string.\n */\nexport type TravelMode = \"car\" | \"motorcycle\" | \"bus\";\n\n/**\n * Estimated travel between two coordinates. Mirrors the `TravelEstimate`\n * schema from `tempest-fastapi-sdk` (`geo/schemas.py`), snake_case preserved so\n * a response deserializes straight into this type.\n */\nexport interface TravelEstimate {\n    /** Travel mode the estimate was computed for. */\n    mode: TravelMode;\n    /** Great-circle distance scaled by circuity, in kilometers (`>= 0`). */\n    distance_km: number;\n    /** Estimated duration in minutes (`>= 0`). */\n    duration_minutes: number;\n    /** How the estimate was produced. `\"heuristic\"` (offline) or `\"osrm\"`. */\n    source: \"heuristic\" | \"osrm\";\n}\n\n/**\n * Axis-aligned geographic bounding box. `min`/`max` follow the same degree\n * ranges as {@link Coordinate}.\n */\nexport interface GeoBounds {\n    minLatitude: number;\n    maxLatitude: number;\n    minLongitude: number;\n    maxLongitude: number;\n}\n\n/** True when `value` is a finite latitude in `[-90, 90]`. */\nexport function isValidLatitude(value: number): boolean {\n    return Number.isFinite(value) && value >= -90 && value <= 90;\n}\n\n/** True when `value` is a finite longitude in `[-180, 180]`. */\nexport function isValidLongitude(value: number): boolean {\n    return Number.isFinite(value) && value >= -180 && value <= 180;\n}\n\n/**\n * Type guard for {@link Coordinate}: an object with finite, in-range\n * `latitude` and `longitude`.\n */\nexport function isCoordinate(value: unknown): value is Coordinate {\n    if (typeof value !== \"object\" || value === null) return false;\n    const candidate = value as Record<string, unknown>;\n    return (\n        typeof candidate.latitude === \"number\" &&\n        typeof candidate.longitude === \"number\" &&\n        isValidLatitude(candidate.latitude) &&\n        isValidLongitude(candidate.longitude)\n    );\n}\n\n/** Clamp a latitude into the valid `[-90, 90]` range. */\nexport function clampLatitude(latitude: number): number {\n    return Math.min(90, Math.max(-90, latitude));\n}\n\n/**\n * Normalize a longitude into the `[-180, 180]` range, wrapping values that\n * cross the antimeridian (e.g. `190` → `-170`).\n */\nexport function normalizeLongitude(longitude: number): number {\n    const wrapped = ((((longitude + 180) % 360) + 360) % 360) - 180;\n    return wrapped;\n}\n"],"names":["isValidLatitude","value","isValidLongitude","isCoordinate","candidate","clampLatitude","latitude","normalizeLongitude","longitude"],"mappings":"AA0EO,SAASA,EAAgBC,GAAwB;AACpD,SAAO,OAAO,SAASA,CAAK,KAAKA,KAAS,OAAOA,KAAS;AAC9D;AAGO,SAASC,EAAiBD,GAAwB;AACrD,SAAO,OAAO,SAASA,CAAK,KAAKA,KAAS,QAAQA,KAAS;AAC/D;AAMO,SAASE,EAAaF,GAAqC;AAC9D,MAAI,OAAOA,KAAU,YAAYA,MAAU,KAAM,QAAO;AACxD,QAAMG,IAAYH;AAClB,SACI,OAAOG,EAAU,YAAa,YAC9B,OAAOA,EAAU,aAAc,YAC/BJ,EAAgBI,EAAU,QAAQ,KAClCF,EAAiBE,EAAU,SAAS;AAE5C;AAGO,SAASC,EAAcC,GAA0B;AACpD,SAAO,KAAK,IAAI,IAAI,KAAK,IAAI,KAAKA,CAAQ,CAAC;AAC/C;AAMO,SAASC,EAAmBC,GAA2B;AAE1D,WADoBA,IAAY,OAAO,MAAO,OAAO,MAAO;AAEhE;"}
+{"version":3,"file":"types.js","names":[],"sources":["../../src/geo/types.ts"],"sourcesContent":["/**\n * WGS84 geographic coordinate. Mirrors the `Coordinate` schema from\n * `tempest-fastapi-sdk` (`geo/schemas.py`) — `latitude` in `[-90, 90]`,\n * `longitude` in `[-180, 180]`, serialized snake_case on the wire.\n */\nexport interface Coordinate {\n    /** WGS84 latitude in degrees, `[-90, 90]`. E.g. `-23.5505`. */\n    latitude: number;\n    /** WGS84 longitude in degrees, `[-180, 180]`. E.g. `-46.6333`. */\n    longitude: number;\n}\n\n/**\n * A pin plotted on a map: a {@link Coordinate} plus optional presentation and\n * an identity used for click callbacks. Shared by `TrajectoryMap` and the\n * Brazil maps' `markers` prop.\n */\nexport interface GeoMarker extends Coordinate {\n    /** Stable identity (returned by click handlers). Falls back to the index. */\n    id?: string;\n    /** Tooltip / accessible label for the pin. */\n    label?: string;\n    /** Fill color. Defaults to the primary token. */\n    color?: string;\n    /** Radius in pixels. Default: 6. */\n    radius?: number;\n}\n\n/**\n * A single sample in a recorded trajectory: a {@link Coordinate} stamped with\n * the epoch millisecond it was captured, plus the optional accuracy radius\n * reported by the Geolocation API.\n */\nexport interface TrackPoint extends Coordinate {\n    /** Capture time in epoch milliseconds (`GeolocationPosition.timestamp`). */\n    timestamp: number;\n    /** Horizontal accuracy radius in meters, if the device reported one. */\n    accuracy?: number;\n}\n\n/**\n * Travel mode. Mirrors the `TravelMode` string enum from `tempest-fastapi-sdk`\n * (`geo/enums.py`) — the on-the-wire value is the raw string.\n */\nexport type TravelMode = \"car\" | \"motorcycle\" | \"bus\";\n\n/**\n * Estimated travel between two coordinates. Mirrors the `TravelEstimate`\n * schema from `tempest-fastapi-sdk` (`geo/schemas.py`), snake_case preserved so\n * a response deserializes straight into this type.\n */\nexport interface TravelEstimate {\n    /** Travel mode the estimate was computed for. */\n    mode: TravelMode;\n    /** Great-circle distance scaled by circuity, in kilometers (`>= 0`). */\n    distance_km: number;\n    /** Estimated duration in minutes (`>= 0`). */\n    duration_minutes: number;\n    /** How the estimate was produced. `\"heuristic\"` (offline) or `\"osrm\"`. */\n    source: \"heuristic\" | \"osrm\";\n}\n\n/**\n * Axis-aligned geographic bounding box. `min`/`max` follow the same degree\n * ranges as {@link Coordinate}.\n */\nexport interface GeoBounds {\n    minLatitude: number;\n    maxLatitude: number;\n    minLongitude: number;\n    maxLongitude: number;\n}\n\n/** True when `value` is a finite latitude in `[-90, 90]`. */\nexport function isValidLatitude(value: number): boolean {\n    return Number.isFinite(value) && value >= -90 && value <= 90;\n}\n\n/** True when `value` is a finite longitude in `[-180, 180]`. */\nexport function isValidLongitude(value: number): boolean {\n    return Number.isFinite(value) && value >= -180 && value <= 180;\n}\n\n/**\n * Type guard for {@link Coordinate}: an object with finite, in-range\n * `latitude` and `longitude`.\n */\nexport function isCoordinate(value: unknown): value is Coordinate {\n    if (typeof value !== \"object\" || value === null) return false;\n    const candidate = value as Record<string, unknown>;\n    return (\n        typeof candidate.latitude === \"number\" &&\n        typeof candidate.longitude === \"number\" &&\n        isValidLatitude(candidate.latitude) &&\n        isValidLongitude(candidate.longitude)\n    );\n}\n\n/** Clamp a latitude into the valid `[-90, 90]` range. */\nexport function clampLatitude(latitude: number): number {\n    return Math.min(90, Math.max(-90, latitude));\n}\n\n/**\n * Normalize a longitude into the `[-180, 180]` range, wrapping values that\n * cross the antimeridian (e.g. `190` → `-170`).\n */\nexport function normalizeLongitude(longitude: number): number {\n    const wrapped = ((((longitude + 180) % 360) + 360) % 360) - 180;\n    return wrapped;\n}\n"],"mappings":";AA0EA,SAAgB,EAAgB,GAAwB;CACpD,OAAO,OAAO,SAAS,CAAK,KAAK,KAAS,OAAO,KAAS;AAC9D;AAGA,SAAgB,EAAiB,GAAwB;CACrD,OAAO,OAAO,SAAS,CAAK,KAAK,KAAS,QAAQ,KAAS;AAC/D;AAMA,SAAgB,EAAa,GAAqC;CAC9D,IAAI,OAAO,KAAU,aAAY,GAAgB,OAAO;CACxD,IAAM,IAAY;CAClB,OACI,OAAO,EAAU,YAAa,YAC9B,OAAO,EAAU,aAAc,YAC/B,EAAgB,EAAU,QAAQ,KAClC,EAAiB,EAAU,SAAS;AAE5C;AAGA,SAAgB,EAAc,GAA0B;CACpD,OAAO,KAAK,IAAI,IAAI,KAAK,IAAI,KAAK,CAAQ,CAAC;AAC/C;AAMA,SAAgB,EAAmB,GAA2B;CAE1D,SADoB,IAAY,OAAO,MAAO,OAAO,MAAO;AAEhE"}

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

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("react"),T=require("./create-position-tracker.cjs");function b(i={}){const{autoStart:l=!1,onError:c,...k}=i,[r,f]=t.useState([]),[S,o]=t.useState(0),[a,g]=t.useState("idle"),e=t.useRef(null),u=t.useRef(c);u.current=c,t.useEffect(()=>{const s=T.createPositionTracker({...k,onUpdate:n=>{f([...n]),o(s.distanceKm)},onStatusChange:g,onError:n=>u.current?.(n)});return e.current=s,l&&s.start(),()=>{s.stop(),e.current=null}},[]);const p=t.useCallback(()=>e.current?.start(),[]),P=t.useCallback(()=>e.current?.stop(),[]),d=t.useCallback(()=>{e.current?.clear(),o(0)},[]);return{points:r,lastPoint:r.length>0?r[r.length-1]:null,distanceKm:S,status:a,isTracking:a==="tracking",start:p,stop:P,clear:d}}exports.usePositionTracker=b;
-//# sourceMappingURL=use-position-tracker.cjs.map
+const e=require("./create-position-tracker.cjs");let t=require("react");function n(n={}){let{autoStart:r=!1,onError:i,...a}=n,[o,s]=(0,t.useState)([]),[c,l]=(0,t.useState)(0),[u,d]=(0,t.useState)(`idle`),f=(0,t.useRef)(null),p=(0,t.useRef)(i);p.current=i,(0,t.useEffect)(()=>{let t=e.createPositionTracker({...a,onUpdate:e=>{s([...e]),l(t.distanceKm)},onStatusChange:d,onError:e=>p.current?.(e)});return f.current=t,r&&t.start(),()=>{t.stop(),f.current=null}},[]);let m=(0,t.useCallback)(()=>f.current?.start(),[]),h=(0,t.useCallback)(()=>f.current?.stop(),[]),g=(0,t.useCallback)(()=>{f.current?.clear(),l(0)},[]);return{points:o,lastPoint:o.length>0?o[o.length-1]:null,distanceKm:c,status:u,isTracking:u===`tracking`,start:m,stop:h,clear:g}}exports.usePositionTracker=n;
+//# sourceMappingURL=use-position-tracker.cjs.map