@zappie/foundations 0.1.4 → 0.1.6

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # @zappie/foundations
 
+## 0.1.6
+
+### Patch Changes
+
+- a4872fd: A `deferred()` overlay whose code fails to load can recover while it is still open. Pass `failed={(retry) => ...}` to show a message and a retry button. A later `preload()`, such as the one the next tap on the trigger starts, also retries, and the overlay renders as soon as that load succeeds. Before, a failed load showed nothing, and because the overlay was still marked open, further taps never loaded it again.
+- afb46d4: Add storefront security lint rules, pass outbound hosts from `zappie.config.ts` to ESLint, and provide `safeRedirect` from `@zappie/sdk/redirect` for untrusted navigation targets.
+- Updated dependencies [2b672c9]
+- Updated dependencies [9b5b412]
+- Updated dependencies [32ecccf]
+- Updated dependencies [afb46d4]
+- Updated dependencies [6a8e227]
+- Updated dependencies [c0171ae]
+- Updated dependencies [0cbc4da]
+  - @zappie/sdk@0.1.12
+
+## 0.1.5
+
+### Patch Changes
+
+- 282781d: Maps draw the markers the default storefront draws. `BranchMap` shows each branch as the `pinImageUrl` logo in a white ring, 40 px for the focused branch and 32 px for the rest. The focused branch is the selected one or, once the shopper's location is known, the nearest. A shopper location adds a house marker labelled “You” and a line to the focused branch, and the map frames the two with 88 px of padding. Nearby branches group into numbered clusters that zoom in when clicked, and selecting a branch inside a cluster zooms in until its pin shows. Without a shopper the map frames every branch with 64 px of padding, and a single branch is centred at zoom 14. `compact` frames a small map. Coordinates of (0, 0) count as missing. Colour clusters, the house marker, the line and label borders with `--map-accent` and `--map-accent-foreground`.
+
+  The new `DeliveryMap` shows a delivery for a cart or checkout: the branch logo, the shopper's house and the line between them, fitted to all of it, with no controls. Pass `route` to draw a path instead of a straight line. Both maps load after mount, and the clusterer loads only with the branch map.
+
+- 51d437f: An overlay's first open on a page paints on the tap. The first open used to run the overlay engine's modal code for the first time before anything showed, which took 60 to 90 ms on a slow phone. Now the backdrop and the panel with its content paint first, and the engine takes over on the next frame. Focus handling, scroll lock, Escape, outside presses and hiding the page from assistive technology work as before once it does. Until then the panel is hidden from assistive technology and holds every key, press and scroll, so nothing on the page can be reached. Escape and an outside press still close it. Later opens, nested overlays and `forceMount` content use the engine straight away.
+- 1c3cbbf: `ItemForm.Root` accepts a typed `onInvalid={(groups: ItemFormInvalidGroup[]) => ...}` callback. `ItemFormProps` no longer inherits the DOM `onInvalid` handler, and the root never calls `onInvalid` for a DOM `invalid` event.
+- Updated dependencies [e7cc5f0]
+- Updated dependencies [1c3cbbf]
+  - @zappie/sdk@0.1.9
+
 ## 0.1.4
 
 ### Patch Changes

package/README.md

