fix(geo-map): load the leaflet engine client-side only

apps/www/components/tool-ui/geo-map/_adapter.tsx

@@ -1,23 +1,14 @@
 /**
  * Adapter: UI and utility re-exports for copy-standalone portability.
  *
+ * This file must stay free of leaflet: the facade imports it, and leaflet
+ * reads `window` at module scope. Map primitives live in `_leaflet-adapter`,
+ * which only client-only modules may import.
+ *
  * When copying this component to another project, update these imports
  * to match your project's paths:
  *
- *   cn      → Your Tailwind merge utility (e.g., "@/lib/utils", "~/lib/cn")
- *   Leaflet → map primitives from react-leaflet
+ *   cn → Your Tailwind merge utility (e.g., "@/lib/utils", "~/lib/cn")
  */
 
 export { cn } from "@/lib/utils";
-export {
-  CircleMarker,
-  MapContainer,
-  Marker,
-  Polyline,
-  Popup,
-  TileLayer,
-  Tooltip,
-  ZoomControl,
-  useMap,
-  useMapEvents,
-} from "react-leaflet";

apps/www/components/tool-ui/geo-map/_leaflet-adapter.tsx

@@ -0,0 +1,25 @@
+/**
+ * Adapter: react-leaflet re-exports for copy-standalone portability.
+ *
+ * Leaflet reads `window` at module scope, so only modules that already live
+ * behind the client-only boundary (the engine and its overlays) may import
+ * from this file. The facade stays on `_adapter` and must never depend on it.
+ *
+ * When copying this component to another project, update these imports
+ * to match your project's paths:
+ *
+ *   Leaflet → map primitives from react-leaflet
+ */
+
+export {
+  CircleMarker,
+  MapContainer,
+  Marker,
+  Polyline,
+  Popup,
+  TileLayer,
+  Tooltip,
+  ZoomControl,
+  useMap,
+  useMapEvents,
+} from "react-leaflet";

apps/www/components/tool-ui/geo-map/geo-map-engine.tsx

@@ -12,7 +12,7 @@ import {
   ZoomControl,
   useMap,
   useMapEvents,
-} from "./_adapter";
+} from "./_leaflet-adapter";
 import { createClusterIcon, resolveMarkerIcon } from "./geo-map-icons";
 import { GeoMapOverlays } from "./geo-map-overlays";
 import type {

apps/www/components/tool-ui/geo-map/geo-map-overlays.tsx

@@ -2,7 +2,8 @@
 
 import { useMemo, useState } from "react";
 
-import { Popup, Tooltip, cn } from "./_adapter";
+import { cn } from "./_adapter";
+import { Popup, Tooltip } from "./_leaflet-adapter";
 
 function GeoMapPopupContent({
   label,

apps/www/components/tool-ui/geo-map/geo-map.tsx

@@ -1,11 +1,18 @@
 "use client";
 
+import dynamic from "next/dynamic";
 import { memo, useEffect, useState } from "react";
 import { cn } from "./_adapter";
-import { GeoMapEngine } from "./geo-map-engine";
 import styles from "./geo-map-theme.module.css";
 import type { GeoMapProps, GeoMapStyle } from "./schema";
 
+// Leaflet touches `window` at module scope, so the engine must never be
+// evaluated during SSR; every GeoMap consumer inherits this guard.
+const GeoMapEngine = dynamic(
+  () => import("./geo-map-engine").then((m) => m.GeoMapEngine),
+  { ssr: false },
+);
+
 const LIGHT_TILE_URL =
   "https://{s}.basemaps.cartocdn.com/light_all/{z}/{x}/{y}{r}.png";
 const DARK_TILE_URL =

apps/www/lib/tests/geo-map-ssr.test.ts

@@ -0,0 +1,10 @@
+import { describe, expect, it } from "vitest";
+
+describe("geo-map SSR safety", () => {
+  it("imports the facade without evaluating leaflet", async () => {
+    expect(globalThis.window).toBeUndefined();
+    await expect(
+      import("@/components/tool-ui/geo-map"),
+    ).resolves.toHaveProperty("GeoMap");
+  });
+});

apps/www/lib/tests/tool-ui/geo-map/spatial.test.ts

@@ -1,6 +1,6 @@
 import { describe, expect, test, vi } from "vitest";
 
-vi.mock("@/components/tool-ui/geo-map/_adapter", () => ({
+vi.mock("@/components/tool-ui/geo-map/_leaflet-adapter", () => ({
   CircleMarker: () => null,
   MapContainer: () => null,
   Marker: () => null,

apps/www/public/r/registry.json

@@ -531,6 +531,7 @@
       "description": "Display geolocated entities and fleet positions.",
       "dependencies": [
         "leaflet",
+        "next",
         "react-leaflet",
         "supercluster",
         "zod"
@@ -541,6 +542,11 @@
           "type": "registry:component",
           "target": "components/tool-ui/geo-map/_adapter.tsx"
         },
+        {
+          "path": "components/tool-ui/geo-map/_leaflet-adapter.tsx",
+          "type": "registry:component",
+          "target": "components/tool-ui/geo-map/_leaflet-adapter.tsx"
+        },
         {
           "path": "components/tool-ui/geo-map/geo-map-engine.tsx",
           "type": "registry:component",