tempest-react-sdk 0.22.0 → 0.23.0

package/dist/geo/estimate.js.map

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

package/dist/geo/leaflet-map.cjs

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

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

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

package/dist/geo/leaflet-map.js

@@ -0,0 +1,51 @@
+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%" } });
+}
+export {
+  j as LeafletTrajectory
+};
+//# sourceMappingURL=leaflet-map.js.map

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

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

package/dist/geo/projection.cjs

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

package/dist/geo/projection.cjs.map

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

package/dist/geo/projection.js

@@ -0,0 +1,36 @@
+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 };
+}
+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 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 };
+}
+export {
+  d as MERCATOR_MAX_LATITUDE,
+  P as fitProjection,
+  r as projectMercator,
+  I as unprojectMercator
+};
+//# sourceMappingURL=projection.js.map

package/dist/geo/projection.js.map

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

package/dist/geo/routing.cjs

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

package/dist/geo/routing.cjs.map

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

package/dist/geo/routing.js

@@ -0,0 +1,29 @@
+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"
+      };
+    }
+  };
+}
+export {
+  g as createOSRMBackend
+};
+//# sourceMappingURL=routing.js.map

package/dist/geo/routing.js.map

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

package/dist/geo/types.cjs

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

package/dist/geo/types.cjs.map

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

package/dist/geo/types.js

