@elabs-ai/components-maps 4.1.0 → 5.0.0

package/README.md

@@ -43,7 +43,7 @@ import { ThemeProvider } from "@elabs-ai/components-tokens";
 
 ## What's in it
 
-12 exported components — including `MapArc`, `MapCanvas`, `MapClusterLayer`, `MapControls`, `MapGeoJSON`.
+33 exported components — including `DEFAULT_MAP_HEIGHT`, `MAP_BREAKPOINT_THRESHOLDS`, `MAP_BREAKPOINTS`, `MAP_CORNERS`, `MAP_LABEL_ANCHORS`.
 
 Don't guess the API — ask the CLI:
 

package/dist/chunk-2FPB53NG.js

@@ -0,0 +1,36 @@
+"use client";
+import {
+  warnMapOnce
+} from "./chunk-G7JDXDJN.js";
+
+// src/lib/map-position.ts
+function resolveMapPosition(position, plan, component) {
+  const { longitude, latitude, x, y } = position;
+  if (x !== void 0 && y !== void 0) {
+    if (!plan) {
+      warnMapOnce(
+        `${component}-plan-position`,
+        `<${component} x y> needs a plan coordinate system. Set \`plan\` on <MapCanvas>, or pass \`longitude\`/\`latitude\`.`
+      );
+      return [0, 0];
+    }
+    return plan.toLngLat({ x, y });
+  }
+  if (longitude === void 0 || latitude === void 0) {
+    warnMapOnce(
+      `${component}-missing-position`,
+      `<${component}> needs a position: \`longitude\` and \`latitude\`, or \`x\` and \`y\` on a plan.`
+    );
+    return [0, 0];
+  }
+  return [longitude, latitude];
+}
+function toPlanPoint(plan, lngLat) {
+  return plan ? plan.toPlan([lngLat.lng, lngLat.lat]) : null;
+}
+
+export {
+  resolveMapPosition,
+  toPlanPoint
+};
+//# sourceMappingURL=chunk-2FPB53NG.js.map

package/dist/chunk-2FPB53NG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/map-position.ts"],"sourcesContent":["import type { PlanCrs, PlanPoint } from \"./plan-crs\";\nimport { warnMapOnce } from \"./warn-once\";\n\n/** A geographic position — the only kind an ordinary basemap understands. */\nexport type MapGeoPosition = {\n  /** Longitude coordinate. */\n  longitude: number;\n  /** Latitude coordinate. */\n  latitude: number;\n  x?: never;\n  y?: never;\n};\n\n/**\n * A position in PLAN units, for a canvas that declares a `plan` extent: metres\n * along the hall, millimetres across the carriage, pixels into the drawing.\n */\nexport type MapPlanPosition = {\n  /** Horizontal position in plan units. */\n  x: number;\n  /** Vertical position in plan units, from the plan's own origin. */\n  y: number;\n  longitude?: never;\n  latitude?: never;\n};\n\n/**\n * Either a geographic position or a plan one — never a mix. The `never`-typed\n * twins make `{ longitude, x }` a type error rather than a silent winner.\n */\nexport type MapPosition = MapGeoPosition | MapPlanPosition;\n\n/**\n * Reduce a position prop to the two scalars MapLibre wants, so every downstream\n * effect keeps primitive dependencies.\n */\nexport function resolveMapPosition(\n  position: {\n    longitude?: number;\n    latitude?: number;\n    x?: number;\n    y?: number;\n  },\n  plan: PlanCrs | null,\n  component: string,\n): [number, number] {\n  const { longitude, latitude, x, y } = position;\n\n  if (x !== undefined && y !== undefined) {\n    if (!plan) {\n      warnMapOnce(\n        `${component}-plan-position`,\n        `<${component} x y> needs a plan coordinate system. Set \\`plan\\` on <MapCanvas>, or pass \\`longitude\\`/\\`latitude\\`.`,\n      );\n      return [0, 0];\n    }\n    return plan.toLngLat({ x, y });\n  }\n\n  if (longitude === undefined || latitude === undefined) {\n    warnMapOnce(\n      `${component}-missing-position`,\n      `<${component}> needs a position: \\`longitude\\` and \\`latitude\\`, or \\`x\\` and \\`y\\` on a plan.`,\n    );\n    return [0, 0];\n  }\n\n  return [longitude, latitude];\n}\n\n/** The plan point for a lng/lat, or `null` on an ordinary geographic canvas. */\nexport function toPlanPoint(\n  plan: PlanCrs | null,\n  lngLat: { lng: number; lat: number },\n): PlanPoint | null {\n  return plan ? plan.toPlan([lngLat.lng, lngLat.lat]) : null;\n}\n"],"mappings":";;;;;;AAoCO,SAAS,mBACd,UAMA,MACA,WACkB;AAClB,QAAM,EAAE,WAAW,UAAU,GAAG,EAAE,IAAI;AAEtC,MAAI,MAAM,UAAa,MAAM,QAAW;AACtC,QAAI,CAAC,MAAM;AACT;AAAA,QACE,GAAG,SAAS;AAAA,QACZ,IAAI,SAAS;AAAA,MACf;AACA,aAAO,CAAC,GAAG,CAAC;AAAA,IACd;AACA,WAAO,KAAK,SAAS,EAAE,GAAG,EAAE,CAAC;AAAA,EAC/B;AAEA,MAAI,cAAc,UAAa,aAAa,QAAW;AACrD;AAAA,MACE,GAAG,SAAS;AAAA,MACZ,IAAI,SAAS;AAAA,IACf;AACA,WAAO,CAAC,GAAG,CAAC;AAAA,EACd;AAEA,SAAO,CAAC,WAAW,QAAQ;AAC7B;AAGO,SAAS,YACd,MACA,QACkB;AAClB,SAAO,OAAO,KAAK,OAAO,CAAC,OAAO,KAAK,OAAO,GAAG,CAAC,IAAI;AACxD;","names":[]}

