@mailwoman/react 10.0.0 → 10.2.0

package/out/map/fake-runtime.js

@@ -2,13 +2,10 @@
  * @copyright Sister Software
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
- *
- *   A fake geocoder runtime: canned parse + resolve, an offline stub map style, canned autocomplete, a version list.
- *   No network, no ONNX, no maplibre at run time — everything is data. It is what the stories and component tests
- *   mount, and what a host mounts to show the UI without the model.
  */
 /**
- * An offline stub map style — one solid `background` layer, zero sources, zero network. Safe for headless Storybook.
+ * Defines an offline map style with a single background layer and no sources,
+ * so it renders in headless Storybook without network access.
  */
 export const STUB_MAP_STYLE = {
     version: 8,
@@ -25,11 +22,11 @@ export const FAKE_SUGGESTIONS = [
     { value: "Newark", placetype: "locality" },
 ];
 /**
- * A fake DEMO runtime — the map analogue of {@link makePipelineRuntime}. It composes the pipeline fake (canned
- * parse+resolve) with the map surface: the offline stub style, a version list, a backend, an injected autocomplete, and
- * a `resolveMapPlace` that hands the selected candidate a bbox so the declarative overlays draw a marker + outline. No
- * network, no ONNX, no maplibre-at-runtime — everything is data. `runParseWithBias` delegates to the base parse (the
- * bias is ignored by the fake but present so the parameter is exercised).
+ * Creates an offline {@link GeocoderRuntime} that extends {@link makePipelineRuntime}
+ * with the stub style, canned suggestions and versions.
+ *
+ * It also provides `resolveMapPlace` that gives the candidate a bounding box so overlays draw.
+ * The fake ignores the bias passed to `runParseWithBias`.
  */
 export function makeFakeGeocoderRuntime(overrides = {}) {
     const base = makePipelineRuntime();
@@ -48,10 +45,7 @@ export function makeFakeGeocoderRuntime(overrides = {}) {
         ],
         selectedVersion: "v7.2.0",
         selectVersion: () => { },
-        activeBackend: "webgpu (28 MB int8)",
-        forceWASM: false,
-        setForceWASM: () => { },
-        // Enrich the selected candidate with a bbox so an outline renders (case 4: bbox → approximate circle + fit).
+        activeBackend: "wasm (28 MB int8)",
         resolveMapPlace: (candidate) => ({
             ...candidate,
             bbox: {
@@ -65,7 +59,8 @@ export function makeFakeGeocoderRuntime(overrides = {}) {
     };
 }
 /**
- * A fixed, fully-populated parse+resolve result — the shared fixture behind the pipeline runtime + the result panel.
+ * Creates a fixed, fully populated parse-and-resolve result for the given input,
+ * shared by the fake pipeline runtime and result-panel fixtures.
  */
 export function makeFakeParseResult(input = "350 5th Ave, New York, NY 10118") {
     return {
@@ -74,17 +69,48 @@ export function makeFakeParseResult(input = "350 5th Ave, New York, NY 10118") {
         nodes: [
             { tag: "house_number", value: "350", confidence: 0.97, start: 0, end: 3 },
             { tag: "street", value: "5th Ave", confidence: 0.88, start: 4, end: 11 },
-            { tag: "locality", value: "New York", confidence: 0.71 },
+            { tag: "locality", value: "New York", confidence: 0.71, start: null, end: null },
         ],
         kindResult: { kind: "structured_address", confidence: 0.95, alternatives: [] },
         timing: { shape: 0.4, classify: 12.1, resolve: 4.2 },
-        resolved: { id: 85_977_539, name: "New York", placetype: "locality", lat: 40.7128, lon: -74.006, score: 0.82 },
+        resolved: {
+            id: 85_977_539,
+            name: "New York",
+            placetype: "locality",
+            lat: 40.7128,
+            lon: -74.006,
+            score: 0.82,
+            bbox: null,
+            tier: null,
+            uncertaintyM: null,
+        },
         candidates: [
-            { id: 85_977_539, name: "New York", placetype: "locality", lat: 40.7128, lon: -74.006, score: 0.82 },
-            { id: 101_715_829, name: "New York", placetype: "region", lat: 43, lon: -75, score: 0.55 },
+            {
+                id: 85_977_539,
+                name: "New York",
+                placetype: "locality",
+                lat: 40.7128,
+                lon: -74.006,
+                score: 0.82,
+                bbox: null,
+                tier: null,
+                uncertaintyM: null,
+            },
+            {
+                id: 101_715_829,
+                name: "New York",
+                placetype: "region",
+                lat: 43,
+                lon: -75,
+                score: 0.55,
+                bbox: null,
+                tier: null,
+                uncertaintyM: null,
+            },
         ],
         fstActive: true,
         fstProvenance: { builtAt: "2026-07-01T00:00:00Z", stateCount: 51, placeCount: 94_000, importanceMatches: 12_000 },
+        dualRoles: null,
     };
 }
 /**

package/out/map/fake-runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"fake-runtime.js","sourceRoot":"","sources":["../../lib/map/fake-runtime.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fake-runtime.js","sourceRoot":"","sources":["../../lib/map/fake-runtime.ts"],"names":[],"mappings":"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"}

package/out/map/geometry.d.ts

@@ -2,19 +2,8 @@
  * @copyright Sister Software
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
- *
- *   Pure map geometry for the geocoder demo — the resolved-place outline math, lifted verbatim from the
- *   docs demo's `_map-helpers.ts`. Zero imports: no React, no `react-map-gl`, no `maplibre-gl`, no DOM.
- *   Every function takes plain numbers and returns plain GeoJSON, so the whole module runs (and is
- *   tested) under bare node — see `geometry.node.test.ts`.
- *
- *   WHY NOT `@mailwoman/spatial`: the only truly-spatial primitive here is the bbox half-diagonal (a
- *   great-circle-ish distance). `@mailwoman/spatial` exposes `haversineKm`, but ONLY via its root barrel,
- *   which pulls `@mailwoman/core` + `h3-js` + `wkx` — a heavy, partly node-only graph — into what must
- *   stay a lightweight, browser-only map bundle (the `@mailwoman/react/map` subpath). The original
- *   `_map-helpers.ts` made the same call: a planar `kmPerDeg` approximation, local, no dependency. We
- *   preserve it so the ported behavior is byte-identical and the browser graph stays clean.
  */
+import type { LatLonBounds } from "@mailwoman/spatial";
 /**
  * A GeoJSON Polygon / MultiPolygon — what the polygon DB stores and the map draws as the place outline.
  */
@@ -25,39 +14,29 @@ export type PlaceGeometry = {
     type: "MultiPolygon";
     coordinates: number[][][][];
 };
-/**
- * A place bounding box in the demo's object form (the WOF points DB carries only these four numbers).
- */
-export interface PlaceBBox {
-    minLat: number;
-    maxLat: number;
-    minLon: number;
-    maxLon: number;
-}
 /**
  * A `[west, south, east, north]` → `[[minLon, minLat], [maxLon, maxLat]]` pair, the shape `fitBounds` wants.
  */
 export type BoundsTuple = [[number, number], [number, number]];
 /**
- * Approximate-extent circle for places without a crisp polygon: centered on the place point, radius from the bbox
- * half-diagonal (clamped 0.5–50 km). 64-point ring with latitude correction — visually a circle anywhere outside the
- * poles. With no bbox (anchor-centroid postcodes carry no extent) it defaults to a ~ZIP-sized 3 km radius.
+ * Returns a circle approximating the extent of a place that has no polygon, with a radius
+ * of half the bbox diagonal clamped to 0.5–50 km, or 3 km when there is no bbox.
  */
-export declare function approxCircleGeometry(lat: number, lon: number, bbox?: PlaceBBox): PlaceGeometry;
+export declare function approxCircleGeometry(lat: number, lon: number, bbox?: LatLonBounds): PlaceGeometry;
 /**
- * A circle of an EXACT radius in meters — for the street-level uncertainty (#377): a 10 m situs floor or a calibrated
- * interp radius. Unlike {@link approxCircleGeometry} (clamped to a ~ZIP-sized 0.5 km floor for admin fallbacks), this
- * honors small radii so an exact building reads as a tight dot (an ~8 m floor keeps a 10 m situs circle visible).
+ * Returns a circle with the given radius in meters for street-level uncertainty, floored at 8 m
+ * so that a precise point stays visible, unlike {@link approxCircleGeometry}'s 0.5 km floor.
  */
 export declare function radiusCircleGeometry(lat: number, lon: number, radiusM: number): PlaceGeometry;
 /**
- * Bounding box of a Polygon / MultiPolygon, for `fitBounds`. Walks the nested coordinate arrays, so it handles both a
- * single-ring polygon and a multi-part polygon uniformly. Antimeridian-crossing geometry is NOT normalized (the naive
- * min/max is returned) — matching the ported behavior; callers that need a wrapped bbox must handle it upstream.
+ * Returns the bounding box of a Polygon or MultiPolygon for `fitBounds`.
+ *
+ * Geometry that crosses the antimeridian gets a naive min/max box, so callers
+ * that need a wrapped box must handle it themselves.
  */
-export declare function geomBounds(geometry: PlaceGeometry): PlaceBBox;
+export declare function geomBounds(geometry: PlaceGeometry): LatLonBounds;
 /**
- * Reshape a {@link PlaceBBox} into the `[[minLon, minLat], [maxLon, maxLat]]` pair `fitBounds` expects.
+ * Reshape a {@link LatLonBounds} into the `[[minLon, minLat], [maxLon, maxLat]]` pair `fitBounds` expects.
  */
-export declare function bboxToBounds(bbox: PlaceBBox): BoundsTuple;
+export declare function bboxToBounds(bbox: LatLonBounds): BoundsTuple;
 //# sourceMappingURL=geometry.d.ts.map

package/out/map/geometry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../../lib/map/geometry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAYH;;GAEG;AACH,MAAM,MAAM,aAAa,GACtB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAA;CAAE,CAAA;AAExD;;GAEG;AACH,MAAM,WAAW,SAAS;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;AAyB9D;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,SAAS,GAAG,aAAa,CAQ9F;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa,CAI7F;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,aAAa,GAAG,SAAS,CAwC7D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,WAAW,CAKzD"}
+{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../../lib/map/geometry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAMtD;;GAEG;AACH,MAAM,MAAM,aAAa,GACtB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAA;CAAE,CAAA;AAExD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;AAmB9D;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,aAAa,CAQjG;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa,CAI7F;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,aAAa,GAAG,YAAY,CAwChE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,WAAW,CAK5D"}

package/out/map/geometry.js

@@ -2,36 +2,12 @@
  * @copyright Sister Software
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
- *
- *   Pure map geometry for the geocoder demo — the resolved-place outline math, lifted verbatim from the
- *   docs demo's `_map-helpers.ts`. Zero imports: no React, no `react-map-gl`, no `maplibre-gl`, no DOM.
- *   Every function takes plain numbers and returns plain GeoJSON, so the whole module runs (and is
- *   tested) under bare node — see `geometry.node.test.ts`.
- *
- *   WHY NOT `@mailwoman/spatial`: the only truly-spatial primitive here is the bbox half-diagonal (a
- *   great-circle-ish distance). `@mailwoman/spatial` exposes `haversineKm`, but ONLY via its root barrel,
- *   which pulls `@mailwoman/core` + `h3-js` + `wkx` — a heavy, partly node-only graph — into what must
- *   stay a lightweight, browser-only map bundle (the `@mailwoman/react/map` subpath). The original
- *   `_map-helpers.ts` made the same call: a planar `kmPerDeg` approximation, local, no dependency. We
- *   preserve it so the ported behavior is byte-identical and the browser graph stays clean.
- */
-/**
- * Segments used to approximate a circle as a polygon ring.
  */
 const CIRCLE_SEGMENTS = 64;
-/**
- * Mean km per degree of latitude (WGS84 average).
- */
 const KM_PER_DEG_LAT = 111.32;
-/**
- * Km per degree of longitude at a given latitude — the meridians converge toward the poles.
- */
 function kmPerDegLon(lat) {
     return KM_PER_DEG_LAT * Math.cos((lat * Math.PI) / 180);
 }
-/**
- * A closed 64-segment (65-point) GeoJSON ring of `radiusKM` around `[lon, lat]`, with latitude correction.
- */
 function circleRing(lat, lon, radiusKM) {
     const perLon = kmPerDegLon(lat);
     const ring = [];
@@ -42,9 +18,8 @@ function circleRing(lat, lon, radiusKM) {
     return ring;
 }
 /**
- * Approximate-extent circle for places without a crisp polygon: centered on the place point, radius from the bbox
- * half-diagonal (clamped 0.5–50 km). 64-point ring with latitude correction — visually a circle anywhere outside the
- * poles. With no bbox (anchor-centroid postcodes carry no extent) it defaults to a ~ZIP-sized 3 km radius.
+ * Returns a circle approximating the extent of a place that has no polygon, with a radius
+ * of half the bbox diagonal clamped to 0.5–50 km, or 3 km when there is no bbox.
  */
 export function approxCircleGeometry(lat, lon, bbox) {
     const halfDiagKm = bbox
@@ -54,18 +29,18 @@ export function approxCircleGeometry(lat, lon, bbox) {
     return { type: "Polygon", coordinates: [circleRing(lat, lon, radiusKM)] };
 }
 /**
- * A circle of an EXACT radius in meters — for the street-level uncertainty (#377): a 10 m situs floor or a calibrated
- * interp radius. Unlike {@link approxCircleGeometry} (clamped to a ~ZIP-sized 0.5 km floor for admin fallbacks), this
- * honors small radii so an exact building reads as a tight dot (an ~8 m floor keeps a 10 m situs circle visible).
+ * Returns a circle with the given radius in meters for street-level uncertainty, floored at 8 m
+ * so that a precise point stays visible, unlike {@link approxCircleGeometry}'s 0.5 km floor.
  */
 export function radiusCircleGeometry(lat, lon, radiusM) {
     const radiusKM = Math.max(0.008, radiusM / 1000);
     return { type: "Polygon", coordinates: [circleRing(lat, lon, radiusKM)] };
 }
 /**
- * Bounding box of a Polygon / MultiPolygon, for `fitBounds`. Walks the nested coordinate arrays, so it handles both a
- * single-ring polygon and a multi-part polygon uniformly. Antimeridian-crossing geometry is NOT normalized (the naive
- * min/max is returned) — matching the ported behavior; callers that need a wrapped bbox must handle it upstream.
+ * Returns the bounding box of a Polygon or MultiPolygon for `fitBounds`.
+ *
+ * Geometry that crosses the antimeridian gets a naive min/max box, so callers
+ * that need a wrapped box must handle it themselves.
  */
 export function geomBounds(geometry) {
     let minLon = Infinity;
@@ -100,7 +75,7 @@ export function geomBounds(geometry) {
     return { minLon, minLat, maxLon, maxLat };
 }
 /**
- * Reshape a {@link PlaceBBox} into the `[[minLon, minLat], [maxLon, maxLat]]` pair `fitBounds` expects.
+ * Reshape a {@link LatLonBounds} into the `[[minLon, minLat], [maxLon, maxLat]]` pair `fitBounds` expects.
  */
 export function bboxToBounds(bbox) {
     return [

package/out/map/geometry.js.map

@@ -1 +1 @@
-{"version":3,"file":"geometry.js","sourceRoot":"","sources":["../../lib/map/geometry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"geometry.js","sourceRoot":"","sources":["../../lib/map/geometry.ts"],"names":[],"mappings":"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"}

package/out/map/graticule.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   The graticule's geometry, apart from its component — the same split `place-render.ts` keeps from
+ *   `ResolvedPlaceLayers.tsx`. Pure and node-testable; `#*` resolves `.ts` only, so this is also the file the test can
+ *   import.
+ */
+import type { FeatureCollection, MultiLineString } from "geojson";
+/**
+ * Build the graticule as one MultiLineString.
+ *
+ * Pure — same step, same geometry — so it is built once at module scope and never rebuilt for a render.
+ */
+export declare function buildGraticule(stepDegrees?: number): FeatureCollection<MultiLineString>;
+//# sourceMappingURL=graticule.d.ts.map

package/out/map/graticule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graticule.d.ts","sourceRoot":"","sources":["../../lib/map/graticule.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAgCjE;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,WAAW,GAAE,MAA6B,GAAG,iBAAiB,CAAC,eAAe,CAAC,CAgC7G"}

package/out/map/graticule.js

@@ -0,0 +1,67 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   The graticule's geometry, apart from its component — the same split `place-render.ts` keeps from
+ *   `ResolvedPlaceLayers.tsx`. Pure and node-testable; `#*` resolves `.ts` only, so this is also the file the test can
+ *   import.
+ */
+/**
+ * Degrees between grid lines. 15° is one hour of longitude — twelve meridians and eleven
+ * parallels, dense enough to read as a globe and sparse enough not to read as graph paper.
+ */
+const DEFAULT_STEP_DEGREES = 15;
+/**
+ * Degrees between vertices along each line.
+ *
+ * A meridian drawn as two points is a straight chord through the sphere under a globe projection.
+ * It has to be densified to curve. 2° keeps the longest line under 100 vertices.
+ */
+/**
+ * The antimeridian, in degrees.
+ *
+ * Longitude runs [-180, 180]; meridians are drawn from the first bound up to but not including
+ * the second, because -180 and 180 are the same line and drawing both puts two strokes on one pixel.
+ */
+const MAX_LONGITUDE = 180;
+const VERTEX_STEP_DEGREES = 2;
+/**
+ * The latitude the parallels stop at.
+ *
+ * Past ~85° the meridians have converged close enough that more rings read as a smudge at the pole.
+ * Web Mercator's own limit is 85.051129.
+ */
+const MAX_LATITUDE = 85;
+/**
+ * Build the graticule as one MultiLineString.
+ *
+ * Pure — same step, same geometry — so it is built once at module scope and never rebuilt for a render.
+ */
+export function buildGraticule(stepDegrees = DEFAULT_STEP_DEGREES) {
+    const lines = [];
+    // Meridians: constant longitude, walking latitude pole to pole.
+    for (let lon = -MAX_LONGITUDE; lon < MAX_LONGITUDE; lon += stepDegrees) {
+        const line = [];
+        for (let lat = -MAX_LATITUDE; lat <= MAX_LATITUDE; lat += VERTEX_STEP_DEGREES) {
+            line.push([lon, lat]);
+        }
+        line.push([lon, MAX_LATITUDE]);
+        lines.push(line);
+    }
+    // Parallels: constant latitude, walking longitude all the way round.
+    // The equator is included.
+    // The poles are not.
+    for (let lat = -MAX_LATITUDE + stepDegrees; lat < MAX_LATITUDE; lat += stepDegrees) {
+        const line = [];
+        for (let lon = -MAX_LONGITUDE; lon <= MAX_LONGITUDE; lon += VERTEX_STEP_DEGREES) {
+            line.push([lon, lat]);
+        }
+        lines.push(line);
+    }
+    return {
+        type: "FeatureCollection",
+        features: [{ type: "Feature", properties: {}, geometry: { type: "MultiLineString", coordinates: lines } }],
+    };
+}
+//# sourceMappingURL=graticule.js.map

package/out/map/graticule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graticule.js","sourceRoot":"","sources":["../../lib/map/graticule.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;GAGG;AACH,MAAM,oBAAoB,GAAG,EAAE,CAAA;AAE/B;;;;;GAKG;AACH;;;;;GAKG;AACH,MAAM,aAAa,GAAG,GAAG,CAAA;AAEzB,MAAM,mBAAmB,GAAG,CAAC,CAAA;AAE7B;;;;;GAKG;AACH,MAAM,YAAY,GAAG,EAAE,CAAA;AAEvB;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,WAAW,GAAW,oBAAoB;IACxE,MAAM,KAAK,GAAiB,EAAE,CAAA;IAE9B,gEAAgE;IAChE,KAAK,IAAI,GAAG,GAAG,CAAC,aAAa,EAAE,GAAG,GAAG,aAAa,EAAE,GAAG,IAAI,WAAW,EAAE,CAAC;QACxE,MAAM,IAAI,GAAe,EAAE,CAAA;QAE3B,KAAK,IAAI,GAAG,GAAG,CAAC,YAAY,EAAE,GAAG,IAAI,YAAY,EAAE,GAAG,IAAI,mBAAmB,EAAE,CAAC;YAC/E,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAA;QACtB,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC,CAAA;QAC9B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACjB,CAAC;IAED,qEAAqE;IACrE,2BAA2B;IAC3B,qBAAqB;IACrB,KAAK,IAAI,GAAG,GAAG,CAAC,YAAY,GAAG,WAAW,EAAE,GAAG,GAAG,YAAY,EAAE,GAAG,IAAI,WAAW,EAAE,CAAC;QACpF,MAAM,IAAI,GAAe,EAAE,CAAA;QAE3B,KAAK,IAAI,GAAG,GAAG,CAAC,aAAa,EAAE,GAAG,IAAI,aAAa,EAAE,GAAG,IAAI,mBAAmB,EAAE,CAAC;YACjF,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAA;QACtB,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACjB,CAAC;IAED,OAAO;QACN,IAAI,EAAE,mBAAmB;QACzB,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,CAAC;KAC1G,CAAA;AACF,CAAC"}

package/out/map/map-debug.d.ts

@@ -5,7 +5,7 @@
  * @file The bare MapLibre control both debug panels portal into.
  *
  *   `DashboardMap`'s inspector and the demo page's `_debug.tsx` panel each need an `IControl` whose
- *   only job is to own a container element for `createPortal`. The class was duplicated in both;
+ *   only job is to own a container element for `createPortal`. The class was duplicated in both.
  *   the position and container class are the only differences, so they are parameters here.
  */
 import type { ControlPosition } from "maplibre-gl";
@@ -16,7 +16,9 @@ export interface DebugControlBaseOptions {
      */
     className?: string;
     /**
-     * Where MapLibre docks the control. @default "bottom-left"
+     * Where MapLibre docks the control.
+     *
+     * @defaultValue `"bottom-left"`
      */
     position?: ControlPosition;
 }

package/out/map/map-debug.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"map-debug.d.ts","sourceRoot":"","sources":["../../lib/map/map-debug.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAElE,MAAM,WAAW,uBAAuB;IACvC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;OAEG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAA;CAC1B;AAED,qBAAa,gBAAiB,YAAW,QAAQ;;IAChD,SAAgB,SAAS,EAAE,WAAW,CAAA;IAGtC,YAAY,EAAE,SAAS,EAAE,QAAwB,EAAE,GAAE,uBAA4B,EAQhF;IAEM,KAAK,CAAC,IAAI,EAAE,WAAW,GAAG,WAAW,CAE3C;IAEM,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAEvC;IAEM,kBAAkB,IAAI,eAAe,CAE3C;CACD"}
+{"version":3,"file":"map-debug.d.ts","sourceRoot":"","sources":["../../lib/map/map-debug.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAElE,MAAM,WAAW,uBAAuB;IACvC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAA;CAC1B;AAED,qBAAa,gBAAiB,YAAW,QAAQ;;IAChD,SAAgB,SAAS,EAAE,WAAW,CAAA;IAGtC,YAAY,EAAE,SAAS,EAAE,QAAwB,EAAE,GAAE,uBAA4B,EAQhF;IAEM,KAAK,CAAC,IAAI,EAAE,WAAW,GAAG,WAAW,CAE3C;IAEM,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAEvC;IAEM,kBAAkB,IAAI,eAAe,CAE3C;CACD"}

package/out/map/map-debug.js

@@ -5,7 +5,7 @@
  * @file The bare MapLibre control both debug panels portal into.
  *
  *   `DashboardMap`'s inspector and the demo page's `_debug.tsx` panel each need an `IControl` whose
- *   only job is to own a container element for `createPortal`. The class was duplicated in both;
+ *   only job is to own a container element for `createPortal`. The class was duplicated in both.
  *   the position and container class are the only differences, so they are parameters here.
  */
 export class DebugControlBase {

package/out/map/map-debug.js.map

@@ -1 +1 @@
-{"version":3,"file":"map-debug.js","sourceRoot":"","sources":["../../lib/map/map-debug.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAgBH,MAAM,OAAO,gBAAgB;IACZ,SAAS,CAAa;IAC7B,SAAS,CAAiB;IAEnC,YAAY,EAAE,SAAS,EAAE,QAAQ,GAAG,aAAa,EAAE,GAA4B,EAAE;QAChF,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAA;QAE9C,IAAI,SAAS,EAAE,CAAC;YACf,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;QACxC,CAAC;QAED,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAA;IAC1B,CAAC;IAEM,KAAK,CAAC,IAAiB;QAC7B,OAAO,IAAI,CAAC,SAAS,CAAA;IACtB,CAAC;IAEM,QAAQ,CAAC,IAAiB;QAChC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAA;IACxB,CAAC;IAEM,kBAAkB;QACxB,OAAO,IAAI,CAAC,SAAS,CAAA;IACtB,CAAC;CACD"}
+{"version":3,"file":"map-debug.js","sourceRoot":"","sources":["../../lib/map/map-debug.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAkBH,MAAM,OAAO,gBAAgB;IACZ,SAAS,CAAa;IAC7B,SAAS,CAAiB;IAEnC,YAAY,EAAE,SAAS,EAAE,QAAQ,GAAG,aAAa,EAAE,GAA4B,EAAE;QAChF,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAA;QAE9C,IAAI,SAAS,EAAE,CAAC;YACf,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;QACxC,CAAC;QAED,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAA;IAC1B,CAAC;IAEM,KAAK,CAAC,IAAiB;QAC7B,OAAO,IAAI,CAAC,SAAS,CAAA;IACtB,CAAC;IAEM,QAAQ,CAAC,IAAiB;QAChC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAA;IACxB,CAAC;IAEM,kBAAkB;QACxB,OAAO,IAAI,CAAC,SAAS,CAAA;IACtB,CAAC;CACD"}

package/out/map/place-render.d.ts

@@ -2,60 +2,45 @@
  * @copyright Sister Software
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
- *
- *   `computeMapPlaceRenderSpec` — the PURE core that replaces the docs demo's ~100-line imperative
- *   marker/bbox/camera redraw effect (`_app.tsx:601-705`). It takes an ALREADY-RESOLVED place (the async
- *   polygon-DB fetch is a host/runtime concern — a later phase — so a crisp polygon arrives pre-fetched
- *   as `place.geometry`) and returns a declarative render spec: the marker position(s), the outline
- *   geometry to draw, and the camera target. No map instance, no DOM, no `react-map-gl` — so it is
- *   node-testable (see `place-render.node.test.ts`). The declarative components in this folder render
- *   the spec; a controlled-viewport consumer applies the camera.
- *
- *   The decision cascade is a faithful, side-effect-free transcription of the imperative effect:
- *     1. street tier (situs / interp)  → exact-radius circle, fly to a tight zoom
- *     2. crisp admin polygon (pre-fetched) → draw the polygon, fit its bounds
- *     3. anchor-centroid postcode (no bbox) → ~3 km "around here" circle, fly to zoom 11
- *     4. bbox with real extent            → bbox-sized approximate circle, fit the bbox
- *     5. bare point                       → no outline, fly to zoom 12
  */
 import type { ResolvedPlaceView } from "@mailwoman/core/pipeline/client-result";
-import type { BoundsTuple, PlaceBBox, PlaceGeometry } from "#map/geometry";
+import type { LatLonBounds } from "@mailwoman/spatial";
+import type { BoundsTuple, PlaceGeometry } from "#map/geometry";
 /**
- * `[longitude, latitude]`.
+ * A coordinate pair as `[longitude, latitude]`.
  */
 export type LngLat = [number, number];
 /**
- * The street-level resolution tier (#377): `address_point` = exact building; `interpolated` = TIGER estimate.
+ * How a street-level result was located: `address_point` is an exact building point
+ * and `interpolated` an estimate from a TIGER address range.
  */
 export type PlaceTier = "address_point" | "interpolated";
 /**
- * The resolved-place shape the map render consumes — the pipeline {@link ResolvedPlaceView} plus the map-only extras the
- * demo's `ResolvedHit` carries (bbox, street tier + uncertainty), and an optional PRE-FETCHED crisp polygon. Extending
- * `ResolvedPlaceView` keeps the map render aligned with the shared parse result; the extras are additive.
+ * A resolved place with the extra fields the map uses to draw it.
  */
 export interface ResolvedMapPlace extends ResolvedPlaceView {
     /**
-     * The place's bounding box, when the gazetteer carries one (admin places). Absent for anchor-centroid postcodes.
+     * The place's bounding box.
+     * Postcodes located by an anchor centroid have none.
      */
-    bbox?: PlaceBBox;
+    bbox: LatLonBounds | null;
     /**
-     * Street-level tier, when this hit came from the situs/interp tier rather than the WOF admin cascade.
+     * The street-level tier, set only for results from address points or interpolation.
      */
-    tier?: PlaceTier;
+    tier: PlaceTier | null;
     /**
-     * Honest uncertainty radius in meters for a street-level tier (10 m situs floor; calibrated interp).
+     * The uncertainty radius in meters of a street-level result, drawn as a circle when `tier` is set.
      */
-    uncertaintyM?: number;
+    uncertaintyM: number | null;
     /**
-     * The crisp admin polygon, when the host has ALREADY fetched it from the sibling polygon DB. Its presence drives the
-     * polygon path; the async fetch itself stays out of this pure function (a runtime concern in a later phase).
+     * The admin polygon, if the host has already fetched it.
+     * When present the outline and camera follow it.
      */
     geometry?: PlaceGeometry;
 }
 /**
- * The camera target the render computes. `center` (fly to a point at a zoom) HAS a declarative equivalent — a consumer
- * can feed it to a controlled `viewState` (see {@link cameraToViewState}). `bounds` (fit a box with pixel padding) does
- * NOT — `fitBounds` needs the map's pixel dimensions, so it is applied imperatively by `<ResultCamera>`.
+ * Only a `center` target can be applied declaratively through {@link cameraToViewState};
+ * fitting bounds needs the map's pixel size, so `<ResultCamera>` applies it imperatively.
  */
 export type MapCameraTarget = {
     kind: "center";
@@ -67,33 +52,28 @@ export type MapCameraTarget = {
     padding: number;
 };
 /**
- * The declarative render spec for one resolved place — the pure output of {@link computeMapPlaceRenderSpec}.
+ * The markers, outline and camera target for one resolved place, as returned
+ * by {@link computeMapPlaceRenderSpec}.
  */
 export interface MapPlaceRenderSpec {
     /**
-     * Marker position(s) as `[lon, lat]`. Single-element today; an array leaves room for multi-marker later.
+     * The marker positions as `[lon, lat]`; there is always exactly one marker.
      */
     markers: LngLat[];
     /**
-     * The outline geometry (polygon / circle) to draw, or `null` when the place renders as a bare point.
+     * The polygon or circle outline to draw, or `null` when the place renders as a bare point.
      */
     outline: PlaceGeometry | null;
-    /**
-     * The camera target — animate or fit to this.
-     */
     camera: MapCameraTarget;
 }
 /**
- * Map a resolved place to its declarative render spec. Pure — same input, same output, no side effects. The `place`
- * arrives fully resolved (crisp polygon pre-fetched into `place.geometry` when available), so this is the honest
- * inverse of the old redraw effect with the imperative map mutation and the async DB load removed.
+ * Computes the markers, outline and camera target for a resolved place without loading data,
+ * so the caller must put any fetched polygon in `place.geometry` first.
  */
 export declare function computeMapPlaceRenderSpec(place: ResolvedMapPlace): MapPlaceRenderSpec;
 /**
- * The DECLARATIVE camera path: reshape a `center` target into a `viewState` patch a controlled `<MapCanvas viewState>`
- * can apply directly (a hard jump, no animation). Returns `null` for a `bounds` target — fitting a box to the viewport
- * needs the map's pixel dimensions, which only the live map has, so that case is applied imperatively by
- * `<ResultCamera>`. Pure + node-testable.
+ * Converts a `center` camera target into a `viewState` patch for a controlled `<MapCanvas>`,
+ * returning `null` for a `bounds` target that `<ResultCamera>` must fit imperatively.
  */
 export declare function cameraToViewState(camera: MapCameraTarget): {
     longitude: number;

package/out/map/place-render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"place-render.d.ts","sourceRoot":"","sources":["../../lib/map/place-render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAA;AAG/E,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAE1E;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAErC;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,eAAe,GAAG,cAAc,CAAA;AAExD;;;;GAIG;AACH,MAAM,WAAW,gBAAiB,SAAQ,iBAAiB;IAC1D;;OAEG;IACH,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB;;OAEG;IACH,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;;OAGG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAA;CACxB;AAED;;;;GAIG;AACH,MAAM,MAAM,eAAe,GACxB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAE3D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC;;OAEG;IACH,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB;;OAEG;IACH,OAAO,EAAE,aAAa,GAAG,IAAI,CAAA;IAC7B;;OAEG;IACH,MAAM,EAAE,eAAe,CAAA;CACvB;AAsBD;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,gBAAgB,GAAG,kBAAkB,CAsDrF;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAChC,MAAM,EAAE,eAAe,GACrB;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAI9D"}
+{"version":3,"file":"place-render.d.ts","sourceRoot":"","sources":["../../lib/map/place-render.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAA;AAC/E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAGtD,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAE/D;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAErC;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,eAAe,GAAG,cAAc,CAAA;AAExD;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,iBAAiB;IAC1D;;;OAGG;IACH,IAAI,EAAE,YAAY,GAAG,IAAI,CAAA;IAEzB;;OAEG;IACH,IAAI,EAAE,SAAS,GAAG,IAAI,CAAA;IAEtB;;OAEG;IACH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAE3B;;;OAGG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAA;CACxB;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,GACxB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAE3D;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IAClC;;OAEG;IACH,OAAO,EAAE,MAAM,EAAE,CAAA;IAEjB;;OAEG;IACH,OAAO,EAAE,aAAa,GAAG,IAAI,CAAA;IAE7B,MAAM,EAAE,eAAe,CAAA;CACvB;AAaD;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,gBAAgB,GAAG,kBAAkB,CA8CrF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAChC,MAAM,EAAE,eAAe,GACrB;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAI9D"}