@@ -0,0 +1,25 @@
+function i(t) {
+  return Number.isFinite(t) && t >= -90 && t <= 90;
+}
+function e(t) {
+  return Number.isFinite(t) && t >= -180 && t <= 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 o(t) {
+  return Math.min(90, Math.max(-90, t));
+}
+function u(t) {
+  return ((t + 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

package/dist/geo/types.js.map

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-position-tracker.cjs","sources":["../../src/geo/use-position-tracker.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport {\n    createPositionTracker,\n    type CreatePositionTrackerOptions,\n    type PositionTracker,\n    type TrackerStatus,\n} from \"./create-position-tracker\";\nimport type { TrackPoint } from \"./types\";\n\nexport interface UsePositionTrackerOptions extends Omit<\n    CreatePositionTrackerOptions,\n    \"onUpdate\" | \"onStatusChange\"\n> {\n    /** Start tracking automatically on mount. Default: `false`. */\n    autoStart?: boolean;\n}\n\nexport interface UsePositionTrackerResult {\n    /** Recorded trajectory (newest last). */\n    points: readonly TrackPoint[];\n    /** Most recent point, or `null` before the first fix. */\n    lastPoint: TrackPoint | null;\n    /** Total distance of the trajectory in kilometers. */\n    distanceKm: number;\n    /** Current tracker status. */\n    status: TrackerStatus;\n    /** True while `status === \"tracking\"`. */\n    isTracking: boolean;\n    /** Begin watching position. */\n    start: () => void;\n    /** Stop watching, keeping the trajectory. */\n    stop: () => void;\n    /** Stop and discard the trajectory. */\n    clear: () => void;\n}\n\n/**\n * React hook wrapping {@link createPositionTracker}. Records a live GPS\n * trajectory tied to the component lifecycle — the watch is torn down on\n * unmount. Fully browser-side; no external service.\n *\n * @example\n * const { points, distanceKm, isTracking, start, stop } = usePositionTracker({\n *   minDistanceKm: 0.01,\n * });\n * return (\n *   <>\n *     <button onClick={isTracking ? stop : start}>{isTracking ? \"Parar\" : \"Rastrear\"}</button>\n *     <TrajectoryMap points={points} />\n *     <span>{distanceKm.toFixed(2)} km</span>\n *   </>\n * );\n */\nexport function usePositionTracker(\n    options: UsePositionTrackerOptions = {},\n): UsePositionTrackerResult {\n    const { autoStart = false, onError, ...trackerOptions } = options;\n\n    const [points, setPoints] = useState<readonly TrackPoint[]>([]);\n    const [distanceKm, setDistanceKm] = useState<number>(0);\n    const [status, setStatus] = useState<TrackerStatus>(\"idle\");\n\n    const trackerRef = useRef<PositionTracker | null>(null);\n    const onErrorRef = useRef(onError);\n    onErrorRef.current = onError;\n\n    useEffect(() => {\n        const tracker = createPositionTracker({\n            ...trackerOptions,\n            onUpdate: (next) => {\n                setPoints([...next]);\n                setDistanceKm(tracker.distanceKm);\n            },\n            onStatusChange: setStatus,\n            onError: (error) => onErrorRef.current?.(error),\n        });\n        trackerRef.current = tracker;\n        if (autoStart) tracker.start();\n\n        return () => {\n            tracker.stop();\n            trackerRef.current = null;\n        };\n        // Tracker options are read once at creation; changing them mid-track\n        // would drop the recorded trajectory, so they are intentionally omitted.\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, []);\n\n    const start = useCallback((): void => trackerRef.current?.start(), []);\n    const stop = useCallback((): void => trackerRef.current?.stop(), []);\n    const clear = useCallback((): void => {\n        trackerRef.current?.clear();\n        setDistanceKm(0);\n    }, []);\n\n    return {\n        points,\n        lastPoint: points.length > 0 ? points[points.length - 1] : null,\n        distanceKm,\n        status,\n        isTracking: status === \"tracking\",\n        start,\n        stop,\n        clear,\n    };\n}\n"],"names":["usePositionTracker","options","autoStart","onError","trackerOptions","points","setPoints","useState","distanceKm","setDistanceKm","status","setStatus","trackerRef","useRef","onErrorRef","useEffect","tracker","createPositionTracker","next","error","start","useCallback","stop","clear"],"mappings":"oJAqDO,SAASA,EACZC,EAAqC,GACb,CACxB,KAAM,CAAE,UAAAC,EAAY,GAAO,QAAAC,EAAS,GAAGC,GAAmBH,EAEpD,CAACI,EAAQC,CAAS,EAAIC,EAAAA,SAAgC,CAAA,CAAE,EACxD,CAACC,EAAYC,CAAa,EAAIF,EAAAA,SAAiB,CAAC,EAChD,CAACG,EAAQC,CAAS,EAAIJ,EAAAA,SAAwB,MAAM,EAEpDK,EAAaC,EAAAA,OAA+B,IAAI,EAChDC,EAAaD,EAAAA,OAAOV,CAAO,EACjCW,EAAW,QAAUX,EAErBY,EAAAA,UAAU,IAAM,CACZ,MAAMC,EAAUC,EAAAA,sBAAsB,CAClC,GAAGb,EACH,SAAWc,GAAS,CAChBZ,EAAU,CAAC,GAAGY,CAAI,CAAC,EACnBT,EAAcO,EAAQ,UAAU,CACpC,EACA,eAAgBL,EAChB,QAAUQ,GAAUL,EAAW,UAAUK,CAAK,CAAA,CACjD,EACD,OAAAP,EAAW,QAAUI,EACjBd,KAAmB,MAAA,EAEhB,IAAM,CACTc,EAAQ,KAAA,EACRJ,EAAW,QAAU,IACzB,CAIJ,EAAG,CAAA,CAAE,EAEL,MAAMQ,EAAQC,EAAAA,YAAY,IAAYT,EAAW,SAAS,MAAA,EAAS,EAAE,EAC/DU,EAAOD,EAAAA,YAAY,IAAYT,EAAW,SAAS,KAAA,EAAQ,EAAE,EAC7DW,EAAQF,EAAAA,YAAY,IAAY,CAClCT,EAAW,SAAS,MAAA,EACpBH,EAAc,CAAC,CACnB,EAAG,CAAA,CAAE,EAEL,MAAO,CACH,OAAAJ,EACA,UAAWA,EAAO,OAAS,EAAIA,EAAOA,EAAO,OAAS,CAAC,EAAI,KAC3D,WAAAG,EACA,OAAAE,EACA,WAAYA,IAAW,WACvB,MAAAU,EACA,KAAAE,EACA,MAAAC,CAAA,CAER"}

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

@@ -0,0 +1,35 @@
+import { useState as s, useRef as l, useEffect as h, useCallback as o } from "react";
+import { createPositionTracker as K } from "./create-position-tracker.js";
+function C(f = {}) {
+  const { autoStart: p = !1, onError: c, ...k } = f, [r, m] = s([]), [g, a] = s(0), [u, d] = s("idle"), t = l(null), i = l(c);
+  i.current = c, h(() => {
+    const n = K({
+      ...k,
+      onUpdate: (e) => {
+        m([...e]), a(n.distanceKm);
+      },
+      onStatusChange: d,
+      onError: (e) => i.current?.(e)
+    });
+    return t.current = n, p && n.start(), () => {
+      n.stop(), t.current = null;
+    };
+  }, []);
+  const E = o(() => t.current?.start(), []), P = o(() => t.current?.stop(), []), S = o(() => {
+    t.current?.clear(), a(0);
+  }, []);
+  return {
+    points: r,
+    lastPoint: r.length > 0 ? r[r.length - 1] : null,
+    distanceKm: g,
+    status: u,
+    isTracking: u === "tracking",
+    start: E,
+    stop: P,
+    clear: S
+  };
+}
+export {
+  C as usePositionTracker
+};
+//# sourceMappingURL=use-position-tracker.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-position-tracker.js","sources":["../../src/geo/use-position-tracker.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport {\n    createPositionTracker,\n    type CreatePositionTrackerOptions,\n    type PositionTracker,\n    type TrackerStatus,\n} from \"./create-position-tracker\";\nimport type { TrackPoint } from \"./types\";\n\nexport interface UsePositionTrackerOptions extends Omit<\n    CreatePositionTrackerOptions,\n    \"onUpdate\" | \"onStatusChange\"\n> {\n    /** Start tracking automatically on mount. Default: `false`. */\n    autoStart?: boolean;\n}\n\nexport interface UsePositionTrackerResult {\n    /** Recorded trajectory (newest last). */\n    points: readonly TrackPoint[];\n    /** Most recent point, or `null` before the first fix. */\n    lastPoint: TrackPoint | null;\n    /** Total distance of the trajectory in kilometers. */\n    distanceKm: number;\n    /** Current tracker status. */\n    status: TrackerStatus;\n    /** True while `status === \"tracking\"`. */\n    isTracking: boolean;\n    /** Begin watching position. */\n    start: () => void;\n    /** Stop watching, keeping the trajectory. */\n    stop: () => void;\n    /** Stop and discard the trajectory. */\n    clear: () => void;\n}\n\n/**\n * React hook wrapping {@link createPositionTracker}. Records a live GPS\n * trajectory tied to the component lifecycle — the watch is torn down on\n * unmount. Fully browser-side; no external service.\n *\n * @example\n * const { points, distanceKm, isTracking, start, stop } = usePositionTracker({\n *   minDistanceKm: 0.01,\n * });\n * return (\n *   <>\n *     <button onClick={isTracking ? stop : start}>{isTracking ? \"Parar\" : \"Rastrear\"}</button>\n *     <TrajectoryMap points={points} />\n *     <span>{distanceKm.toFixed(2)} km</span>\n *   </>\n * );\n */\nexport function usePositionTracker(\n    options: UsePositionTrackerOptions = {},\n): UsePositionTrackerResult {\n    const { autoStart = false, onError, ...trackerOptions } = options;\n\n    const [points, setPoints] = useState<readonly TrackPoint[]>([]);\n    const [distanceKm, setDistanceKm] = useState<number>(0);\n    const [status, setStatus] = useState<TrackerStatus>(\"idle\");\n\n    const trackerRef = useRef<PositionTracker | null>(null);\n    const onErrorRef = useRef(onError);\n    onErrorRef.current = onError;\n\n    useEffect(() => {\n        const tracker = createPositionTracker({\n            ...trackerOptions,\n            onUpdate: (next) => {\n                setPoints([...next]);\n                setDistanceKm(tracker.distanceKm);\n            },\n            onStatusChange: setStatus,\n            onError: (error) => onErrorRef.current?.(error),\n        });\n        trackerRef.current = tracker;\n        if (autoStart) tracker.start();\n\n        return () => {\n            tracker.stop();\n            trackerRef.current = null;\n        };\n        // Tracker options are read once at creation; changing them mid-track\n        // would drop the recorded trajectory, so they are intentionally omitted.\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, []);\n\n    const start = useCallback((): void => trackerRef.current?.start(), []);\n    const stop = useCallback((): void => trackerRef.current?.stop(), []);\n    const clear = useCallback((): void => {\n        trackerRef.current?.clear();\n        setDistanceKm(0);\n    }, []);\n\n    return {\n        points,\n        lastPoint: points.length > 0 ? points[points.length - 1] : null,\n        distanceKm,\n        status,\n        isTracking: status === \"tracking\",\n        start,\n        stop,\n        clear,\n    };\n}\n"],"names":["usePositionTracker","options","autoStart","onError","trackerOptions","points","setPoints","useState","distanceKm","setDistanceKm","status","setStatus","trackerRef","useRef","onErrorRef","useEffect","tracker","createPositionTracker","next","error","start","useCallback","stop","clear"],"mappings":";;AAqDO,SAASA,EACZC,IAAqC,IACb;AACxB,QAAM,EAAE,WAAAC,IAAY,IAAO,SAAAC,GAAS,GAAGC,MAAmBH,GAEpD,CAACI,GAAQC,CAAS,IAAIC,EAAgC,CAAA,CAAE,GACxD,CAACC,GAAYC,CAAa,IAAIF,EAAiB,CAAC,GAChD,CAACG,GAAQC,CAAS,IAAIJ,EAAwB,MAAM,GAEpDK,IAAaC,EAA+B,IAAI,GAChDC,IAAaD,EAAOV,CAAO;AACjC,EAAAW,EAAW,UAAUX,GAErBY,EAAU,MAAM;AACZ,UAAMC,IAAUC,EAAsB;AAAA,MAClC,GAAGb;AAAA,MACH,UAAU,CAACc,MAAS;AAChB,QAAAZ,EAAU,CAAC,GAAGY,CAAI,CAAC,GACnBT,EAAcO,EAAQ,UAAU;AAAA,MACpC;AAAA,MACA,gBAAgBL;AAAA,MAChB,SAAS,CAACQ,MAAUL,EAAW,UAAUK,CAAK;AAAA,IAAA,CACjD;AACD,WAAAP,EAAW,UAAUI,GACjBd,OAAmB,MAAA,GAEhB,MAAM;AACT,MAAAc,EAAQ,KAAA,GACRJ,EAAW,UAAU;AAAA,IACzB;AAAA,EAIJ,GAAG,CAAA,CAAE;AAEL,QAAMQ,IAAQC,EAAY,MAAYT,EAAW,SAAS,MAAA,GAAS,EAAE,GAC/DU,IAAOD,EAAY,MAAYT,EAAW,SAAS,KAAA,GAAQ,EAAE,GAC7DW,IAAQF,EAAY,MAAY;AAClC,IAAAT,EAAW,SAAS,MAAA,GACpBH,EAAc,CAAC;AAAA,EACnB,GAAG,CAAA,CAAE;AAEL,SAAO;AAAA,IACH,QAAAJ;AAAA,IACA,WAAWA,EAAO,SAAS,IAAIA,EAAOA,EAAO,SAAS,CAAC,IAAI;AAAA,IAC3D,YAAAG;AAAA,IACA,QAAAE;AAAA,IACA,YAAYA,MAAW;AAAA,IACvB,OAAAU;AAAA,IACA,MAAAE;AAAA,IACA,OAAAC;AAAA,EAAA;AAER;"}

package/dist/hooks/pwa-env.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function o(){if(typeof navigator>"u")return!1;const n=navigator.userAgent;return/iPad|iPhone|iPod/.test(n)?!0:n.includes("Mac")&&navigator.maxTouchPoints>1}function r(){if(typeof navigator>"u")return!1;const n=navigator.userAgent;return/Android/i.test(n)?/MiuiBrowser|XiaoMi|UCBrowser|Opera Mini|KAIOS|HuaweiBrowser/i.test(n):!1}function t(){return typeof navigator>"u"?!1:/Android/i.test(navigator.userAgent)}function a(){if(typeof window>"u"||!t())return null;const n=window.location.host,e=window.location.pathname+window.location.search,i=encodeURIComponent("https://play.google.com/store/apps/details?id=com.android.chrome");return`intent://${n}${e}#Intent;scheme=https;package=com.android.chrome;S.browser_fallback_url=${i};end`}function d(){return typeof window>"u"?!1:window.matchMedia?.("(display-mode: standalone)")?.matches?!0:window.navigator.standalone===!0}exports.buildOpenInChromeIntent=a;exports.isAndroid=t;exports.isAndroidWithoutPromptApi=r;exports.isIOS=o;exports.isStandalone=d;
+//# sourceMappingURL=pwa-env.cjs.map

package/dist/hooks/pwa-env.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pwa-env.cjs","sources":["../../src/hooks/pwa-env.ts"],"sourcesContent":["/**\n * The Chromium-only `beforeinstallprompt` event. iOS Safari never fires it —\n * for those users the app falls back to manual \"Add to Home Screen\"\n * instructions. Ported into the SDK so consumers get the type without a global\n * augmentation.\n */\nexport interface BeforeInstallPromptEvent extends Event {\n    /** Platforms the prompt can target (e.g. `[\"web\", \"android\"]`). */\n    readonly platforms: readonly string[];\n    /** Resolves once the user accepts or dismisses the prompt. */\n    readonly userChoice: Promise<{\n        outcome: \"accepted\" | \"dismissed\";\n        platform: string;\n    }>;\n    /** Shows the native install prompt. */\n    prompt: () => Promise<void>;\n}\n\n/**\n * Detects iOS / iPadOS Safari, including modern iPads that report `MacIntel`\n * plus multi-touch instead of an `iPad` user agent.\n *\n * @returns `true` when running on iOS/iPadOS.\n */\nexport function isIOS(): boolean {\n    if (typeof navigator === \"undefined\") return false;\n    const ua = navigator.userAgent;\n    if (/iPad|iPhone|iPod/.test(ua)) return true;\n    return ua.includes(\"Mac\") && navigator.maxTouchPoints > 1;\n}\n\n/**\n * Detects Android browsers that ship a Chromium fork with the\n * `beforeinstallprompt` event stripped or unreliable. Those users must install\n * via the browser menu manually, identical to iOS Safari.\n *\n * @returns `true` when running on such an Android browser.\n */\nexport function isAndroidWithoutPromptApi(): boolean {\n    if (typeof navigator === \"undefined\") return false;\n    const ua = navigator.userAgent;\n    if (!/Android/i.test(ua)) return false;\n    return /MiuiBrowser|XiaoMi|UCBrowser|Opera Mini|KAIOS|HuaweiBrowser/i.test(ua);\n}\n\n/**\n * Detects any Android browser.\n *\n * @returns `true` when the user agent reports Android.\n */\nexport function isAndroid(): boolean {\n    if (typeof navigator === \"undefined\") return false;\n    return /Android/i.test(navigator.userAgent);\n}\n\n/**\n * Builds an `intent://` URL that re-opens the current page inside Chrome on\n * Android. When Chrome is missing, the fallback URL points to the Play Store so\n * the user can still recover. Returns `null` outside Android.\n *\n * @returns The `intent://` URL, or `null` when not on Android or without a DOM.\n * @see https://developer.chrome.com/docs/multidevice/android/intents\n */\nexport function buildOpenInChromeIntent(): string | null {\n    if (typeof window === \"undefined\") return null;\n    if (!isAndroid()) return null;\n    const host = window.location.host;\n    const path = window.location.pathname + window.location.search;\n    const fallback = encodeURIComponent(\n        \"https://play.google.com/store/apps/details?id=com.android.chrome\",\n    );\n    return `intent://${host}${path}#Intent;scheme=https;package=com.android.chrome;S.browser_fallback_url=${fallback};end`;\n}\n\n/**\n * Reports whether the app is running as an installed PWA (Android Chrome, iOS,\n * or desktop). Use it to suppress install CTAs once the user is already in the\n * standalone shell.\n *\n * @returns `true` when the display mode is standalone or iOS reports standalone.\n */\nexport function isStandalone(): boolean {\n    if (typeof window === \"undefined\") return false;\n    if (window.matchMedia?.(\"(display-mode: standalone)\")?.matches) return true;\n    return (window.navigator as Navigator & { standalone?: boolean }).standalone === true;\n}\n"],"names":["isIOS","ua","isAndroidWithoutPromptApi","isAndroid","buildOpenInChromeIntent","host","path","fallback","isStandalone"],"mappings":"gFAwBO,SAASA,GAAiB,CAC7B,GAAI,OAAO,UAAc,IAAa,MAAO,GAC7C,MAAMC,EAAK,UAAU,UACrB,MAAI,mBAAmB,KAAKA,CAAE,EAAU,GACjCA,EAAG,SAAS,KAAK,GAAK,UAAU,eAAiB,CAC5D,CASO,SAASC,GAAqC,CACjD,GAAI,OAAO,UAAc,IAAa,MAAO,GAC7C,MAAMD,EAAK,UAAU,UACrB,MAAK,WAAW,KAAKA,CAAE,EAChB,+DAA+D,KAAKA,CAAE,EAD5C,EAErC,CAOO,SAASE,GAAqB,CACjC,OAAI,OAAO,UAAc,IAAoB,GACtC,WAAW,KAAK,UAAU,SAAS,CAC9C,CAUO,SAASC,GAAyC,CAErD,GADI,OAAO,OAAW,KAClB,CAACD,EAAA,EAAa,OAAO,KACzB,MAAME,EAAO,OAAO,SAAS,KACvBC,EAAO,OAAO,SAAS,SAAW,OAAO,SAAS,OAClDC,EAAW,mBACb,kEAAA,EAEJ,MAAO,YAAYF,CAAI,GAAGC,CAAI,0EAA0EC,CAAQ,MACpH,CASO,SAASC,GAAwB,CACpC,OAAI,OAAO,OAAW,IAAoB,GACtC,OAAO,aAAa,4BAA4B,GAAG,QAAgB,GAC/D,OAAO,UAAmD,aAAe,EACrF"}

package/dist/hooks/pwa-env.js

@@ -0,0 +1,31 @@
+function i() {
+  if (typeof navigator > "u") return !1;
+  const n = navigator.userAgent;
+  return /iPad|iPhone|iPod/.test(n) ? !0 : n.includes("Mac") && navigator.maxTouchPoints > 1;
+}
+function r() {
+  if (typeof navigator > "u") return !1;
+  const n = navigator.userAgent;
+  return /Android/i.test(n) ? /MiuiBrowser|XiaoMi|UCBrowser|Opera Mini|KAIOS|HuaweiBrowser/i.test(n) : !1;
+}
+function o() {
+  return typeof navigator > "u" ? !1 : /Android/i.test(navigator.userAgent);
+}
+function a() {
+  if (typeof window > "u" || !o()) return null;
+  const n = window.location.host, e = window.location.pathname + window.location.search, t = encodeURIComponent(
+    "https://play.google.com/store/apps/details?id=com.android.chrome"
+  );
+  return `intent://${n}${e}#Intent;scheme=https;package=com.android.chrome;S.browser_fallback_url=${t};end`;
+}
+function d() {
+  return typeof window > "u" ? !1 : window.matchMedia?.("(display-mode: standalone)")?.matches ? !0 : window.navigator.standalone === !0;
+}
+export {
+  a as buildOpenInChromeIntent,
+  o as isAndroid,
+  r as isAndroidWithoutPromptApi,
+  i as isIOS,
+  d as isStandalone
+};
+//# sourceMappingURL=pwa-env.js.map

package/dist/hooks/pwa-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pwa-env.js","sources":["../../src/hooks/pwa-env.ts"],"sourcesContent":["/**\n * The Chromium-only `beforeinstallprompt` event. iOS Safari never fires it —\n * for those users the app falls back to manual \"Add to Home Screen\"\n * instructions. Ported into the SDK so consumers get the type without a global\n * augmentation.\n */\nexport interface BeforeInstallPromptEvent extends Event {\n    /** Platforms the prompt can target (e.g. `[\"web\", \"android\"]`). */\n    readonly platforms: readonly string[];\n    /** Resolves once the user accepts or dismisses the prompt. */\n    readonly userChoice: Promise<{\n        outcome: \"accepted\" | \"dismissed\";\n        platform: string;\n    }>;\n    /** Shows the native install prompt. */\n    prompt: () => Promise<void>;\n}\n\n/**\n * Detects iOS / iPadOS Safari, including modern iPads that report `MacIntel`\n * plus multi-touch instead of an `iPad` user agent.\n *\n * @returns `true` when running on iOS/iPadOS.\n */\nexport function isIOS(): boolean {\n    if (typeof navigator === \"undefined\") return false;\n    const ua = navigator.userAgent;\n    if (/iPad|iPhone|iPod/.test(ua)) return true;\n    return ua.includes(\"Mac\") && navigator.maxTouchPoints > 1;\n}\n\n/**\n * Detects Android browsers that ship a Chromium fork with the\n * `beforeinstallprompt` event stripped or unreliable. Those users must install\n * via the browser menu manually, identical to iOS Safari.\n *\n * @returns `true` when running on such an Android browser.\n */\nexport function isAndroidWithoutPromptApi(): boolean {\n    if (typeof navigator === \"undefined\") return false;\n    const ua = navigator.userAgent;\n    if (!/Android/i.test(ua)) return false;\n    return /MiuiBrowser|XiaoMi|UCBrowser|Opera Mini|KAIOS|HuaweiBrowser/i.test(ua);\n}\n\n/**\n * Detects any Android browser.\n *\n * @returns `true` when the user agent reports Android.\n */\nexport function isAndroid(): boolean {\n    if (typeof navigator === \"undefined\") return false;\n    return /Android/i.test(navigator.userAgent);\n}\n\n/**\n * Builds an `intent://` URL that re-opens the current page inside Chrome on\n * Android. When Chrome is missing, the fallback URL points to the Play Store so\n * the user can still recover. Returns `null` outside Android.\n *\n * @returns The `intent://` URL, or `null` when not on Android or without a DOM.\n * @see https://developer.chrome.com/docs/multidevice/android/intents\n */\nexport function buildOpenInChromeIntent(): string | null {\n    if (typeof window === \"undefined\") return null;\n    if (!isAndroid()) return null;\n    const host = window.location.host;\n    const path = window.location.pathname + window.location.search;\n    const fallback = encodeURIComponent(\n        \"https://play.google.com/store/apps/details?id=com.android.chrome\",\n    );\n    return `intent://${host}${path}#Intent;scheme=https;package=com.android.chrome;S.browser_fallback_url=${fallback};end`;\n}\n\n/**\n * Reports whether the app is running as an installed PWA (Android Chrome, iOS,\n * or desktop). Use it to suppress install CTAs once the user is already in the\n * standalone shell.\n *\n * @returns `true` when the display mode is standalone or iOS reports standalone.\n */\nexport function isStandalone(): boolean {\n    if (typeof window === \"undefined\") return false;\n    if (window.matchMedia?.(\"(display-mode: standalone)\")?.matches) return true;\n    return (window.navigator as Navigator & { standalone?: boolean }).standalone === true;\n}\n"],"names":["isIOS","ua","isAndroidWithoutPromptApi","isAndroid","buildOpenInChromeIntent","host","path","fallback","isStandalone"],"mappings":"AAwBO,SAASA,IAAiB;AAC7B,MAAI,OAAO,YAAc,IAAa,QAAO;AAC7C,QAAMC,IAAK,UAAU;AACrB,SAAI,mBAAmB,KAAKA,CAAE,IAAU,KACjCA,EAAG,SAAS,KAAK,KAAK,UAAU,iBAAiB;AAC5D;AASO,SAASC,IAAqC;AACjD,MAAI,OAAO,YAAc,IAAa,QAAO;AAC7C,QAAMD,IAAK,UAAU;AACrB,SAAK,WAAW,KAAKA,CAAE,IAChB,+DAA+D,KAAKA,CAAE,IAD5C;AAErC;AAOO,SAASE,IAAqB;AACjC,SAAI,OAAO,YAAc,MAAoB,KACtC,WAAW,KAAK,UAAU,SAAS;AAC9C;AAUO,SAASC,IAAyC;AAErD,MADI,OAAO,SAAW,OAClB,CAACD,EAAA,EAAa,QAAO;AACzB,QAAME,IAAO,OAAO,SAAS,MACvBC,IAAO,OAAO,SAAS,WAAW,OAAO,SAAS,QAClDC,IAAW;AAAA,IACb;AAAA,EAAA;AAEJ,SAAO,YAAYF,CAAI,GAAGC,CAAI,0EAA0EC,CAAQ;AACpH;AASO,SAASC,IAAwB;AACpC,SAAI,OAAO,SAAW,MAAoB,KACtC,OAAO,aAAa,4BAA4B,GAAG,UAAgB,KAC/D,OAAO,UAAmD,eAAe;AACrF;"}

package/dist/hooks/use-async.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("react");function R(a,f=[],l={}){const{immediate:n=!1}=l,[r,s]=t.useState({status:"idle",data:void 0,error:void 0}),o=t.useRef(a);o.current=a;const u=t.useRef(0),c=t.useRef(!0);t.useEffect(()=>(c.current=!0,()=>{c.current=!1}),[]);const i=t.useCallback(async()=>{const d=++u.current;s(e=>({...e,status:"pending",error:void 0}));try{const e=await o.current();return c.current&&u.current===d&&s({status:"success",data:e,error:void 0}),e}catch(e){throw c.current&&u.current===d&&s({status:"error",data:void 0,error:e}),e}},[]),v=t.useCallback(()=>{u.current++,s({status:"idle",data:void 0,error:void 0})},[]);return t.useEffect(()=>{n&&i().catch(()=>{})},[n,...f]),{status:r.status,data:r.data,error:r.error,isPending:r.status==="pending",isSuccess:r.status==="success",isError:r.status==="error",run:i,reset:v}}exports.useAsync=R;
+//# sourceMappingURL=use-async.cjs.map

package/dist/hooks/use-async.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-async.cjs","sources":["../../src/hooks/use-async.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\n\nexport type AsyncStatus = \"idle\" | \"pending\" | \"success\" | \"error\";\n\nexport interface UseAsyncResult<T> {\n    status: AsyncStatus;\n    data: T | undefined;\n    error: unknown;\n    isPending: boolean;\n    isSuccess: boolean;\n    isError: boolean;\n    /** Trigger the async function. Resolves with the new data or rejects. */\n    run: () => Promise<T>;\n    /** Reset state back to idle. */\n    reset: () => void;\n}\n\n/**\n * Run an async function and track its `idle/pending/success/error` state.\n *\n * - Discards results from stale runs (race-condition safe).\n * - `immediate` (default `false`) triggers the function on mount and when\n *   `deps` change. With `false`, call `run()` manually.\n * - Returns a stable object so callers can destructure or pass around safely.\n *\n * For server data with caching, prefer React Query — `useAsync` is the\n * minimal one-shot primitive without dependencies.\n */\nexport function useAsync<T>(\n    asyncFn: () => Promise<T>,\n    deps: ReadonlyArray<unknown> = [],\n    options: { immediate?: boolean } = {},\n): UseAsyncResult<T> {\n    const { immediate = false } = options;\n    const [state, setState] = useState<{\n        status: AsyncStatus;\n        data: T | undefined;\n        error: unknown;\n    }>({ status: \"idle\", data: undefined, error: undefined });\n\n    const fnRef = useRef(asyncFn);\n    fnRef.current = asyncFn;\n    const callIdRef = useRef<number>(0);\n    const mountedRef = useRef<boolean>(true);\n\n    useEffect(() => {\n        mountedRef.current = true;\n        return () => {\n            mountedRef.current = false;\n        };\n    }, []);\n\n    const run = useCallback(async (): Promise<T> => {\n        const callId = ++callIdRef.current;\n        setState((current) => ({ ...current, status: \"pending\", error: undefined }));\n        try {\n            const data = await fnRef.current();\n            if (mountedRef.current && callIdRef.current === callId) {\n                setState({ status: \"success\", data, error: undefined });\n            }\n            return data;\n        } catch (error) {\n            if (mountedRef.current && callIdRef.current === callId) {\n                setState({ status: \"error\", data: undefined, error });\n            }\n            throw error;\n        }\n    }, []);\n\n    const reset = useCallback((): void => {\n        callIdRef.current++;\n        setState({ status: \"idle\", data: undefined, error: undefined });\n    }, []);\n\n    useEffect(() => {\n        if (!immediate) return;\n        run().catch(() => {\n            /* error already captured in state */\n        });\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [immediate, ...deps]);\n\n    return {\n        status: state.status,\n        data: state.data,\n        error: state.error,\n        isPending: state.status === \"pending\",\n        isSuccess: state.status === \"success\",\n        isError: state.status === \"error\",\n        run,\n        reset,\n    };\n}\n"],"names":["useAsync","asyncFn","deps","options","immediate","state","setState","useState","fnRef","useRef","callIdRef","mountedRef","useEffect","run","useCallback","callId","current","data","error","reset"],"mappings":"yGA4BO,SAASA,EACZC,EACAC,EAA+B,CAAA,EAC/BC,EAAmC,CAAA,EAClB,CACjB,KAAM,CAAE,UAAAC,EAAY,EAAA,EAAUD,EACxB,CAACE,EAAOC,CAAQ,EAAIC,EAAAA,SAIvB,CAAE,OAAQ,OAAQ,KAAM,OAAW,MAAO,MAAA,CAAW,EAElDC,EAAQC,EAAAA,OAAOR,CAAO,EAC5BO,EAAM,QAAUP,EAChB,MAAMS,EAAYD,EAAAA,OAAe,CAAC,EAC5BE,EAAaF,EAAAA,OAAgB,EAAI,EAEvCG,EAAAA,UAAU,KACND,EAAW,QAAU,GACd,IAAM,CACTA,EAAW,QAAU,EACzB,GACD,CAAA,CAAE,EAEL,MAAME,EAAMC,EAAAA,YAAY,SAAwB,CAC5C,MAAMC,EAAS,EAAEL,EAAU,QAC3BJ,EAAUU,IAAa,CAAE,GAAGA,EAAS,OAAQ,UAAW,MAAO,MAAA,EAAY,EAC3E,GAAI,CACA,MAAMC,EAAO,MAAMT,EAAM,QAAA,EACzB,OAAIG,EAAW,SAAWD,EAAU,UAAYK,GAC5CT,EAAS,CAAE,OAAQ,UAAW,KAAAW,EAAM,MAAO,OAAW,EAEnDA,CACX,OAASC,EAAO,CACZ,MAAIP,EAAW,SAAWD,EAAU,UAAYK,GAC5CT,EAAS,CAAE,OAAQ,QAAS,KAAM,OAAW,MAAAY,EAAO,EAElDA,CACV,CACJ,EAAG,CAAA,CAAE,EAECC,EAAQL,EAAAA,YAAY,IAAY,CAClCJ,EAAU,UACVJ,EAAS,CAAE,OAAQ,OAAQ,KAAM,OAAW,MAAO,OAAW,CAClE,EAAG,CAAA,CAAE,EAELM,OAAAA,EAAAA,UAAU,IAAM,CACPR,GACLS,EAAA,EAAM,MAAM,IAAM,CAElB,CAAC,CAEL,EAAG,CAACT,EAAW,GAAGF,CAAI,CAAC,EAEhB,CACH,OAAQG,EAAM,OACd,KAAMA,EAAM,KACZ,MAAOA,EAAM,MACb,UAAWA,EAAM,SAAW,UAC5B,UAAWA,EAAM,SAAW,UAC5B,QAASA,EAAM,SAAW,QAC1B,IAAAQ,EACA,MAAAM,CAAA,CAER"}