package/dist/chunk-2VVJRT66.js

@@ -0,0 +1,37 @@
+"use client";
+
+// src/lib/route-arrow.ts
+var ROUTE_ARROW_SIZE = 24;
+function routeArrowImageId(routeId) {
+  return `route-arrow-${routeId}`;
+}
+function createRouteArrowImage(ink) {
+  if (typeof document === "undefined") return null;
+  const canvas = document.createElement("canvas");
+  canvas.width = ROUTE_ARROW_SIZE;
+  canvas.height = ROUTE_ARROW_SIZE;
+  const context = canvas.getContext("2d");
+  if (!context) return null;
+  const size = ROUTE_ARROW_SIZE;
+  const inset = size * 0.22;
+  const mid = size / 2;
+  context.clearRect(0, 0, size, size);
+  context.strokeStyle = ink;
+  context.lineWidth = size * 0.16;
+  context.lineCap = "round";
+  context.lineJoin = "round";
+  context.beginPath();
+  context.moveTo(inset, inset);
+  context.lineTo(size - inset, mid);
+  context.lineTo(inset, size - inset);
+  context.stroke();
+  const image = context.getImageData(0, 0, size, size);
+  return { width: size, height: size, data: image.data };
+}
+
+export {
+  ROUTE_ARROW_SIZE,
+  routeArrowImageId,
+  createRouteArrowImage
+};
+//# sourceMappingURL=chunk-2VVJRT66.js.map

package/dist/chunk-2VVJRT66.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/route-arrow.ts"],"sourcesContent":["/**\n * The direction chevron for `<MapRoute direction>`, drawn on a canvas and\n * registered with `map.addImage`.\n *\n * An icon rather than a text glyph on purpose: a blank MapLibre style ships no\n * glyph endpoint, so a `symbol` layer's `text-field` renders nothing at all —\n * while `icon-image` needs no network and no sprite.\n */\n\n/** Tile edge, in px. Drawn at `pixelRatio: 2`, so it reads ~12 px on screen. */\nexport const ROUTE_ARROW_SIZE = 24;\n\n/** Image id for one route's chevron. Per route, because the ink is per route. */\nexport function routeArrowImageId(routeId: string): string {\n  return `route-arrow-${routeId}`;\n}\n\n/** A raw RGBA image MapLibre accepts, without depending on the DOM's `ImageData`. */\nexport interface RouteArrowImage {\n  width: number;\n  height: number;\n  data: Uint8ClampedArray;\n}\n\n/**\n * A chevron pointing along +x. MapLibre aligns a line-placed symbol's x axis\n * with the line's direction, so +x is \"forward\"; `icon-rotate: 180` is backward.\n *\n * Returns `null` where there is no 2D context (jsdom) — the caller then leaves\n * the arrow layer out rather than pointing it at a missing image, which\n * MapLibre would draw as nothing while warning on every frame.\n */\nexport function createRouteArrowImage(ink: string): RouteArrowImage | null {\n  if (typeof document === \"undefined\") return null;\n\n  const canvas = document.createElement(\"canvas\");\n  canvas.width = ROUTE_ARROW_SIZE;\n  canvas.height = ROUTE_ARROW_SIZE;\n  const context = canvas.getContext(\"2d\");\n  if (!context) return null;\n\n  const size = ROUTE_ARROW_SIZE;\n  const inset = size * 0.22;\n  const mid = size / 2;\n\n  context.clearRect(0, 0, size, size);\n  context.strokeStyle = ink;\n  context.lineWidth = size * 0.16;\n  context.lineCap = \"round\";\n  context.lineJoin = \"round\";\n  context.beginPath();\n  context.moveTo(inset, inset);\n  context.lineTo(size - inset, mid);\n  context.lineTo(inset, size - inset);\n  context.stroke();\n\n  const image = context.getImageData(0, 0, size, size);\n  return { width: size, height: size, data: image.data };\n}\n"],"mappings":";;;AAUO,IAAM,mBAAmB;AAGzB,SAAS,kBAAkB,SAAyB;AACzD,SAAO,eAAe,OAAO;AAC/B;AAiBO,SAAS,sBAAsB,KAAqC;AACzE,MAAI,OAAO,aAAa,YAAa,QAAO;AAE5C,QAAM,SAAS,SAAS,cAAc,QAAQ;AAC9C,SAAO,QAAQ;AACf,SAAO,SAAS;AAChB,QAAM,UAAU,OAAO,WAAW,IAAI;AACtC,MAAI,CAAC,QAAS,QAAO;AAErB,QAAM,OAAO;AACb,QAAM,QAAQ,OAAO;AACrB,QAAM,MAAM,OAAO;AAEnB,UAAQ,UAAU,GAAG,GAAG,MAAM,IAAI;AAClC,UAAQ,cAAc;AACtB,UAAQ,YAAY,OAAO;AAC3B,UAAQ,UAAU;AAClB,UAAQ,WAAW;AACnB,UAAQ,UAAU;AAClB,UAAQ,OAAO,OAAO,KAAK;AAC3B,UAAQ,OAAO,OAAO,OAAO,GAAG;AAChC,UAAQ,OAAO,OAAO,OAAO,KAAK;AAClC,UAAQ,OAAO;AAEf,QAAM,QAAQ,QAAQ,aAAa,GAAG,GAAG,MAAM,IAAI;AACnD,SAAO,EAAE,OAAO,MAAM,QAAQ,MAAM,MAAM,MAAM,KAAK;AACvD;","names":[]}