@@ -87,6 +87,11 @@ function Header() {
 - Pass `fallback` to hold an inline part's place while its code loads, for
   example a placeholder label. It shows only while `open` is true and the code
   is not in yet, and it never suspends.
+- Pass `failed` to show something when the code fails to load, such as a
+  message with a button that calls `retry`. It shows only while `open` is true.
+  Without it nothing shows, so a shopper who taps and sees nothing never knows
+  to tap again. A later `preload()`, such as the one the next tap on the
+  trigger starts, also retries, and the component renders when it succeeds.
 - `preload()` starts the load and returns its promise. Calls share one load. A
   failed load is forgotten, so the next `preload()` or the next open tries again.
 - `preloadWhenIdle({ timeout? })` loads the code when the browser is idle and
@@ -98,6 +103,13 @@ function Header() {
 Importing the helper never touches `window`. On the server `Component` renders
 nothing, and it works under `StrictMode`.
 
+The first overlay you open on a page paints on the tap. Its backdrop and panel,
+with the content, show in the engine's markup straight away, and the overlay's
+focus handling, scroll lock and dismissal take over on the next frame. Until
+then the panel is hidden from assistive technology and takes no keys, presses or
+scrolls, apart from Escape and an outside press, which close it. Style the panel
+and `[data-zappie-backdrop]` as usual: both frames match them.
+
 ## Item form focus
 
 When an add fails validation, `ItemForm.Root` focuses the first invalid group
@@ -149,21 +161,36 @@ import { BranchMap } from "@zappie/foundations";
 />;
 ```
 
-Set a height on `.branch-map`. Theme pins with `--branch-map-pin`,
-`--branch-map-pin-selected`, `--branch-map-pin-border`, and
-`--branch-map-pin-size`. Pins expose `data-selected` and `aria-pressed`. Theme
-pin labels with `--branch-map-label-background`, `--branch-map-label-color` and
-`--branch-map-label-border`. Labels are marked `data-branch-map-pin-label` and
-hidden from assistive technology, because the pin already carries the name.
+Set a height on `.branch-map`. With a `pinImageUrl`, such as the business logo,
+each branch pin is the logo in a white ring: 32 px, or 40 px for the focused
+branch. The focused branch is the selected one or, once a `shopperLocation` is
+known, the nearest. Without a `pinImageUrl`, pins are dots themed with
+`--branch-map-pin`, `--branch-map-pin-selected`, `--branch-map-pin-border` and
+`--branch-map-pin-size`. Pins expose `data-selected`, `data-focused` and
+`aria-pressed`. Theme pin labels with `--branch-map-label-background`,
+`--branch-map-label-color` and `--branch-map-label-border`. Labels are marked
+`data-branch-map-pin-label` and hidden from assistive technology, because the pin
+already carries the name. `pinLabel="selected"` labels the focused pin.
+
+With a `shopperLocation`, the map shows a house marker labelled “You” and draws a
+line from it to the focused branch. Nearby branches group into numbered
+clusters. Clicking a cluster zooms into it, and selecting a branch inside a
+cluster zooms in until its pin shows. Colour the clusters, the house marker, the
+line and the label borders with `--map-accent`, and the cluster count and house
+icon with `--map-accent-foreground`. The map reads these when it updates, because
+Maps draws clusters and lines without CSS.
 
 The map fits branches with valid coordinates, including across the date line.
-With a `shopperLocation`, it fits the shopper with the branches, with 88 px of
-padding. After that first fit, selecting another branch pans to it and keeps the
-zoom. The map fits again only when the branches, the shopper location or
-`maxZoom` change. Branches without coordinates remain selectable with “Map
-location unavailable”. `maxZoom` defaults to `15` with a shopper location and
-`14` without one. `mapTypeControl` defaults to `false`. Without a `pinImageUrl`,
-branch pins keep using the existing CSS variables.
+Coordinates of (0, 0) count as missing. With a `shopperLocation`, it fits the
+shopper and the focused branch with 88 px of padding, and fits again when the
+focused branch changes. Without one, it fits every branch with 64 px of padding
+and a new selection pans to that branch. A single point is centred at zoom 14.
+`compact` frames a small map: the route gets 72 px of padding above, 52 px at
+the sides and 36 px below, and a single point is centred at zoom 13. The map
+fits again only when what it frames or `maxZoom` changes. Branches without
+coordinates remain selectable with “Map location unavailable”. `maxZoom`
+defaults to `15` with a shopper location and `14` without one. `mapTypeControl`
+defaults to `false`.
 
 The component renders nothing without a key. It loads its map runtime and the
 Maps JavaScript API after mount, sharing one script across mounted maps.
@@ -172,3 +199,36 @@ With `renderLoadError({ error, retry })` you render the message, and `retry`
 loads the map again. Without it the map shows “Map location unavailable”.
 The optional location button pans to coordinates supplied by your app. Your app
 requests geolocation permission and supplies those coordinates.
+
+## Delivery map
+
+`DeliveryMap` shows where an order goes: the branch logo marker, the shopper's
+house marker and the line between them, fitted to all of it. Use it in a cart or
+checkout in place of a static map image. It is a preview, so it has no controls
+and ignores gestures. Pass `route`, such as a decoded driving route, to draw that
+path instead of a straight line.
+
+```tsx
+import { DeliveryMap } from "@zappie/foundations";
+
+<DeliveryMap
+  branch={branch}
+  shopper={deliveryAddress.coordinates}
+  browserKey={integrations.googleMaps?.browserKey}
+  pinImageUrl={store.brand.logoUrl}
+  renderLoadError={({ retry }) => (
+    <button type="button" onClick={retry}>
+      Try again
+    </button>
+  )}
+  className="delivery-map"
+/>;
+```
+
+Set a height on `.delivery-map`. The default storefront uses 180 px. The branch
+marker is a 36 px logo, the house marker uses `--map-accent` and the line uses
+`--delivery-map-route` at 60% opacity. Without a `pinImageUrl` the branch marker
+is the themed dot. Like `BranchMap`, it renders nothing without a key, loads
+Maps after mount, calls `onLoadError(error)` on a failure and shows “Map location
+unavailable” when either point has no valid coordinates. It fits again when the
+points, the route or its size change.

package/dist/branch-map/colors.js

@@ -0,0 +1,27 @@
+// src/branch-map/colors.ts
+var DEFAULT_COLORS = {
+  accent: "#111111",
+  accentForeground: "#ffffff"
+};
+var COLOR_PROBE_STYLE = {
+  color: "var(--map-accent, currentColor)",
+  backgroundColor: "var(--map-accent-foreground, #ffffff)",
+  borderColor: "var(--delivery-map-route, #163300)"
+};
+function readColors(probe) {
+  if (!probe || typeof getComputedStyle !== "function") {
+    return DEFAULT_COLORS;
+  }
+  const style = getComputedStyle(probe);
+  return {
+    accent: style.color || DEFAULT_COLORS.accent,
+    accentForeground: style.backgroundColor || DEFAULT_COLORS.accentForeground,
+    route: style.borderTopColor || void 0
+  };
+}
+export {
+  COLOR_PROBE_STYLE,
+  DEFAULT_COLORS,
+  readColors
+};
+//# sourceMappingURL=colors.js.map

package/dist/branch-map/colors.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/branch-map/colors.ts"],
+  "sourcesContent": ["/** Colours resolved from CSS, for map parts that cannot read CSS variables. */\nexport type MapColors = {\n  accent: string;\n  accentForeground: string;\n  /** The delivery map's line. */\n  route?: string | undefined;\n};\n\nexport const DEFAULT_COLORS: MapColors = {\n  accent: \"#111111\",\n  accentForeground: \"#ffffff\",\n};\n\n/** Inline style for the hidden element whose computed colours the map reads. */\nexport const COLOR_PROBE_STYLE = {\n  color: \"var(--map-accent, currentColor)\",\n  backgroundColor: \"var(--map-accent-foreground, #ffffff)\",\n  borderColor: \"var(--delivery-map-route, #163300)\",\n} as const;\n\n// Cluster icons and lines are drawn by Maps, which cannot read CSS variables.\nexport function readColors(probe: HTMLElement | null): MapColors {\n  if (!probe || typeof getComputedStyle !== \"function\") {\n    return DEFAULT_COLORS;\n  }\n  const style = getComputedStyle(probe);\n  return {\n    accent: style.color || DEFAULT_COLORS.accent,\n    accentForeground: style.backgroundColor || DEFAULT_COLORS.accentForeground,\n    route: style.borderTopColor || undefined,\n  };\n}\n"],
+  "mappings": ";AAQO,IAAM,iBAA4B;AAAA,EACvC,QAAQ;AAAA,EACR,kBAAkB;AACpB;AAGO,IAAM,oBAAoB;AAAA,EAC/B,OAAO;AAAA,EACP,iBAAiB;AAAA,EACjB,aAAa;AACf;AAGO,SAAS,WAAW,OAAsC;AAC/D,MAAI,CAAC,SAAS,OAAO,qBAAqB,YAAY;AACpD,WAAO;AAAA,EACT;AACA,QAAM,QAAQ,iBAAiB,KAAK;AACpC,SAAO;AAAA,IACL,QAAQ,MAAM,SAAS,eAAe;AAAA,IACtC,kBAAkB,MAAM,mBAAmB,eAAe;AAAA,IAC1D,OAAO,MAAM,kBAAkB;AAAA,EACjC;AACF;",
+  "names": []
+}

package/dist/branch-map/delivery-map.js

@@ -0,0 +1,60 @@
+"use client";
+
+// src/branch-map/delivery-map.tsx
+import { useEffect, useRef } from "react";
+import { COLOR_PROBE_STYLE, readColors } from "./colors.js";
+import { validCoordinates } from "./geometry.js";
+import { useMapRuntime } from "./use-map-runtime.js";
+import { jsx, jsxs } from "react/jsx-runtime";
+var loadDeliveryMap = (target, key, signal) => import("./delivery-runtime.js").then(
+  ({ createDeliveryMap }) => createDeliveryMap(target, key, signal)
+);
+function DeliveryMap({
+  branch,
+  shopper,
+  route,
+  browserKey,
+  pinImageUrl,
+  onLoadError,
+  renderLoadError,
+  ...props
+}) {
+  const probe = useRef(null);
+  const origin = validCoordinates(branch.coordinates) ? branch.coordinates : void 0;
+  const destination = validCoordinates(shopper) ? shopper : void 0;
+  const mappable = !!origin && !!destination;
+  const { element, runtime, failure, retry } = useMapRuntime(browserKey, mappable, loadDeliveryMap, onLoadError);
+  const failed = failure !== void 0;
+  const coordinates = branch.coordinates;
+  useEffect(() => {
+    if (runtime && validCoordinates(coordinates) && validCoordinates(shopper)) {
+      runtime.update({
+        branch: coordinates,
+        shopper,
+        route,
+        pinImageUrl,
+        colors: readColors(probe.current)
+      });
+    }
+  }, [runtime, coordinates, shopper, route, pinImageUrl]);
+  if (!browserKey) {
+    return null;
+  }
+  return /* @__PURE__ */ jsxs("div", { ...props, "data-delivery-map": "", children: [
+    /* @__PURE__ */ jsx("span", { ref: probe, hidden: true, style: COLOR_PROBE_STYLE }),
+    /* @__PURE__ */ jsx(
+      "div",
+      {
+        hidden: failed || !mappable,
+        ref: element,
+        "data-delivery-map-canvas": "",
+        style: { height: "100%" }
+      }
+    ),
+    failure && renderLoadError ? renderLoadError({ error: failure.error, retry }) : failed || !mappable ? /* @__PURE__ */ jsx("p", { role: "status", children: "Map location unavailable" }) : null
+  ] });
+}
+export {
+  DeliveryMap
+};
+//# sourceMappingURL=delivery-map.js.map

package/dist/branch-map/delivery-map.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/branch-map/delivery-map.tsx"],
+  "sourcesContent": ["\"use client\";\nimport type { Branch } from \"@zappie/sdk\";\nimport { useEffect, useRef, type HTMLAttributes, type ReactNode } from \"react\";\nimport { COLOR_PROBE_STYLE, readColors } from \"./colors\";\nimport type { createDeliveryMap } from \"./delivery-runtime\";\nimport { validCoordinates, type Coordinates } from \"./geometry\";\nimport { useMapRuntime, type MapLoadErrorState } from \"./use-map-runtime\";\n\n/** The branch, the shopper's address and an optional route for DeliveryMap. */\nexport type DeliveryMapProps = HTMLAttributes<HTMLDivElement> & {\n  /** The branch the order leaves from. Only its coordinates are read. */\n  branch: Pick<Branch, \"coordinates\">;\n  /** Coordinates of the delivery address. */\n  shopper?: Coordinates | undefined;\n  /**\n   * The path to draw, such as a decoded driving route, from the branch to the\n   * shopper. Without it the map draws a straight line.\n   */\n  route?: Coordinates[];\n  browserKey?: string;\n  /** Image shown inside the branch marker, such as the business logo. */\n  pinImageUrl?: string;\n  /** Called each time the map fails to load. */\n  onLoadError?: (error: unknown) => void;\n  /**\n   * Render your own message when the map fails to load, such as a retry\n   * button that calls `retry`. Without it the map shows \"Map location unavailable\".\n   */\n  renderLoadError?: (state: MapLoadErrorState) => ReactNode;\n};\n\nconst loadDeliveryMap = (\n  target: HTMLElement,\n  key: string,\n  signal: AbortSignal,\n) =>\n  import(\"./delivery-runtime\").then(({ createDeliveryMap }) =>\n    createDeliveryMap(target, key, signal),\n  );\n\n/**\n * A static map of a delivery: the branch marker, the shopper's house marker\n * and the line between them, fitted to both. It has no controls and ignores\n * gestures. Maps loads after mount when you supply a browser key. Set the\n * container height with CSS. Colour the house marker with --map-accent and\n * the line with --delivery-map-route.\n */\nexport function DeliveryMap({\n  branch,\n  shopper,\n  route,\n  browserKey,\n  pinImageUrl,\n  onLoadError,\n  renderLoadError,\n  ...props\n}: DeliveryMapProps) {\n  const probe = useRef<HTMLSpanElement>(null);\n  const origin = validCoordinates(branch.coordinates)\n    ? branch.coordinates\n    : undefined;\n  const destination = validCoordinates(shopper) ? shopper : undefined;\n  const mappable = !!origin && !!destination;\n  const { element, runtime, failure, retry } = useMapRuntime<\n    Awaited<ReturnType<typeof createDeliveryMap>>\n  >(browserKey, mappable, loadDeliveryMap, onLoadError);\n  const failed = failure !== undefined;\n  const coordinates = branch.coordinates;\n  useEffect(() => {\n    if (runtime && validCoordinates(coordinates) && validCoordinates(shopper)) {\n      runtime.update({\n        branch: coordinates,\n        shopper,\n        route,\n        pinImageUrl,\n        colors: readColors(probe.current),\n      });\n    }\n  }, [runtime, coordinates, shopper, route, pinImageUrl]);\n  if (!browserKey) {\n    return null;\n  }\n  return (\n    <div {...props} data-delivery-map=\"\">\n      <span ref={probe} hidden style={COLOR_PROBE_STYLE} />\n      <div\n        hidden={failed || !mappable}\n        ref={element}\n        data-delivery-map-canvas=\"\"\n        style={{ height: \"100%\" }}\n      />\n      {failure && renderLoadError ? (\n        renderLoadError({ error: failure.error, retry })\n      ) : failed || !mappable ? (\n        <p role=\"status\">Map location unavailable</p>\n      ) : null}\n    </div>\n  );\n}\n"],
+  "mappings": ";;;AAEA,SAAS,WAAW,cAAmD;AACvE,SAAS,mBAAmB,kBAAkB;AAE9C,SAAS,wBAA0C;AACnD,SAAS,qBAA6C;AA6ElD,SACE,KADF;AApDJ,IAAM,kBAAkB,CACtB,QACA,KACA,WAEA,OAAO,uBAAoB,EAAE;AAAA,EAAK,CAAC,EAAE,kBAAkB,MACrD,kBAAkB,QAAQ,KAAK,MAAM;AACvC;AASK,SAAS,YAAY;AAAA,EAC1B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAqB;AACnB,QAAM,QAAQ,OAAwB,IAAI;AAC1C,QAAM,SAAS,iBAAiB,OAAO,WAAW,IAC9C,OAAO,cACP;AACJ,QAAM,cAAc,iBAAiB,OAAO,IAAI,UAAU;AAC1D,QAAM,WAAW,CAAC,CAAC,UAAU,CAAC,CAAC;AAC/B,QAAM,EAAE,SAAS,SAAS,SAAS,MAAM,IAAI,cAE3C,YAAY,UAAU,iBAAiB,WAAW;AACpD,QAAM,SAAS,YAAY;AAC3B,QAAM,cAAc,OAAO;AAC3B,YAAU,MAAM;AACd,QAAI,WAAW,iBAAiB,WAAW,KAAK,iBAAiB,OAAO,GAAG;AACzE,cAAQ,OAAO;AAAA,QACb,QAAQ;AAAA,QACR;AAAA,QACA;AAAA,QACA;AAAA,QACA,QAAQ,WAAW,MAAM,OAAO;AAAA,MAClC,CAAC;AAAA,IACH;AAAA,EACF,GAAG,CAAC,SAAS,aAAa,SAAS,OAAO,WAAW,CAAC;AACtD,MAAI,CAAC,YAAY;AACf,WAAO;AAAA,EACT;AACA,SACE,qBAAC,SAAK,GAAG,OAAO,qBAAkB,IAChC;AAAA,wBAAC,UAAK,KAAK,OAAO,QAAM,MAAC,OAAO,mBAAmB;AAAA,IACnD;AAAA,MAAC;AAAA;AAAA,QACC,QAAQ,UAAU,CAAC;AAAA,QACnB,KAAK;AAAA,QACL,4BAAyB;AAAA,QACzB,OAAO,EAAE,QAAQ,OAAO;AAAA;AAAA,IAC1B;AAAA,IACC,WAAW,kBACV,gBAAgB,EAAE,OAAO,QAAQ,OAAO,MAAM,CAAC,IAC7C,UAAU,CAAC,WACb,oBAAC,OAAE,MAAK,UAAS,sCAAwB,IACvC;AAAA,KACN;AAEJ;",
+  "names": []
+}

package/dist/branch-map/delivery-runtime.js

@@ -0,0 +1,118 @@
+// src/branch-map/delivery-runtime.ts
+import { pointBounds } from "./fit.js";
+import { loadMaps } from "./loader.js";
+import {
+  DEFAULT_COLORS,
+  markerOverlayClass,
+  paintMarker
+} from "./markers.js";
+var DELIVERY_ROUTE = {
+  color: "#163300",
+  opacity: 0.6,
+  weight: 5
+};
+var DELIVERY_LOGO_SIZE = 36;
+function deliveryPath(update) {
+  const via = (update.route ?? []).filter(
+    (point) => Number.isFinite(point.lat) && Number.isFinite(point.lng)
+  );
+  return via.length >= 2 ? via : [update.branch, update.shopper];
+}
+function deliveryBounds(update) {
+  return pointBounds([update.branch, update.shopper, ...deliveryPath(update)]);
+}
+async function createDeliveryMap(element, key, signal) {
+  const maps = await loadMaps(key);
+  signal.throwIfAborted();
+  const map = new maps.Map(element, {
+    center: { lat: 0, lng: 0 },
+    zoom: 12,
+    gestureHandling: "none",
+    disableDefaultUI: true,
+    keyboardShortcuts: false,
+    clickableIcons: false
+  });
+  const Marker = markerOverlayClass(maps);
+  let branchPin;
+  let shopperPin;
+  let line;
+  let framed;
+  let last;
+  const pin = (key2, position) => {
+    const node = document.createElement("div");
+    node.setAttribute("aria-hidden", "true");
+    node.dataset.deliveryMapPin = key2;
+    const marker = new Marker(key2, position, node);
+    marker.setMap(map);
+    return marker;
+  };
+  const frame = (update) => {
+    map.fitBounds(deliveryBounds(update));
+  };
+  const resize = typeof ResizeObserver === "function" ? new ResizeObserver(() => {
+    if (last) {
+      frame(last);
+    }
+  }) : void 0;
+  resize?.observe(element);
+  return {
+    update(update) {
+      last = update;
+      const colors = update.colors ?? DEFAULT_COLORS;
+      branchPin ?? (branchPin = pin("branch", update.branch));
+      branchPin.setPosition(update.branch);
+      if (update.pinImageUrl) {
+        paintMarker(
+          branchPin.element,
+          {
+            kind: "logo",
+            size: DELIVERY_LOGO_SIZE,
+            imageUrl: update.pinImageUrl,
+            shadow: "sm",
+            lift: DELIVERY_LOGO_SIZE / 2
+          },
+          colors
+        );
+      } else {
+        paintMarker(branchPin.element, { kind: "dot", selected: true }, colors);
+      }
+      branchPin.element.style.cursor = "default";
+      shopperPin ?? (shopperPin = pin("shopper", update.shopper));
+      shopperPin.setPosition(update.shopper);
+      paintMarker(
+        shopperPin.element,
+        { kind: "house", color: "#ffffff", lift: 16 },
+        colors
+      );
+      line ?? (line = new maps.Polyline({ map }));
+      line.setOptions({
+        path: deliveryPath(update),
+        strokeColor: update.colors?.route ?? DELIVERY_ROUTE.color,
+        strokeOpacity: DELIVERY_ROUTE.opacity,
+        strokeWeight: DELIVERY_ROUTE.weight,
+        clickable: false
+      });
+      const key2 = JSON.stringify(deliveryBounds(update));
+      if (key2 !== framed) {
+        framed = key2;
+        frame(update);
+      }
+    },
+    destroy() {
+      resize?.disconnect();
+      branchPin?.setMap(null);
+      shopperPin?.setMap(null);
+      line?.setMap(null);
+      maps.event.clearInstanceListeners(map);
+      element.replaceChildren();
+    }
+  };
+}
+export {
+  DELIVERY_LOGO_SIZE,
+  DELIVERY_ROUTE,
+  createDeliveryMap,
+  deliveryBounds,
+  deliveryPath
+};
+//# sourceMappingURL=delivery-runtime.js.map

package/dist/branch-map/delivery-runtime.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/branch-map/delivery-runtime.ts"],
+  "sourcesContent": ["import { pointBounds } from \"./fit\";\nimport type { Coordinates } from \"./geometry\";\nimport { loadMaps } from \"./loader\";\nimport {\n  DEFAULT_COLORS,\n  markerOverlayClass,\n  paintMarker,\n  type MapColors,\n  type MarkerOverlay,\n} from \"./markers\";\n\nexport type DeliveryMapUpdate = {\n  branch: Coordinates;\n  shopper: Coordinates;\n  route?: Coordinates[] | undefined;\n  pinImageUrl?: string | undefined;\n  colors?: MapColors | undefined;\n};\n\n/** The line between the branch and the shopper. */\nexport const DELIVERY_ROUTE = {\n  color: \"#163300\",\n  opacity: 0.6,\n  weight: 5,\n} as const;\n/** Diameter of the branch logo marker. */\nexport const DELIVERY_LOGO_SIZE = 36;\n\n/** The points the delivery map frames and the path it draws. */\nexport function deliveryPath(update: DeliveryMapUpdate) {\n  const via = (update.route ?? []).filter(\n    (point) => Number.isFinite(point.lat) && Number.isFinite(point.lng),\n  );\n  return via.length >= 2 ? via : [update.branch, update.shopper];\n}\n\nexport function deliveryBounds(update: DeliveryMapUpdate) {\n  return pointBounds([update.branch, update.shopper, ...deliveryPath(update)])!;\n}\n\nexport async function createDeliveryMap(\n  element: HTMLElement,\n  key: string,\n  signal: AbortSignal,\n) {\n  const maps = await loadMaps(key);\n  signal.throwIfAborted();\n  // A static preview: no panning, zooming, dragging or controls.\n  const map = new maps.Map(element, {\n    center: { lat: 0, lng: 0 },\n    zoom: 12,\n    gestureHandling: \"none\",\n    disableDefaultUI: true,\n    keyboardShortcuts: false,\n    clickableIcons: false,\n  });\n  const Marker = markerOverlayClass(maps);\n  let branchPin: MarkerOverlay | undefined;\n  let shopperPin: MarkerOverlay | undefined;\n  let line: google.maps.Polyline | undefined;\n  let framed: string | undefined;\n  let last: DeliveryMapUpdate | undefined;\n  const pin = (key: string, position: Coordinates) => {\n    const node = document.createElement(\"div\");\n    node.setAttribute(\"aria-hidden\", \"true\");\n    node.dataset.deliveryMapPin = key;\n    const marker = new Marker(key, position, node);\n    marker.setMap(map);\n    return marker;\n  };\n  const frame = (update: DeliveryMapUpdate) => {\n    map.fitBounds(deliveryBounds(update));\n  };\n  const resize =\n    typeof ResizeObserver === \"function\"\n      ? new ResizeObserver(() => {\n          if (last) {\n            frame(last);\n          }\n        })\n      : undefined;\n  resize?.observe(element);\n  return {\n    update(update: DeliveryMapUpdate) {\n      last = update;\n      const colors = update.colors ?? DEFAULT_COLORS;\n      branchPin ??= pin(\"branch\", update.branch);\n      branchPin.setPosition(update.branch);\n      if (update.pinImageUrl) {\n        // The logo is the marker itself, so its centre sits half its size above the location.\n        paintMarker(\n          branchPin.element,\n          {\n            kind: \"logo\",\n            size: DELIVERY_LOGO_SIZE,\n            imageUrl: update.pinImageUrl,\n            shadow: \"sm\",\n            lift: DELIVERY_LOGO_SIZE / 2,\n          },\n          colors,\n        );\n      } else {\n        paintMarker(branchPin.element, { kind: \"dot\", selected: true }, colors);\n      }\n      branchPin.element.style.cursor = \"default\";\n      shopperPin ??= pin(\"shopper\", update.shopper);\n      shopperPin.setPosition(update.shopper);\n      paintMarker(\n        shopperPin.element,\n        { kind: \"house\", color: \"#ffffff\", lift: 16 },\n        colors,\n      );\n      line ??= new maps.Polyline({ map });\n      line.setOptions({\n        path: deliveryPath(update),\n        strokeColor: update.colors?.route ?? DELIVERY_ROUTE.color,\n        strokeOpacity: DELIVERY_ROUTE.opacity,\n        strokeWeight: DELIVERY_ROUTE.weight,\n        clickable: false,\n      });\n      const key = JSON.stringify(deliveryBounds(update));\n      if (key !== framed) {\n        framed = key;\n        frame(update);\n      }\n    },\n    destroy() {\n      resize?.disconnect();\n      branchPin?.setMap(null);\n      shopperPin?.setMap(null);\n      line?.setMap(null);\n      maps.event.clearInstanceListeners(map);\n      element.replaceChildren();\n    },\n  };\n}\n"],
+  "mappings": "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",
+  "names": ["key"]
+}

package/dist/branch-map/fit.js

@@ -0,0 +1,123 @@
+// src/branch-map/fit.ts
+import {
+  validCoordinates,
+  visibleBranches
+} from "./geometry.js";
+var OVERVIEW_PADDING = 64;
+var ROUTE_PADDING = {
+  top: 88,
+  right: 88,
+  bottom: 88,
+  left: 88
+};
+var COMPACT_ROUTE_PADDING = {
+  top: 72,
+  right: 52,
+  bottom: 36,
+  left: 52
+};
+var SINGLE_POINT_ZOOM = 14;
+var COMPACT_SINGLE_POINT_ZOOM = 13;
+function distanceKm(from, to) {
+  const radians = (degrees) => degrees * Math.PI / 180;
+  const dLat = radians(to.lat - from.lat);
+  const dLng = radians(to.lng - from.lng);
+  const a = Math.sin(dLat / 2) ** 2 + Math.cos(radians(from.lat)) * Math.cos(radians(to.lat)) * Math.sin(dLng / 2) ** 2;
+  return 6371 * 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));
+}
+function focusedBranch(branches, selectedId, shopper) {
+  const visible = visibleBranches(branches);
+  const selected = visible.find((branch) => branch.id === selectedId);
+  if (selected || !validCoordinates(shopper)) {
+    return selected;
+  }
+  let nearest;
+  let best = Infinity;
+  for (const branch of visible) {
+    const distance = distanceKm(shopper, branch.coordinates);
+    if (distance < best) {
+      best = distance;
+      nearest = branch;
+    }
+  }
+  return nearest;
+}
+function clusterSize(count) {
+  return count < 10 ? 40 : count < 50 ? 48 : 56;
+}
+function pointBounds(points) {
+  if (!points.length) {
+    return void 0;
+  }
+  const wrapped = (lng) => (lng + 360) % 360;
+  const longitudes = points.map((point) => point.lng).sort((a, b) => wrapped(a) - wrapped(b));
+  let gap = -1;
+  let start = 0;
+  for (let index = 0; index < longitudes.length; index++) {
+    const next = wrapped(longitudes[(index + 1) % longitudes.length]) + (index === longitudes.length - 1 ? 360 : 0);
+    if (next - wrapped(longitudes[index]) > gap) {
+      gap = next - wrapped(longitudes[index]);
+      start = (index + 1) % longitudes.length;
+    }
+  }
+  return {
+    north: Math.max(...points.map((point) => point.lat)),
+    south: Math.min(...points.map((point) => point.lat)),
+    west: longitudes[start],
+    east: longitudes[(start + longitudes.length - 1) % longitudes.length]
+  };
+}
+function branchBounds(branches, location) {
+  const points = visibleBranches(branches).map((branch) => branch.coordinates);
+  if (validCoordinates(location)) {
+    points.push(location);
+  }
+  return pointBounds(points);
+}
+function fitPlan({
+  branches,
+  shopper,
+  focused,
+  maxZoom,
+  compact = false
+}) {
+  const location = validCoordinates(shopper) ? shopper : void 0;
+  const points = location && focused ? [location, focused.coordinates] : [
+    ...location ? [location] : [],
+    ...visibleBranches(branches).map((branch) => branch.coordinates)
+  ];
+  if (!points.length) {
+    return void 0;
+  }
+  const route = !!(location && focused);
+  if (points.length === 1) {
+    return {
+      kind: "center",
+      center: points[0],
+      zoom: Math.min(
+        maxZoom,
+        compact ? COMPACT_SINGLE_POINT_ZOOM : SINGLE_POINT_ZOOM
+      )
+    };
+  }
+  return {
+    kind: "bounds",
+    bounds: pointBounds(points),
+    padding: route ? compact ? COMPACT_ROUTE_PADDING : ROUTE_PADDING : OVERVIEW_PADDING,
+    maxZoom
+  };
+}
+export {
+  COMPACT_ROUTE_PADDING,
+  COMPACT_SINGLE_POINT_ZOOM,
+  OVERVIEW_PADDING,
+  ROUTE_PADDING,
+  SINGLE_POINT_ZOOM,
+  branchBounds,
+  clusterSize,
+  distanceKm,
+  fitPlan,
+  focusedBranch,
+  pointBounds
+};
+//# sourceMappingURL=fit.js.map

package/dist/branch-map/fit.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/branch-map/fit.ts"],
+  "sourcesContent": ["import type { Branch } from \"@zappie/sdk\";\nimport {\n  validCoordinates,\n  visibleBranches,\n  type Bounds,\n  type Coordinates,\n} from \"./geometry\";\n\nexport type Padding =\n  number | { top: number; right: number; bottom: number; left: number };\n\n/** Padding around every fitted point when no route is drawn. */\nexport const OVERVIEW_PADDING = 64;\n/** Padding around the shopper-to-branch route. */\nexport const ROUTE_PADDING: Padding = {\n  top: 88,\n  right: 88,\n  bottom: 88,\n  left: 88,\n};\n/** Route padding in a compact map, with room for both pin labels. */\nexport const COMPACT_ROUTE_PADDING: Padding = {\n  top: 72,\n  right: 52,\n  bottom: 36,\n  left: 52,\n};\n/** Zoom for a single point, in a full and a compact map. */\nexport const SINGLE_POINT_ZOOM = 14;\nexport const COMPACT_SINGLE_POINT_ZOOM = 13;\n\n/** Great-circle distance in kilometres. */\nexport function distanceKm(from: Coordinates, to: Coordinates) {\n  const radians = (degrees: number) => (degrees * Math.PI) / 180;\n  const dLat = radians(to.lat - from.lat);\n  const dLng = radians(to.lng - from.lng);\n  const a =\n    Math.sin(dLat / 2) ** 2 +\n    Math.cos(radians(from.lat)) *\n      Math.cos(radians(to.lat)) *\n      Math.sin(dLng / 2) ** 2;\n  return 6371 * 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));\n}\n\n/**\n * The branch the map highlights: the selected one, or, once the shopper's\n * location is known, the nearest branch.\n */\nexport function focusedBranch(\n  branches: Branch[],\n  selectedId: string | undefined,\n  shopper: Coordinates | undefined,\n) {\n  const visible = visibleBranches(branches);\n  const selected = visible.find((branch) => branch.id === selectedId);\n  if (selected || !validCoordinates(shopper)) {\n    return selected;\n  }\n  let nearest: (typeof visible)[number] | undefined;\n  let best = Infinity;\n  for (const branch of visible) {\n    const distance = distanceKm(shopper, branch.coordinates);\n    if (distance < best) {\n      best = distance;\n      nearest = branch;\n    }\n  }\n  return nearest;\n}\n\n/** Diameter of a cluster icon for the number of branches it holds. */\nexport function clusterSize(count: number) {\n  return count < 10 ? 40 : count < 50 ? 48 : 56;\n}\n\nexport function pointBounds(points: Coordinates[]): Bounds | undefined {\n  if (!points.length) {\n    return undefined;\n  }\n  // The largest longitude gap lies outside the bounds, including across the date line.\n  // Sort by the wrapped longitude but report the original values, so they stay exact.\n  const wrapped = (lng: number) => (lng + 360) % 360;\n  const longitudes = points\n    .map((point) => point.lng)\n    .sort((a, b) => wrapped(a) - wrapped(b));\n  let gap = -1;\n  let start = 0;\n  for (let index = 0; index < longitudes.length; index++) {\n    const next =\n      wrapped(longitudes[(index + 1) % longitudes.length]!) +\n      (index === longitudes.length - 1 ? 360 : 0);\n    if (next - wrapped(longitudes[index]!) > gap) {\n      gap = next - wrapped(longitudes[index]!);\n      start = (index + 1) % longitudes.length;\n    }\n  }\n  return {\n    north: Math.max(...points.map((point) => point.lat)),\n    south: Math.min(...points.map((point) => point.lat)),\n    west: longitudes[start]!,\n    east: longitudes[(start + longitudes.length - 1) % longitudes.length]!,\n  };\n}\n\nexport function branchBounds(branches: Branch[], location?: Coordinates) {\n  const points = visibleBranches(branches).map((branch) => branch.coordinates);\n  if (validCoordinates(location)) {\n    points.push(location);\n  }\n  return pointBounds(points);\n}\n\n/** How the map frames its points. */\nexport type FitPlan =\n  | { kind: \"center\"; center: Coordinates; zoom: number }\n  | { kind: \"bounds\"; bounds: Bounds; padding: Padding; maxZoom: number };\n\n/**\n * With a route, frame the shopper and the focused branch. Otherwise frame the\n * shopper and every branch. A single point is centred at a fixed zoom.\n */\nexport function fitPlan({\n  branches,\n  shopper,\n  focused,\n  maxZoom,\n  compact = false,\n}: {\n  branches: Branch[];\n  shopper?: Coordinates | undefined;\n  focused?: (Branch & { coordinates: Coordinates }) | undefined;\n  maxZoom: number;\n  compact?: boolean;\n}): FitPlan | undefined {\n  const location = validCoordinates(shopper) ? shopper : undefined;\n  const points =\n    location && focused\n      ? [location, focused.coordinates]\n      : [\n          ...(location ? [location] : []),\n          ...visibleBranches(branches).map((branch) => branch.coordinates),\n        ];\n  if (!points.length) {\n    return undefined;\n  }\n  const route = !!(location && focused);\n  if (points.length === 1) {\n    return {\n      kind: \"center\",\n      center: points[0]!,\n      zoom: Math.min(\n        maxZoom,\n        compact ? COMPACT_SINGLE_POINT_ZOOM : SINGLE_POINT_ZOOM,\n      ),\n    };\n  }\n  return {\n    kind: \"bounds\",\n    bounds: pointBounds(points)!,\n    padding: route\n      ? compact\n        ? COMPACT_ROUTE_PADDING\n        : ROUTE_PADDING\n      : OVERVIEW_PADDING,\n    maxZoom,\n  };\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/branch-map/geometry.js

@@ -4,39 +4,10 @@ function validCoordinates(value) {
 }
 function visibleBranches(branches) {
   return branches.filter(
-    (branch) => validCoordinates(branch.coordinates)
+    (branch) => validCoordinates(branch.coordinates) && (branch.coordinates.lat !== 0 || branch.coordinates.lng !== 0)
   );
 }
-function branchBounds(branches, location) {
-  const points = visibleBranches(branches).map((branch) => branch.coordinates);
-  if (validCoordinates(location)) {
-    points.push(location);
-  }
-  if (!points.length) {
-    return void 0;
-  }
-  const longitudes = points.map((point) => (point.lng + 360) % 360).sort((a, b) => a - b);
-  let gap = -1;
-  let start = 0;
-  for (let index = 0; index < longitudes.length; index++) {
-    const next = longitudes[(index + 1) % longitudes.length] + (index === longitudes.length - 1 ? 360 : 0);
-    if (next - longitudes[index] > gap) {
-      gap = next - longitudes[index];
-      start = (index + 1) % longitudes.length;
-    }
-  }
-  const normalize = (lng) => lng > 180 ? lng - 360 : lng;
-  return {
-    north: Math.max(...points.map((point) => point.lat)),
-    south: Math.min(...points.map((point) => point.lat)),
-    west: normalize(longitudes[start]),
-    east: normalize(
-      longitudes[(start + longitudes.length - 1) % longitudes.length]
-    )
-  };
-}
 export {
-  branchBounds,
   validCoordinates,
   visibleBranches
 };

package/dist/branch-map/geometry.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/branch-map/geometry.ts"],
-  "sourcesContent": ["import type { Branch } from \"@zappie/sdk\";\n\nexport type Coordinates = { lat: number; lng: number };\nexport function validCoordinates(value?: Coordinates): value is Coordinates {\n  return (\n    !!value &&\n    Number.isFinite(value.lat) &&\n    Number.isFinite(value.lng) &&\n    Math.abs(value.lat) <= 90 &&\n    Math.abs(value.lng) <= 180\n  );\n}\nexport function visibleBranches(branches: Branch[]) {\n  return branches.filter(\n    (branch): branch is Branch & { coordinates: Coordinates } =>\n      validCoordinates(branch.coordinates),\n  );\n}\nexport function branchBounds(branches: Branch[], location?: Coordinates) {\n  const points = visibleBranches(branches).map((branch) => branch.coordinates);\n  if (validCoordinates(location)) {\n    points.push(location);\n  }\n  if (!points.length) {\n    return undefined;\n  }\n  // The largest longitude gap lies outside the bounds, including across the date line.\n  const longitudes = points\n    .map((point) => (point.lng + 360) % 360)\n    .sort((a, b) => a - b);\n  let gap = -1;\n  let start = 0;\n  for (let index = 0; index < longitudes.length; index++) {\n    const next =\n      longitudes[(index + 1) % longitudes.length]! +\n      (index === longitudes.length - 1 ? 360 : 0);\n    if (next - longitudes[index]! > gap) {\n      gap = next - longitudes[index]!;\n      start = (index + 1) % longitudes.length;\n    }\n  }\n  const normalize = (lng: number) => (lng > 180 ? lng - 360 : lng);\n  return {\n    north: Math.max(...points.map((point) => point.lat)),\n    south: Math.min(...points.map((point) => point.lat)),\n    west: normalize(longitudes[start]!),\n    east: normalize(\n      longitudes[(start + longitudes.length - 1) % longitudes.length]!,\n    ),\n  };\n}\n"],
-  "mappings": ";AAGO,SAAS,iBAAiB,OAA2C;AAC1E,SACE,CAAC,CAAC,SACF,OAAO,SAAS,MAAM,GAAG,KACzB,OAAO,SAAS,MAAM,GAAG,KACzB,KAAK,IAAI,MAAM,GAAG,KAAK,MACvB,KAAK,IAAI,MAAM,GAAG,KAAK;AAE3B;AACO,SAAS,gBAAgB,UAAoB;AAClD,SAAO,SAAS;AAAA,IACd,CAAC,WACC,iBAAiB,OAAO,WAAW;AAAA,EACvC;AACF;AACO,SAAS,aAAa,UAAoB,UAAwB;AACvE,QAAM,SAAS,gBAAgB,QAAQ,EAAE,IAAI,CAAC,WAAW,OAAO,WAAW;AAC3E,MAAI,iBAAiB,QAAQ,GAAG;AAC9B,WAAO,KAAK,QAAQ;AAAA,EACtB;AACA,MAAI,CAAC,OAAO,QAAQ;AAClB,WAAO;AAAA,EACT;AAEA,QAAM,aAAa,OAChB,IAAI,CAAC,WAAW,MAAM,MAAM,OAAO,GAAG,EACtC,KAAK,CAAC,GAAG,MAAM,IAAI,CAAC;AACvB,MAAI,MAAM;AACV,MAAI,QAAQ;AACZ,WAAS,QAAQ,GAAG,QAAQ,WAAW,QAAQ,SAAS;AACtD,UAAM,OACJ,YAAY,QAAQ,KAAK,WAAW,MAAM,KACzC,UAAU,WAAW,SAAS,IAAI,MAAM;AAC3C,QAAI,OAAO,WAAW,KAAK,IAAK,KAAK;AACnC,YAAM,OAAO,WAAW,KAAK;AAC7B,eAAS,QAAQ,KAAK,WAAW;AAAA,IACnC;AAAA,EACF;AACA,QAAM,YAAY,CAAC,QAAiB,MAAM,MAAM,MAAM,MAAM;AAC5D,SAAO;AAAA,IACL,OAAO,KAAK,IAAI,GAAG,OAAO,IAAI,CAAC,UAAU,MAAM,GAAG,CAAC;AAAA,IACnD,OAAO,KAAK,IAAI,GAAG,OAAO,IAAI,CAAC,UAAU,MAAM,GAAG,CAAC;AAAA,IACnD,MAAM,UAAU,WAAW,KAAK,CAAE;AAAA,IAClC,MAAM;AAAA,MACJ,YAAY,QAAQ,WAAW,SAAS,KAAK,WAAW,MAAM;AAAA,IAChE;AAAA,EACF;AACF;",
+  "sourcesContent": ["import type { Branch } from \"@zappie/sdk\";\n\nexport type Coordinates = { lat: number; lng: number };\nexport type Bounds = {\n  north: number;\n  south: number;\n  east: number;\n  west: number;\n};\n\nexport function validCoordinates(value?: Coordinates): value is Coordinates {\n  return (\n    !!value &&\n    Number.isFinite(value.lat) &&\n    Number.isFinite(value.lng) &&\n    Math.abs(value.lat) <= 90 &&\n    Math.abs(value.lng) <= 180\n  );\n}\n\n/** Branches with a real location. (0, 0) is the placeholder for \"no location on file\". */\nexport function visibleBranches(branches: Branch[]) {\n  return branches.filter(\n    (branch): branch is Branch & { coordinates: Coordinates } =>\n      validCoordinates(branch.coordinates) &&\n      (branch.coordinates.lat !== 0 || branch.coordinates.lng !== 0),\n  );\n}\n"],
+  "mappings": ";AAUO,SAAS,iBAAiB,OAA2C;AAC1E,SACE,CAAC,CAAC,SACF,OAAO,SAAS,MAAM,GAAG,KACzB,OAAO,SAAS,MAAM,GAAG,KACzB,KAAK,IAAI,MAAM,GAAG,KAAK,MACvB,KAAK,IAAI,MAAM,GAAG,KAAK;AAE3B;AAGO,SAAS,gBAAgB,UAAoB;AAClD,SAAO,SAAS;AAAA,IACd,CAAC,WACC,iBAAiB,OAAO,WAAW,MAClC,OAAO,YAAY,QAAQ,KAAK,OAAO,YAAY,QAAQ;AAAA,EAChE;AACF;",
   "names": []
 }