package/dist/hooks/use-async.js

@@ -0,0 +1,38 @@
+import { useState as R, useRef as a, useEffect as f, useCallback as l } from "react";
+function h(c, v = [], m = {}) {
+  const { immediate: n = !1 } = m, [r, e] = R({ status: "idle", data: void 0, error: void 0 }), o = a(c);
+  o.current = c;
+  const s = a(0), u = a(!0);
+  f(() => (u.current = !0, () => {
+    u.current = !1;
+  }), []);
+  const i = l(async () => {
+    const d = ++s.current;
+    e((t) => ({ ...t, status: "pending", error: void 0 }));
+    try {
+      const t = await o.current();
+      return u.current && s.current === d && e({ status: "success", data: t, error: void 0 }), t;
+    } catch (t) {
+      throw u.current && s.current === d && e({ status: "error", data: void 0, error: t }), t;
+    }
+  }, []), p = l(() => {
+    s.current++, e({ status: "idle", data: void 0, error: void 0 });
+  }, []);
+  return f(() => {
+    n && i().catch(() => {
+    });
+  }, [n, ...v]), {
+    status: r.status,
+    data: r.data,
+    error: r.error,
+    isPending: r.status === "pending",
+    isSuccess: r.status === "success",
+    isError: r.status === "error",
+    run: i,
+    reset: p
+  };
+}
+export {
+  h as useAsync
+};
+//# sourceMappingURL=use-async.js.map