package/dist/chunk-3HXFONRP.js

@@ -0,0 +1,2 @@
+"use client";
+//# sourceMappingURL=chunk-3HXFONRP.js.map

package/dist/chunk-3HXFONRP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-3SJN3IYT.js

@@ -0,0 +1,2 @@
+"use client";
+//# sourceMappingURL=chunk-3SJN3IYT.js.map

package/dist/chunk-3SJN3IYT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-4DANBD5B.js

@@ -0,0 +1,55 @@
+"use client";
+
+// src/map-annotation/anchor.ts
+var MAP_LABEL_ANCHORS = [
+  "top",
+  "top-right",
+  "right",
+  "bottom-right",
+  "bottom",
+  "bottom-left",
+  "left",
+  "top-left"
+];
+var DIAGONAL = Math.SQRT1_2;
+function mapAnchorGeometry(anchor, distance) {
+  const d = Math.max(0, distance);
+  const k = d * DIAGONAL;
+  switch (anchor) {
+    case "top":
+      return { dx: 0, dy: -d, fx: -0.5, fy: -1 };
+    case "bottom":
+      return { dx: 0, dy: d, fx: -0.5, fy: 0 };
+    case "left":
+      return { dx: -d, dy: 0, fx: -1, fy: -0.5 };
+    case "right":
+      return { dx: d, dy: 0, fx: 0, fy: -0.5 };
+    case "top-left":
+      return { dx: -k, dy: -k, fx: -1, fy: -1 };
+    case "top-right":
+      return { dx: k, dy: -k, fx: 0, fy: -1 };
+    case "bottom-left":
+      return { dx: -k, dy: k, fx: -1, fy: 0 };
+    case "bottom-right":
+      return { dx: k, dy: k, fx: 0, fy: 0 };
+  }
+}
+function mapAnchorTransform(anchor, distance) {
+  const { dx, dy, fx, fy } = mapAnchorGeometry(anchor, distance);
+  return `translate(calc(${fx * 100}% + ${dx}px), calc(${fy * 100}% + ${dy}px))`;
+}
+function clampShift(left, top, width, height, boundsWidth, boundsHeight, pad = 4) {
+  const maxLeft = Math.max(pad, boundsWidth - width - pad);
+  const maxTop = Math.max(pad, boundsHeight - height - pad);
+  const clampedLeft = Math.min(maxLeft, Math.max(pad, left));
+  const clampedTop = Math.min(maxTop, Math.max(pad, top));
+  return { sx: clampedLeft - left, sy: clampedTop - top };
+}
+
+export {
+  MAP_LABEL_ANCHORS,
+  mapAnchorGeometry,
+  mapAnchorTransform,
+  clampShift
+};
+//# sourceMappingURL=chunk-4DANBD5B.js.map