package/dist/hooks/use-async.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-async.js","sources":["../../src/hooks/use-async.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\n\nexport type AsyncStatus = \"idle\" | \"pending\" | \"success\" | \"error\";\n\nexport interface UseAsyncResult<T> {\n    status: AsyncStatus;\n    data: T | undefined;\n    error: unknown;\n    isPending: boolean;\n    isSuccess: boolean;\n    isError: boolean;\n    /** Trigger the async function. Resolves with the new data or rejects. */\n    run: () => Promise<T>;\n    /** Reset state back to idle. */\n    reset: () => void;\n}\n\n/**\n * Run an async function and track its `idle/pending/success/error` state.\n *\n * - Discards results from stale runs (race-condition safe).\n * - `immediate` (default `false`) triggers the function on mount and when\n *   `deps` change. With `false`, call `run()` manually.\n * - Returns a stable object so callers can destructure or pass around safely.\n *\n * For server data with caching, prefer React Query — `useAsync` is the\n * minimal one-shot primitive without dependencies.\n */\nexport function useAsync<T>(\n    asyncFn: () => Promise<T>,\n    deps: ReadonlyArray<unknown> = [],\n    options: { immediate?: boolean } = {},\n): UseAsyncResult<T> {\n    const { immediate = false } = options;\n    const [state, setState] = useState<{\n        status: AsyncStatus;\n        data: T | undefined;\n        error: unknown;\n    }>({ status: \"idle\", data: undefined, error: undefined });\n\n    const fnRef = useRef(asyncFn);\n    fnRef.current = asyncFn;\n    const callIdRef = useRef<number>(0);\n    const mountedRef = useRef<boolean>(true);\n\n    useEffect(() => {\n        mountedRef.current = true;\n        return () => {\n            mountedRef.current = false;\n        };\n    }, []);\n\n    const run = useCallback(async (): Promise<T> => {\n        const callId = ++callIdRef.current;\n        setState((current) => ({ ...current, status: \"pending\", error: undefined }));\n        try {\n            const data = await fnRef.current();\n            if (mountedRef.current && callIdRef.current === callId) {\n                setState({ status: \"success\", data, error: undefined });\n            }\n            return data;\n        } catch (error) {\n            if (mountedRef.current && callIdRef.current === callId) {\n                setState({ status: \"error\", data: undefined, error });\n            }\n            throw error;\n        }\n    }, []);\n\n    const reset = useCallback((): void => {\n        callIdRef.current++;\n        setState({ status: \"idle\", data: undefined, error: undefined });\n    }, []);\n\n    useEffect(() => {\n        if (!immediate) return;\n        run().catch(() => {\n            /* error already captured in state */\n        });\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [immediate, ...deps]);\n\n    return {\n        status: state.status,\n        data: state.data,\n        error: state.error,\n        isPending: state.status === \"pending\",\n        isSuccess: state.status === \"success\",\n        isError: state.status === \"error\",\n        run,\n        reset,\n    };\n}\n"],"names":["useAsync","asyncFn","deps","options","immediate","state","setState","useState","fnRef","useRef","callIdRef","mountedRef","useEffect","run","useCallback","callId","current","data","error","reset"],"mappings":";AA4BO,SAASA,EACZC,GACAC,IAA+B,CAAA,GAC/BC,IAAmC,CAAA,GAClB;AACjB,QAAM,EAAE,WAAAC,IAAY,GAAA,IAAUD,GACxB,CAACE,GAAOC,CAAQ,IAAIC,EAIvB,EAAE,QAAQ,QAAQ,MAAM,QAAW,OAAO,OAAA,CAAW,GAElDC,IAAQC,EAAOR,CAAO;AAC5B,EAAAO,EAAM,UAAUP;AAChB,QAAMS,IAAYD,EAAe,CAAC,GAC5BE,IAAaF,EAAgB,EAAI;AAEvC,EAAAG,EAAU,OACND,EAAW,UAAU,IACd,MAAM;AACT,IAAAA,EAAW,UAAU;AAAA,EACzB,IACD,CAAA,CAAE;AAEL,QAAME,IAAMC,EAAY,YAAwB;AAC5C,UAAMC,IAAS,EAAEL,EAAU;AAC3B,IAAAJ,EAAS,CAACU,OAAa,EAAE,GAAGA,GAAS,QAAQ,WAAW,OAAO,OAAA,EAAY;AAC3E,QAAI;AACA,YAAMC,IAAO,MAAMT,EAAM,QAAA;AACzB,aAAIG,EAAW,WAAWD,EAAU,YAAYK,KAC5CT,EAAS,EAAE,QAAQ,WAAW,MAAAW,GAAM,OAAO,QAAW,GAEnDA;AAAA,IACX,SAASC,GAAO;AACZ,YAAIP,EAAW,WAAWD,EAAU,YAAYK,KAC5CT,EAAS,EAAE,QAAQ,SAAS,MAAM,QAAW,OAAAY,GAAO,GAElDA;AAAA,IACV;AAAA,EACJ,GAAG,CAAA,CAAE,GAECC,IAAQL,EAAY,MAAY;AAClC,IAAAJ,EAAU,WACVJ,EAAS,EAAE,QAAQ,QAAQ,MAAM,QAAW,OAAO,QAAW;AAAA,EAClE,GAAG,CAAA,CAAE;AAEL,SAAAM,EAAU,MAAM;AACZ,IAAKR,KACLS,EAAA,EAAM,MAAM,MAAM;AAAA,IAElB,CAAC;AAAA,EAEL,GAAG,CAACT,GAAW,GAAGF,CAAI,CAAC,GAEhB;AAAA,IACH,QAAQG,EAAM;AAAA,IACd,MAAMA,EAAM;AAAA,IACZ,OAAOA,EAAM;AAAA,IACb,WAAWA,EAAM,WAAW;AAAA,IAC5B,WAAWA,EAAM,WAAW;AAAA,IAC5B,SAASA,EAAM,WAAW;AAAA,IAC1B,KAAAQ;AAAA,IACA,OAAAM;AAAA,EAAA;AAER;"}