package/dist/chunk-4DANBD5B.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/map-annotation/anchor.ts"],"sourcesContent":["/**\n * The eight label anchors a map label or annotation can sit at, relative to\n * its point. Compass-style and PHYSICAL on purpose: east of Toronto is east in\n * every writing direction, so a map label never mirrors in RTL.\n */\nexport type MapLabelAnchor =\n  | \"top\"\n  | \"bottom\"\n  | \"left\"\n  | \"right\"\n  | \"top-left\"\n  | \"top-right\"\n  | \"bottom-left\"\n  | \"bottom-right\";\n\n/** Every anchor, clockwise from `top` (for stories and validation). */\nexport const MAP_LABEL_ANCHORS: readonly MapLabelAnchor[] = [\n  \"top\",\n  \"top-right\",\n  \"right\",\n  \"bottom-right\",\n  \"bottom\",\n  \"bottom-left\",\n  \"left\",\n  \"top-left\",\n];\n\n/**\n * Where a label box sits for `anchor`, `distance` px away from its point:\n * `dx` / `dy` is the attach point (the box's nearest edge or corner) relative\n * to the point, and `fx` / `fy` the box's own offset as a fraction of its\n * width / height (`0`, `-0.5` or `-1`), so the box grows away from the point.\n */\nexport interface MapAnchorGeometry {\n  dx: number;\n  dy: number;\n  fx: number;\n  fy: number;\n}\n\nconst DIAGONAL = Math.SQRT1_2;\n\nexport function mapAnchorGeometry(anchor: MapLabelAnchor, distance: number): MapAnchorGeometry {\n  const d = Math.max(0, distance);\n  const k = d * DIAGONAL;\n  switch (anchor) {\n    case \"top\":\n      return { dx: 0, dy: -d, fx: -0.5, fy: -1 };\n    case \"bottom\":\n      return { dx: 0, dy: d, fx: -0.5, fy: 0 };\n    case \"left\":\n      return { dx: -d, dy: 0, fx: -1, fy: -0.5 };\n    case \"right\":\n      return { dx: d, dy: 0, fx: 0, fy: -0.5 };\n    case \"top-left\":\n      return { dx: -k, dy: -k, fx: -1, fy: -1 };\n    case \"top-right\":\n      return { dx: k, dy: -k, fx: 0, fy: -1 };\n    case \"bottom-left\":\n      return { dx: -k, dy: k, fx: -1, fy: 0 };\n    case \"bottom-right\":\n      return { dx: k, dy: k, fx: 0, fy: 0 };\n  }\n}\n\n/** The CSS transform that puts a label box at `anchor`, `distance` px from its point. */\nexport function mapAnchorTransform(anchor: MapLabelAnchor, distance: number): string {\n  const { dx, dy, fx, fy } = mapAnchorGeometry(anchor, distance);\n  return `translate(calc(${fx * 100}% + ${dx}px), calc(${fy * 100}% + ${dy}px))`;\n}\n\n/**\n * The shift that keeps a `width` × `height` box whose top-left corner would\n * land at (`left`, `top`) inside a `boundsWidth` × `boundsHeight` container,\n * `pad` px from every edge. A box larger than the container pins to the\n * start / top edge.\n */\nexport function clampShift(\n  left: number,\n  top: number,\n  width: number,\n  height: number,\n  boundsWidth: number,\n  boundsHeight: number,\n  pad = 4,\n): { sx: number; sy: number } {\n  const maxLeft = Math.max(pad, boundsWidth - width - pad);\n  const maxTop = Math.max(pad, boundsHeight - height - pad);\n  const clampedLeft = Math.min(maxLeft, Math.max(pad, left));\n  const clampedTop = Math.min(maxTop, Math.max(pad, top));\n  return { sx: clampedLeft - left, sy: clampedTop - top };\n}\n"],"mappings":";;;AAgBO,IAAM,oBAA+C;AAAA,EAC1D;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAeA,IAAM,WAAW,KAAK;AAEf,SAAS,kBAAkB,QAAwB,UAAqC;AAC7F,QAAM,IAAI,KAAK,IAAI,GAAG,QAAQ;AAC9B,QAAM,IAAI,IAAI;AACd,UAAQ,QAAQ;AAAA,IACd,KAAK;AACH,aAAO,EAAE,IAAI,GAAG,IAAI,CAAC,GAAG,IAAI,MAAM,IAAI,GAAG;AAAA,IAC3C,KAAK;AACH,aAAO,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,MAAM,IAAI,EAAE;AAAA,IACzC,KAAK;AACH,aAAO,EAAE,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI,IAAI,IAAI,KAAK;AAAA,IAC3C,KAAK;AACH,aAAO,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,KAAK;AAAA,IACzC,KAAK;AACH,aAAO,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,IAAI,GAAG;AAAA,IAC1C,KAAK;AACH,aAAO,EAAE,IAAI,GAAG,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI,GAAG;AAAA,IACxC,KAAK;AACH,aAAO,EAAE,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI,IAAI,IAAI,EAAE;AAAA,IACxC,KAAK;AACH,aAAO,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,EAAE;AAAA,EACxC;AACF;AAGO,SAAS,mBAAmB,QAAwB,UAA0B;AACnF,QAAM,EAAE,IAAI,IAAI,IAAI,GAAG,IAAI,kBAAkB,QAAQ,QAAQ;AAC7D,SAAO,kBAAkB,KAAK,GAAG,OAAO,EAAE,aAAa,KAAK,GAAG,OAAO,EAAE;AAC1E;AAQO,SAAS,WACd,MACA,KACA,OACA,QACA,aACA,cACA,MAAM,GACsB;AAC5B,QAAM,UAAU,KAAK,IAAI,KAAK,cAAc,QAAQ,GAAG;AACvD,QAAM,SAAS,KAAK,IAAI,KAAK,eAAe,SAAS,GAAG;AACxD,QAAM,cAAc,KAAK,IAAI,SAAS,KAAK,IAAI,KAAK,IAAI,CAAC;AACzD,QAAM,aAAa,KAAK,IAAI,QAAQ,KAAK,IAAI,KAAK,GAAG,CAAC;AACtD,SAAO,EAAE,IAAI,cAAc,MAAM,IAAI,aAAa,IAAI;AACxD;","names":[]}

package/dist/chunk-5PDVG53B.js

@@ -0,0 +1,2 @@
+"use client";
+//# sourceMappingURL=chunk-5PDVG53B.js.map

package/dist/chunk-5PDVG53B.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-643R7IJC.js

@@ -0,0 +1,2 @@
+"use client";
+//# sourceMappingURL=chunk-643R7IJC.js.map

package/dist/chunk-643R7IJC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-B3ZDBQ6I.js