package/dist/hooks/use-before-install-prompt.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("react");function c(){if(typeof window>"u")return!1;const t=["standalone","fullscreen","minimal-ui"].some(o=>window.matchMedia?.(`(display-mode: ${o})`)?.matches),s=window.navigator.standalone===!0;return t||s}function m(){const[e,t]=a.useState(null),[s,o]=a.useState(!1),[p,r]=a.useState(c);a.useEffect(()=>{if(typeof window>"u")return;const n=u=>{u.preventDefault(),t(u)},d=()=>{t(null),o(!0),r(!0)},l=window.matchMedia?.("(display-mode: standalone)"),i=()=>r(c());return window.addEventListener("beforeinstallprompt",n),window.addEventListener("appinstalled",d),l?.addEventListener("change",i),()=>{window.removeEventListener("beforeinstallprompt",n),window.removeEventListener("appinstalled",d),l?.removeEventListener("change",i)}},[]);const f=a.useCallback(async()=>{if(!e)return"unsupported";await e.prompt();const n=await e.userChoice;return t(null),n.outcome==="accepted"&&o(!0),n.outcome},[e]);return{installable:!!e,installed:s,isStandalone:p,prompt:f}}exports.useBeforeInstallPrompt=m;
+//# sourceMappingURL=use-before-install-prompt.cjs.map