@@ -0,0 +1,164 @@
+"use client";
+import {
+  useMap
+} from "./chunk-JYFERXZT.js";
+import {
+  warnMapOnce
+} from "./chunk-G7JDXDJN.js";
+
+// src/map-plan-image/map-plan-image.tsx
+import { useEffect, useId, useMemo, useRef } from "react";
+import { jsx } from "react/jsx-runtime";
+function isThemedSource(src) {
+  return typeof src === "object" && src !== null && "light" in src && "dark" in src;
+}
+function toCanvas(source) {
+  if (typeof HTMLCanvasElement !== "undefined" && source instanceof HTMLCanvasElement) {
+    return source.width > 0 && source.height > 0 ? source : null;
+  }
+  const width = "naturalWidth" in source ? source.naturalWidth : source.width;
+  const height = "naturalHeight" in source ? source.naturalHeight : source.height;
+  if (!width || !height) return null;
+  const canvas = document.createElement("canvas");
+  canvas.width = width;
+  canvas.height = height;
+  const context = canvas.getContext("2d");
+  if (!context) return null;
+  context.drawImage(source, 0, 0);
+  return canvas;
+}
+function MapPlanImage({
+  src,
+  alt,
+  id: propId,
+  extent,
+  coordinates,
+  opacity = 1,
+  visible = true,
+  resampling = "linear",
+  beforeId,
+  onLoad,
+  onError
+}) {
+  const { map, isLoaded, plan, resolvedTheme } = useMap();
+  const autoId = useId();
+  const id = propId ?? autoId;
+  const sourceId = `plan-image-source-${id}`;
+  const layerId = `plan-image-layer-${id}`;
+  const resolvedSrc = isThemedSource(src) ? resolvedTheme === "dark" ? src.dark : src.light : src;
+  const url = typeof resolvedSrc === "string" ? resolvedSrc : null;
+  const canvas = useMemo(
+    () => typeof resolvedSrc === "string" ? null : toCanvas(resolvedSrc),
+    [resolvedSrc]
+  );
+  const corners = useMemo(() => {
+    if (coordinates) return coordinates;
+    if (!plan) return null;
+    if (!extent) return plan.imageCoordinates;
+    const { x, y, width, height } = extent;
+    return [
+      plan.toLngLat({ x, y }),
+      plan.toLngLat({ x: x + width, y }),
+      plan.toLngLat({ x: x + width, y: y + height }),
+      plan.toLngLat({ x, y: y + height })
+    ];
+  }, [coordinates, extent, plan]);
+  const cornersKey = corners ? JSON.stringify(corners) : null;
+  const latestRef = useRef({ corners, url, onLoad, onError });
+  latestRef.current = { corners, url, onLoad, onError };
+  if (!corners) {
+    warnMapOnce(
+      "plan-image-coordinates",
+      "<MapPlanImage> needs somewhere to sit: set `plan` on <MapCanvas>, or pass `coordinates`."
+    );
+  }
+  if (!url && !canvas) {
+    warnMapOnce(
+      "plan-image-source",
+      "<MapPlanImage> could not read its `src`. Pass a URL, or an image/bitmap/canvas that has already decoded."
+    );
+  }
+  const opacityRef = useRef(opacity);
+  opacityRef.current = opacity;
+  const resamplingRef = useRef(resampling);
+  resamplingRef.current = resampling;
+  useEffect(() => {
+    if (!isLoaded || !map) return;
+    const { corners: initialCorners, url: initialUrl } = latestRef.current;
+    if (!initialCorners || !initialUrl && !canvas) return;
+    map.addSource(
+      sourceId,
+      canvas ? { type: "canvas", canvas, coordinates: initialCorners, animate: false } : { type: "image", url: initialUrl, coordinates: initialCorners }
+    );
+    map.addLayer(
+      {
+        id: layerId,
+        type: "raster",
+        source: sourceId,
+        paint: {
+          "raster-opacity": opacityRef.current,
+          // A plan swap should replace the picture, not cross-fade it.
+          "raster-fade-duration": 0,
+          "raster-resampling": resamplingRef.current
+        }
+      },
+      beforeId
+    );
+    return () => {
+      try {
+        if (map.getLayer(layerId)) map.removeLayer(layerId);
+        if (map.getSource(sourceId)) map.removeSource(sourceId);
+      } catch {
+      }
+    };
+  }, [isLoaded, map, sourceId, layerId, canvas, beforeId]);
+  useEffect(() => {
+    if (!isLoaded || !map || !cornersKey) return;
+    const source = map.getSource(sourceId);
+    source?.setCoordinates?.(latestRef.current.corners);
+  }, [isLoaded, map, sourceId, cornersKey]);
+  const mountedUrlRef = useRef(url);
+  useEffect(() => {
+    if (!isLoaded || !map || !url) return;
+    if (mountedUrlRef.current === url) return;
+    mountedUrlRef.current = url;
+    const source = map.getSource(sourceId);
+    source?.updateImage?.({
+      url,
+      ...latestRef.current.corners ? { coordinates: latestRef.current.corners } : {}
+    });
+  }, [isLoaded, map, sourceId, url]);
+  useEffect(() => {
+    if (!isLoaded || !map || !map.getLayer(layerId)) return;
+    map.setPaintProperty(layerId, "raster-opacity", opacity);
+    map.setPaintProperty(layerId, "raster-resampling", resampling);
+    map.setLayoutProperty(layerId, "visibility", visible ? "visible" : "none");
+  }, [isLoaded, map, layerId, opacity, resampling, visible]);
+  useEffect(() => {
+    if (!isLoaded || !map) return;
+    const source = map.getSource(sourceId);
+    if (!source?.on) return;
+    const handleData = (payload) => {
+      if (payload?.sourceDataType !== "metadata") {
+        return;
+      }
+      latestRef.current.onLoad?.();
+    };
+    const handleError = (payload) => {
+      const error = payload?.error;
+      latestRef.current.onError?.(error instanceof Error ? error : new Error("Plan image failed"));
+    };
+    source.on("data", handleData);
+    source.on("error", handleError);
+    return () => {
+      source.off?.("data", handleData);
+      source.off?.("error", handleError);
+    };
+  }, [isLoaded, map, sourceId]);
+  return alt ? /* @__PURE__ */ jsx("span", { "data-slot": "map-plan-image", className: "sr-only", children: alt }) : /* @__PURE__ */ jsx("span", { "data-slot": "map-plan-image", hidden: true });
+}
+
+export {
+  MapPlanImage
+};
+//# sourceMappingURL=chunk-B3ZDBQ6I.js.map

package/dist/chunk-B3ZDBQ6I.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/map-plan-image/map-plan-image.tsx"],"sourcesContent":["\"use client\";\n\nimport type MapLibreGL from \"maplibre-gl\";\nimport { useEffect, useId, useMemo, useRef } from \"react\";\n\nimport { useMap } from \"../map-canvas/map-context\";\nimport { warnMapOnce } from \"../lib/warn-once\";\n\n/**\n * The picture under a plan: a URL, or an already-decoded image, bitmap or\n * canvas. A `{ light, dark }` pair swaps with the active theme — a plan drawing\n * has its own baked-in ink, and one asset rarely reads well on both surfaces.\n */\nexport type MapPlanImageSource = string | HTMLImageElement | ImageBitmap | HTMLCanvasElement;\n\nexport type MapPlanImageProps = {\n  /** The plan picture. Pass `{ light, dark }` to swap it with the theme. */\n  src: MapPlanImageSource | { light: MapPlanImageSource; dark: MapPlanImageSource };\n  /**\n   * What the picture shows, for anyone who cannot see it (\"Level 3 floor plan,\n   * 14 rooms around a central core\"). A plan drawn into WebGL has no accessible\n   * name of its own, so this is the only description of it.\n   */\n  alt?: string;\n  /** Optional identifier for the source/layer. Auto-generated if not provided. */\n  id?: string;\n  /**\n   * Where the picture sits, in PLAN units. Defaults to the whole plan extent, so\n   * a single full-bleed plan needs nothing here. Use it to place one wing, one\n   * machine cell or one carriage inside a larger plan.\n   */\n  extent?: { x: number; y: number; width: number; height: number };\n  /**\n   * The four corners in lng/lat (top-left, top-right, bottom-right, bottom-left)\n   * — an escape hatch that also works on an ordinary geographic canvas, like\n   * Leaflet's `imageOverlay`. Wins over `extent`.\n   */\n  coordinates?: MapLibreGL.Coordinates;\n  /**\n   * Opacity, 0–1 (default 1). A photographic or ink-heavy plan usually reads\n   * best held back around 0.35 so the data drawn on top stays the focus.\n   */\n  opacity?: number;\n  /** Hide the picture without tearing the source down — a multi-floor switch (default true). */\n  visible?: boolean;\n  /** `\"nearest\"` keeps CAD line art crisp when zoomed past its native resolution. */\n  resampling?: \"linear\" | \"nearest\";\n  /** MapLibre layer id to insert this layer before (z-order control). */\n  beforeId?: string;\n  /** Fired once the picture has been fetched and decoded. */\n  onLoad?: () => void;\n  /** Fired when the picture cannot be loaded. The plan itself keeps working without it. */\n  onError?: (error: Error) => void;\n};\n\nfunction isThemedSource(\n  src: MapPlanImageProps[\"src\"],\n): src is { light: MapPlanImageSource; dark: MapPlanImageSource } {\n  return typeof src === \"object\" && src !== null && \"light\" in src && \"dark\" in src;\n}\n\n/**\n * Draw a decoded image or bitmap into a canvas MapLibre can read. Returns\n * `null` when there is no 2D context (jsdom, a zero-sized canvas) — the plan\n * then renders without its picture rather than throwing.\n */\nfunction toCanvas(source: Exclude<MapPlanImageSource, string>): HTMLCanvasElement | null {\n  if (typeof HTMLCanvasElement !== \"undefined\" && source instanceof HTMLCanvasElement) {\n    return source.width > 0 && source.height > 0 ? source : null;\n  }\n\n  const width = \"naturalWidth\" in source ? source.naturalWidth : source.width;\n  const height = \"naturalHeight\" in source ? source.naturalHeight : source.height;\n  if (!width || !height) return null;\n\n  const canvas = document.createElement(\"canvas\");\n  canvas.width = width;\n  canvas.height = height;\n  const context = canvas.getContext(\"2d\");\n  if (!context) return null;\n  context.drawImage(source as CanvasImageSource, 0, 0);\n  return canvas;\n}\n\n/**\n * The plan picture under the shapes — a floor plan, a factory layout, a deck\n * plan. The map equivalent of Qlik Sense's image background layer and Leaflet's\n * `imageOverlay`: by default it covers the whole plan extent declared on\n * `<MapCanvas plan>`, so its corners need no coordinates at all.\n *\n * Render it FIRST among the canvas children so the picture sits under the data,\n * or pin the order with `beforeId`.\n *\n * ```tsx\n * <MapCanvas blank plan={{ width: 2400, height: 1600, unit: \"cm\" }}>\n *   <MapPlanImage src={floorPlanUrl} alt=\"Level 3 floor plan\" opacity={0.35} />\n *   <MapGeoJSON data={roomsInPlanUnits} promoteId=\"id\" />\n * </MapCanvas>\n * ```\n *\n * A picture is optional and often worth skipping: a plan drawn as GeoJSON in\n * plan units paints from tokens, themes correctly, and never blurs.\n */\nexport function MapPlanImage({\n  src,\n  alt,\n  id: propId,\n  extent,\n  coordinates,\n  opacity = 1,\n  visible = true,\n  resampling = \"linear\",\n  beforeId,\n  onLoad,\n  onError,\n}: MapPlanImageProps) {\n  const { map, isLoaded, plan, resolvedTheme } = useMap();\n  const autoId = useId();\n  const id = propId ?? autoId;\n  const sourceId = `plan-image-source-${id}`;\n  const layerId = `plan-image-layer-${id}`;\n\n  const resolvedSrc = isThemedSource(src) ? (resolvedTheme === \"dark\" ? src.dark : src.light) : src;\n  const url = typeof resolvedSrc === \"string\" ? resolvedSrc : null;\n  const canvas = useMemo(\n    () => (typeof resolvedSrc === \"string\" ? null : toCanvas(resolvedSrc)),\n    [resolvedSrc],\n  );\n\n  const corners = useMemo<MapLibreGL.Coordinates | null>(() => {\n    if (coordinates) return coordinates;\n    if (!plan) return null;\n    if (!extent) return plan.imageCoordinates;\n    const { x, y, width, height } = extent;\n    return [\n      plan.toLngLat({ x, y }),\n      plan.toLngLat({ x: x + width, y }),\n      plan.toLngLat({ x: x + width, y: y + height }),\n      plan.toLngLat({ x, y: y + height }),\n    ];\n  }, [coordinates, extent, plan]);\n\n  // Keyed on the values, so an inline `extent` literal doesn't re-place the\n  // picture on every render.\n  const cornersKey = corners ? JSON.stringify(corners) : null;\n\n  const latestRef = useRef({ corners, url, onLoad, onError });\n  latestRef.current = { corners, url, onLoad, onError };\n\n  if (!corners) {\n    warnMapOnce(\n      \"plan-image-coordinates\",\n      \"<MapPlanImage> needs somewhere to sit: set `plan` on <MapCanvas>, or pass `coordinates`.\",\n    );\n  }\n  if (!url && !canvas) {\n    warnMapOnce(\n      \"plan-image-source\",\n      \"<MapPlanImage> could not read its `src`. Pass a URL, or an image/bitmap/canvas that has already decoded.\",\n    );\n  }\n\n  // Read paint through refs so changing it never re-creates the source below.\n  const opacityRef = useRef(opacity);\n  opacityRef.current = opacity;\n  const resamplingRef = useRef(resampling);\n  resamplingRef.current = resampling;\n\n  // Add the source + layer. Deliberately NOT keyed on the url or the corners:\n  // those are updated in place below, so a floor swap never refetches.\n  useEffect(() => {\n    if (!isLoaded || !map) return;\n    const { corners: initialCorners, url: initialUrl } = latestRef.current;\n    if (!initialCorners || (!initialUrl && !canvas)) return;\n\n    map.addSource(\n      sourceId,\n      canvas\n        ? { type: \"canvas\", canvas, coordinates: initialCorners, animate: false }\n        : { type: \"image\", url: initialUrl as string, coordinates: initialCorners },\n    );\n    map.addLayer(\n      {\n        id: layerId,\n        type: \"raster\",\n        source: sourceId,\n        paint: {\n          \"raster-opacity\": opacityRef.current,\n          // A plan swap should replace the picture, not cross-fade it.\n          \"raster-fade-duration\": 0,\n          \"raster-resampling\": resamplingRef.current,\n        },\n      },\n      beforeId,\n    );\n\n    return () => {\n      try {\n        if (map.getLayer(layerId)) map.removeLayer(layerId);\n        if (map.getSource(sourceId)) map.removeSource(sourceId);\n      } catch {\n        // style may be mid-reload\n      }\n    };\n    // Deps deliberately exclude url/corners/paint: all three are read from\n    // `latestRef` or refs and synced in place by the effects below.\n  }, [isLoaded, map, sourceId, layerId, canvas, beforeId]);\n\n  // Move the picture when its placement changes.\n  useEffect(() => {\n    if (!isLoaded || !map || !cornersKey) return;\n    const source = map.getSource(sourceId) as MapLibreGL.ImageSource | undefined;\n    source?.setCoordinates?.(latestRef.current.corners as MapLibreGL.Coordinates);\n  }, [isLoaded, map, sourceId, cornersKey]);\n\n  // Swap the picture in place — no teardown, no flash, no refetch of the rest.\n  const mountedUrlRef = useRef<string | null>(url);\n  useEffect(() => {\n    if (!isLoaded || !map || !url) return;\n    if (mountedUrlRef.current === url) return;\n    mountedUrlRef.current = url;\n    const source = map.getSource(sourceId) as MapLibreGL.ImageSource | undefined;\n    source?.updateImage?.({\n      url,\n      ...(latestRef.current.corners ? { coordinates: latestRef.current.corners } : {}),\n    });\n  }, [isLoaded, map, sourceId, url]);\n\n  // Paint and visibility.\n  useEffect(() => {\n    if (!isLoaded || !map || !map.getLayer(layerId)) return;\n    map.setPaintProperty(layerId, \"raster-opacity\", opacity);\n    map.setPaintProperty(layerId, \"raster-resampling\", resampling);\n    map.setLayoutProperty(layerId, \"visibility\", visible ? \"visible\" : \"none\");\n  }, [isLoaded, map, layerId, opacity, resampling, visible]);\n\n  // Load and failure are reported by the SOURCE, not the map: a map-level error\n  // carries no source id. The plan keeps working without its picture, so the\n  // consumer owns whatever the failure should look like.\n  useEffect(() => {\n    if (!isLoaded || !map) return;\n    const source = map.getSource(sourceId) as\n      | (MapLibreGL.ImageSource & {\n          on?: (event: string, handler: (payload: unknown) => void) => void;\n          off?: (event: string, handler: (payload: unknown) => void) => void;\n        })\n      | undefined;\n    if (!source?.on) return;\n\n    const handleData = (payload: unknown) => {\n      if ((payload as { sourceDataType?: string } | undefined)?.sourceDataType !== \"metadata\") {\n        return;\n      }\n      latestRef.current.onLoad?.();\n    };\n    const handleError = (payload: unknown) => {\n      const error = (payload as { error?: Error } | undefined)?.error;\n      latestRef.current.onError?.(error instanceof Error ? error : new Error(\"Plan image failed\"));\n    };\n\n    source.on(\"data\", handleData);\n    source.on(\"error\", handleError);\n\n    return () => {\n      source.off?.(\"data\", handleData);\n      source.off?.(\"error\", handleError);\n    };\n  }, [isLoaded, map, sourceId]);\n\n  // The picture lives in WebGL, where assistive technology cannot reach it. This\n  // span is its only description — and the module's stable selector seam.\n  return alt ? (\n    <span data-slot=\"map-plan-image\" className=\"sr-only\">\n      {alt}\n    </span>\n  ) : (\n    <span data-slot=\"map-plan-image\" hidden />\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-BGCE3RR5.js