package/dist/hooks/use-before-install-prompt.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-before-install-prompt.cjs","sources":["../../src/hooks/use-before-install-prompt.ts"],"sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\n\ninterface BeforeInstallPromptEvent extends Event {\n    readonly platforms: readonly string[];\n    readonly userChoice: Promise<{ outcome: \"accepted\" | \"dismissed\"; platform: string }>;\n    prompt(): Promise<void>;\n}\n\nexport interface UseBeforeInstallPromptResult {\n    /** True when the browser fired `beforeinstallprompt` and the user has not yet decided. */\n    installable: boolean;\n    /** True after the user accepts the install prompt. */\n    installed: boolean;\n    /**\n     * True when the app is already running as an installed PWA (display-mode\n     * `standalone`/`fullscreen`/`minimal-ui`, or iOS `navigator.standalone`).\n     * Use it to hide install affordances for users who already installed.\n     */\n    isStandalone: boolean;\n    /** Show the install prompt. Resolves with the user's choice. */\n    prompt: () => Promise<\"accepted\" | \"dismissed\" | \"unsupported\">;\n}\n\n/** Detect whether the document is running inside an installed PWA window. */\nfunction detectStandalone(): boolean {\n    if (typeof window === \"undefined\") return false;\n    const displayModes = [\"standalone\", \"fullscreen\", \"minimal-ui\"];\n    const matchesDisplayMode = displayModes.some(\n        (mode) => window.matchMedia?.(`(display-mode: ${mode})`)?.matches,\n    );\n    // iOS Safari exposes the legacy non-standard `navigator.standalone`.\n    const iosStandalone =\n        (window.navigator as Navigator & { standalone?: boolean }).standalone === true;\n    return matchesDisplayMode || iosStandalone;\n}\n\n/**\n * React hook for the PWA install prompt. Captures the `beforeinstallprompt`\n * event so you can defer the install UI to a moment that fits your UX.\n */\nexport function useBeforeInstallPrompt(): UseBeforeInstallPromptResult {\n    const [deferred, setDeferred] = useState<BeforeInstallPromptEvent | null>(null);\n    const [installed, setInstalled] = useState<boolean>(false);\n    const [isStandalone, setIsStandalone] = useState<boolean>(detectStandalone);\n\n    useEffect(() => {\n        if (typeof window === \"undefined\") return;\n        const handler = (event: Event): void => {\n            event.preventDefault();\n            setDeferred(event as BeforeInstallPromptEvent);\n        };\n        const installedHandler = (): void => {\n            setDeferred(null);\n            setInstalled(true);\n            setIsStandalone(true);\n        };\n        const displayModeQuery = window.matchMedia?.(\"(display-mode: standalone)\");\n        const displayModeHandler = (): void => setIsStandalone(detectStandalone());\n        window.addEventListener(\"beforeinstallprompt\", handler);\n        window.addEventListener(\"appinstalled\", installedHandler);\n        displayModeQuery?.addEventListener(\"change\", displayModeHandler);\n        return () => {\n            window.removeEventListener(\"beforeinstallprompt\", handler);\n            window.removeEventListener(\"appinstalled\", installedHandler);\n            displayModeQuery?.removeEventListener(\"change\", displayModeHandler);\n        };\n    }, []);\n\n    const prompt = useCallback(async (): Promise<\"accepted\" | \"dismissed\" | \"unsupported\"> => {\n        if (!deferred) return \"unsupported\";\n        await deferred.prompt();\n        const result = await deferred.userChoice;\n        setDeferred(null);\n        if (result.outcome === \"accepted\") setInstalled(true);\n        return result.outcome;\n    }, [deferred]);\n\n    return {\n        installable: !!deferred,\n        installed,\n        isStandalone,\n        prompt,\n    };\n}\n"],"names":["detectStandalone","matchesDisplayMode","mode","iosStandalone","useBeforeInstallPrompt","deferred","setDeferred","useState","installed","setInstalled","isStandalone","setIsStandalone","useEffect","handler","event","installedHandler","displayModeQuery","displayModeHandler","prompt","useCallback","result"],"mappings":"yGAwBA,SAASA,GAA4B,CACjC,GAAI,OAAO,OAAW,IAAa,MAAO,GAE1C,MAAMC,EADe,CAAC,aAAc,aAAc,YAAY,EACtB,KACnCC,GAAS,OAAO,aAAa,kBAAkBA,CAAI,GAAG,GAAG,OAAA,EAGxDC,EACD,OAAO,UAAmD,aAAe,GAC9E,OAAOF,GAAsBE,CACjC,CAMO,SAASC,GAAuD,CACnE,KAAM,CAACC,EAAUC,CAAW,EAAIC,EAAAA,SAA0C,IAAI,EACxE,CAACC,EAAWC,CAAY,EAAIF,EAAAA,SAAkB,EAAK,EACnD,CAACG,EAAcC,CAAe,EAAIJ,EAAAA,SAAkBP,CAAgB,EAE1EY,EAAAA,UAAU,IAAM,CACZ,GAAI,OAAO,OAAW,IAAa,OACnC,MAAMC,EAAWC,GAAuB,CACpCA,EAAM,eAAA,EACNR,EAAYQ,CAAiC,CACjD,EACMC,EAAmB,IAAY,CACjCT,EAAY,IAAI,EAChBG,EAAa,EAAI,EACjBE,EAAgB,EAAI,CACxB,EACMK,EAAmB,OAAO,aAAa,4BAA4B,EACnEC,EAAqB,IAAYN,EAAgBX,GAAkB,EACzE,cAAO,iBAAiB,sBAAuBa,CAAO,EACtD,OAAO,iBAAiB,eAAgBE,CAAgB,EACxDC,GAAkB,iBAAiB,SAAUC,CAAkB,EACxD,IAAM,CACT,OAAO,oBAAoB,sBAAuBJ,CAAO,EACzD,OAAO,oBAAoB,eAAgBE,CAAgB,EAC3DC,GAAkB,oBAAoB,SAAUC,CAAkB,CACtE,CACJ,EAAG,CAAA,CAAE,EAEL,MAAMC,EAASC,EAAAA,YAAY,SAA+D,CACtF,GAAI,CAACd,EAAU,MAAO,cACtB,MAAMA,EAAS,OAAA,EACf,MAAMe,EAAS,MAAMf,EAAS,WAC9B,OAAAC,EAAY,IAAI,EACZc,EAAO,UAAY,YAAYX,EAAa,EAAI,EAC7CW,EAAO,OAClB,EAAG,CAACf,CAAQ,CAAC,EAEb,MAAO,CACH,YAAa,CAAC,CAACA,EACf,UAAAG,EACA,aAAAE,EACA,OAAAQ,CAAA,CAER"}