@@ -0,0 +1,35 @@
+"use client";
+
+// src/lib/arc-math.ts
+function buildArcCoordinates(from, to, curvature, samples, wrapLongitude = true) {
+  const [x0, y0] = from;
+  const [xTo, y2] = to;
+  const rawDx = xTo - x0;
+  const x2 = !wrapLongitude ? xTo : rawDx > 180 ? xTo - 360 : rawDx < -180 ? xTo + 360 : xTo;
+  const dx = x2 - x0;
+  const dy = y2 - y0;
+  const distance = Math.hypot(dx, dy);
+  if (distance === 0 || curvature === 0) return [from, [x2, y2]];
+  const mx = (x0 + x2) / 2;
+  const my = (y0 + y2) / 2;
+  const nx = -dy / distance;
+  const ny = dx / distance;
+  const offset = distance * curvature;
+  const cx = mx + nx * offset;
+  const cy = my + ny * offset;
+  const points = [];
+  const segments = Math.max(2, Math.floor(samples));
+  for (let i = 0; i <= segments; i += 1) {
+    const t = i / segments;
+    const inv = 1 - t;
+    const x = inv * inv * x0 + 2 * inv * t * cx + t * t * x2;
+    const y = inv * inv * y0 + 2 * inv * t * cy + t * t * y2;
+    points.push([x, y]);
+  }
+  return points;
+}
+
+export {
+  buildArcCoordinates
+};
+//# sourceMappingURL=chunk-BGCE3RR5.js.map

package/dist/chunk-BGCE3RR5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/arc-math.ts"],"sourcesContent":["/** Pure geometry for `<MapArc>` — kept engine-free so it can be unit-tested. */\n\n/**\n * Sample a quadratic Bézier between `from` and `to` in lng/lat space.\n * `curvature` is how far the arc bows away from a straight line (0 = straight;\n * negative bends to the opposite side). The destination longitude is unwrapped\n * relative to the origin so arcs cross the antimeridian via the shorter\n * great-circle direction — resulting longitudes may fall outside [-180, 180],\n * which MapLibre renders correctly on the globe projection.\n *\n * `wrapLongitude: false` turns that unwrap off, for coordinates that are not\n * longitudes at all: on a plan map, an x of 900 in a 1600-unit-wide hall is a\n * position, and shifting it by 360 would move the arc's end across the floor.\n */\nexport function buildArcCoordinates(\n  from: [number, number],\n  to: [number, number],\n  curvature: number,\n  samples: number,\n  wrapLongitude = true,\n): [number, number][] {\n  const [x0, y0] = from;\n  const [xTo, y2] = to;\n  const rawDx = xTo - x0;\n  const x2 = !wrapLongitude ? xTo : rawDx > 180 ? xTo - 360 : rawDx < -180 ? xTo + 360 : xTo;\n  const dx = x2 - x0;\n  const dy = y2 - y0;\n  const distance = Math.hypot(dx, dy);\n\n  if (distance === 0 || curvature === 0) return [from, [x2, y2]];\n\n  const mx = (x0 + x2) / 2;\n  const my = (y0 + y2) / 2;\n  const nx = -dy / distance;\n  const ny = dx / distance;\n  const offset = distance * curvature;\n  const cx = mx + nx * offset;\n  const cy = my + ny * offset;\n\n  const points: [number, number][] = [];\n  const segments = Math.max(2, Math.floor(samples));\n  for (let i = 0; i <= segments; i += 1) {\n    const t = i / segments;\n    const inv = 1 - t;\n    const x = inv * inv * x0 + 2 * inv * t * cx + t * t * x2;\n    const y = inv * inv * y0 + 2 * inv * t * cy + t * t * y2;\n    points.push([x, y]);\n  }\n  return points;\n}\n"],"mappings":";;;AAcO,SAAS,oBACd,MACA,IACA,WACA,SACA,gBAAgB,MACI;AACpB,QAAM,CAAC,IAAI,EAAE,IAAI;AACjB,QAAM,CAAC,KAAK,EAAE,IAAI;AAClB,QAAM,QAAQ,MAAM;AACpB,QAAM,KAAK,CAAC,gBAAgB,MAAM,QAAQ,MAAM,MAAM,MAAM,QAAQ,OAAO,MAAM,MAAM;AACvF,QAAM,KAAK,KAAK;AAChB,QAAM,KAAK,KAAK;AAChB,QAAM,WAAW,KAAK,MAAM,IAAI,EAAE;AAElC,MAAI,aAAa,KAAK,cAAc,EAAG,QAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;AAE7D,QAAM,MAAM,KAAK,MAAM;AACvB,QAAM,MAAM,KAAK,MAAM;AACvB,QAAM,KAAK,CAAC,KAAK;AACjB,QAAM,KAAK,KAAK;AAChB,QAAM,SAAS,WAAW;AAC1B,QAAM,KAAK,KAAK,KAAK;AACrB,QAAM,KAAK,KAAK,KAAK;AAErB,QAAM,SAA6B,CAAC;AACpC,QAAM,WAAW,KAAK,IAAI,GAAG,KAAK,MAAM,OAAO,CAAC;AAChD,WAAS,IAAI,GAAG,KAAK,UAAU,KAAK,GAAG;AACrC,UAAM,IAAI,IAAI;AACd,UAAM,MAAM,IAAI;AAChB,UAAM,IAAI,MAAM,MAAM,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,IAAI;AACtD,UAAM,IAAI,MAAM,MAAM,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,IAAI;AACtD,WAAO,KAAK,CAAC,GAAG,CAAC,CAAC;AAAA,EACpB;AACA,SAAO;AACT;","names":[]}