package/dist/hooks/use-before-install-prompt.js

@@ -0,0 +1,38 @@
+import { useState as s, useEffect as m, useCallback as w } from "react";
+function c() {
+  if (typeof window > "u") return !1;
+  const n = ["standalone", "fullscreen", "minimal-ui"].some(
+    (a) => window.matchMedia?.(`(display-mode: ${a})`)?.matches
+  ), o = window.navigator.standalone === !0;
+  return n || o;
+}
+function v() {
+  const [e, n] = s(null), [o, a] = s(!1), [p, d] = s(c);
+  m(() => {
+    if (typeof window > "u") return;
+    const t = (u) => {
+      u.preventDefault(), n(u);
+    }, r = () => {
+      n(null), a(!0), d(!0);
+    }, l = window.matchMedia?.("(display-mode: standalone)"), i = () => d(c());
+    return window.addEventListener("beforeinstallprompt", t), window.addEventListener("appinstalled", r), l?.addEventListener("change", i), () => {
+      window.removeEventListener("beforeinstallprompt", t), window.removeEventListener("appinstalled", r), l?.removeEventListener("change", i);
+    };
+  }, []);
+  const f = w(async () => {
+    if (!e) return "unsupported";
+    await e.prompt();
+    const t = await e.userChoice;
+    return n(null), t.outcome === "accepted" && a(!0), t.outcome;
+  }, [e]);
+  return {
+    installable: !!e,
+    installed: o,
+    isStandalone: p,
+    prompt: f
+  };
+}
+export {
+  v as useBeforeInstallPrompt
+};
+//# sourceMappingURL=use-before-install-prompt.js.map

package/dist/hooks/use-before-install-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-before-install-prompt.js","sources":["../../src/hooks/use-before-install-prompt.ts"],"sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\n\ninterface BeforeInstallPromptEvent extends Event {\n    readonly platforms: readonly string[];\n    readonly userChoice: Promise<{ outcome: \"accepted\" | \"dismissed\"; platform: string }>;\n    prompt(): Promise<void>;\n}\n\nexport interface UseBeforeInstallPromptResult {\n    /** True when the browser fired `beforeinstallprompt` and the user has not yet decided. */\n    installable: boolean;\n    /** True after the user accepts the install prompt. */\n    installed: boolean;\n    /**\n     * True when the app is already running as an installed PWA (display-mode\n     * `standalone`/`fullscreen`/`minimal-ui`, or iOS `navigator.standalone`).\n     * Use it to hide install affordances for users who already installed.\n     */\n    isStandalone: boolean;\n    /** Show the install prompt. Resolves with the user's choice. */\n    prompt: () => Promise<\"accepted\" | \"dismissed\" | \"unsupported\">;\n}\n\n/** Detect whether the document is running inside an installed PWA window. */\nfunction detectStandalone(): boolean {\n    if (typeof window === \"undefined\") return false;\n    const displayModes = [\"standalone\", \"fullscreen\", \"minimal-ui\"];\n    const matchesDisplayMode = displayModes.some(\n        (mode) => window.matchMedia?.(`(display-mode: ${mode})`)?.matches,\n    );\n    // iOS Safari exposes the legacy non-standard `navigator.standalone`.\n    const iosStandalone =\n        (window.navigator as Navigator & { standalone?: boolean }).standalone === true;\n    return matchesDisplayMode || iosStandalone;\n}\n\n/**\n * React hook for the PWA install prompt. Captures the `beforeinstallprompt`\n * event so you can defer the install UI to a moment that fits your UX.\n */\nexport function useBeforeInstallPrompt(): UseBeforeInstallPromptResult {\n    const [deferred, setDeferred] = useState<BeforeInstallPromptEvent | null>(null);\n    const [installed, setInstalled] = useState<boolean>(false);\n    const [isStandalone, setIsStandalone] = useState<boolean>(detectStandalone);\n\n    useEffect(() => {\n        if (typeof window === \"undefined\") return;\n        const handler = (event: Event): void => {\n            event.preventDefault();\n            setDeferred(event as BeforeInstallPromptEvent);\n        };\n        const installedHandler = (): void => {\n            setDeferred(null);\n            setInstalled(true);\n            setIsStandalone(true);\n        };\n        const displayModeQuery = window.matchMedia?.(\"(display-mode: standalone)\");\n        const displayModeHandler = (): void => setIsStandalone(detectStandalone());\n        window.addEventListener(\"beforeinstallprompt\", handler);\n        window.addEventListener(\"appinstalled\", installedHandler);\n        displayModeQuery?.addEventListener(\"change\", displayModeHandler);\n        return () => {\n            window.removeEventListener(\"beforeinstallprompt\", handler);\n            window.removeEventListener(\"appinstalled\", installedHandler);\n            displayModeQuery?.removeEventListener(\"change\", displayModeHandler);\n        };\n    }, []);\n\n    const prompt = useCallback(async (): Promise<\"accepted\" | \"dismissed\" | \"unsupported\"> => {\n        if (!deferred) return \"unsupported\";\n        await deferred.prompt();\n        const result = await deferred.userChoice;\n        setDeferred(null);\n        if (result.outcome === \"accepted\") setInstalled(true);\n        return result.outcome;\n    }, [deferred]);\n\n    return {\n        installable: !!deferred,\n        installed,\n        isStandalone,\n        prompt,\n    };\n}\n"],"names":["detectStandalone","matchesDisplayMode","mode","iosStandalone","useBeforeInstallPrompt","deferred","setDeferred","useState","installed","setInstalled","isStandalone","setIsStandalone","useEffect","handler","event","installedHandler","displayModeQuery","displayModeHandler","prompt","useCallback","result"],"mappings":";AAwBA,SAASA,IAA4B;AACjC,MAAI,OAAO,SAAW,IAAa,QAAO;AAE1C,QAAMC,IADe,CAAC,cAAc,cAAc,YAAY,EACtB;AAAA,IACpC,CAACC,MAAS,OAAO,aAAa,kBAAkBA,CAAI,GAAG,GAAG;AAAA,EAAA,GAGxDC,IACD,OAAO,UAAmD,eAAe;AAC9E,SAAOF,KAAsBE;AACjC;AAMO,SAASC,IAAuD;AACnE,QAAM,CAACC,GAAUC,CAAW,IAAIC,EAA0C,IAAI,GACxE,CAACC,GAAWC,CAAY,IAAIF,EAAkB,EAAK,GACnD,CAACG,GAAcC,CAAe,IAAIJ,EAAkBP,CAAgB;AAE1E,EAAAY,EAAU,MAAM;AACZ,QAAI,OAAO,SAAW,IAAa;AACnC,UAAMC,IAAU,CAACC,MAAuB;AACpC,MAAAA,EAAM,eAAA,GACNR,EAAYQ,CAAiC;AAAA,IACjD,GACMC,IAAmB,MAAY;AACjC,MAAAT,EAAY,IAAI,GAChBG,EAAa,EAAI,GACjBE,EAAgB,EAAI;AAAA,IACxB,GACMK,IAAmB,OAAO,aAAa,4BAA4B,GACnEC,IAAqB,MAAYN,EAAgBX,GAAkB;AACzE,kBAAO,iBAAiB,uBAAuBa,CAAO,GACtD,OAAO,iBAAiB,gBAAgBE,CAAgB,GACxDC,GAAkB,iBAAiB,UAAUC,CAAkB,GACxD,MAAM;AACT,aAAO,oBAAoB,uBAAuBJ,CAAO,GACzD,OAAO,oBAAoB,gBAAgBE,CAAgB,GAC3DC,GAAkB,oBAAoB,UAAUC,CAAkB;AAAA,IACtE;AAAA,EACJ,GAAG,CAAA,CAAE;AAEL,QAAMC,IAASC,EAAY,YAA+D;AACtF,QAAI,CAACd,EAAU,QAAO;AACtB,UAAMA,EAAS,OAAA;AACf,UAAMe,IAAS,MAAMf,EAAS;AAC9B,WAAAC,EAAY,IAAI,GACZc,EAAO,YAAY,cAAYX,EAAa,EAAI,GAC7CW,EAAO;AAAA,EAClB,GAAG,CAACf,CAAQ,CAAC;AAEb,SAAO;AAAA,IACH,aAAa,CAAC,CAACA;AAAA,IACf,WAAAG;AAAA,IACA,cAAAE;AAAA,IACA,QAAAQ;AAAA,EAAA;AAER;"}

package/dist/hooks/use-breakpoint.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const d=require("react"),o={xs:480,sm:640,md:768,lg:1024,xl:1280,"2xl":1536},u=["xs","sm","md","lg","xl","2xl"];function c(t){let n="xs";for(const i of u)t>=o[i]&&(n=i);return n}function l(){const[t,n]=d.useState(()=>typeof window>"u"?0:window.innerWidth);d.useEffect(()=>{if(typeof window>"u")return;const e=()=>n(window.innerWidth);return e(),window.addEventListener("resize",e,{passive:!0}),()=>window.removeEventListener("resize",e)},[]);const i=c(t),r=e=>t>=o[e],s=e=>t<o[e];return{current:i,width:t,above:r,below:s,isMobile:s("md"),isTablet:r("md")&&s("lg"),isDesktop:r("lg")}}exports.BREAKPOINTS=o;exports.useBreakpoint=l;
+//# sourceMappingURL=use-breakpoint.cjs.map