@fieldia/map 0.16.0 → 0.17.0

package/src/lib/reach.js

@@ -0,0 +1,158 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.insideRing = insideRing;
+exports.insideArea = insideArea;
+exports.formAreas = formAreas;
+const geo_1 = require("./geo");
+const map_core_1 = require("./map-core");
+/**
+ * A form's map's areas that follow its places: the area within some minutes
+ * of a place, asked of the map's provider (or the app) and asked again once
+ * the place has moved far enough; and its fences, the areas fields hold drawn
+ * faintly, each fence's steps run when the place it watches goes into its
+ * area or comes out of it — never at first sight, when it was there already.
+ * Loaded with the first map that has either.
+ */
+/** A reachable area is asked for again once its place has moved this far, in metres, and at most this often. */
+const REACH_MOVE_M = 250;
+const REACH_EVERY_MS = 10_000;
+/** Whether a place is inside a ring of places: a line from it crosses the ring's edges an odd number of times. */
+function insideRing(at, ring) {
+    let odd = false;
+    for (let i = 0, j = ring.length - 1; i < ring.length; j = i++) {
+        const [a, b] = [ring[i], ring[j]];
+        if (a.lat > at.lat !== b.lat > at.lat && at.lng < ((b.lng - a.lng) * (at.lat - a.lat)) / (b.lat - a.lat) + a.lng)
+            odd = !odd;
+    }
+    return odd;
+}
+/** Whether a place is inside an area as an area field keeps it: within a circle's radius, or inside a polygon or a box. */
+function insideArea(at, area) {
+    return area.shape === 'circle' ? (0, geo_1.metresBetween)(area.center, at) <= area.radius : insideRing(at, area.points);
+}
+function formAreas(options) {
+    const { node, map, L } = options;
+    const reaches = new Map();
+    /** Whether each fence's place was inside its area when last seen. */
+    const insideNow = new Map();
+    const fenceShapes = new Map();
+    let gone = false;
+    let last = null;
+    // Their own pane: over areas by colour, under routes and pins.
+    if (!map.getPane('fd-reach'))
+        map.createPane('fd-reach').style.zIndex = '390';
+    function drawReaches(positionOf, hidden) {
+        for (const layer of node.layers) {
+            const spec = layer.reachable;
+            if (!spec)
+                continue;
+            let state = reaches.get(layer.id);
+            if (!state)
+                reaches.set(layer.id, (state = { asking: 0, askedAt: 0 }));
+            const from = positionOf(spec.from);
+            if (!from || hidden(layer.id)) {
+                state.drawn?.remove();
+                state.drawn = undefined;
+                continue;
+            }
+            const moved = !state.at || ((0, geo_1.metresBetween)(state.at, from) > REACH_MOVE_M && Date.now() - state.askedAt > REACH_EVERY_MS);
+            if (moved)
+                ask(layer.id, state, from, spec.minutes, spec.mode ?? 'car');
+            if (state.found && !state.drawn) {
+                state.drawn = L.polygon(state.found.rings.map((ring) => ring.map((p) => [p.lat, p.lng])), { className: 'fd-map-reach', pane: 'fd-reach', interactive: false }).addTo(map);
+            }
+        }
+    }
+    function ask(id, state, at, minutes, mode) {
+        state.at = at;
+        state.askedAt = Date.now();
+        if (!options.finder) {
+            (0, map_core_1.warnOnce)(`The map's provider (${options.provider}) works out no reachable areas: give the maps a reach function of the app's own, or use Azure Maps or Mapbox.`);
+            return;
+        }
+        state.abort?.abort();
+        const abort = new AbortController();
+        state.abort = abort;
+        const asked = ++state.asking;
+        options.finder({ at, minutes, mode, signal: abort.signal }).then((found) => {
+            if (gone || asked !== state.asking)
+                return;
+            const first = !state.found;
+            state.found = found;
+            state.drawn?.remove();
+            state.drawn = undefined;
+            if (last)
+                areas.update(...last);
+            options.found(first, found.rings.flat());
+        }, (error) => {
+            if (gone || abort.signal.aborted)
+                return;
+            (0, map_core_1.warnOnce)(`The reachable area "${id}" was not found: ${error instanceof Error ? error.message : String(error)}`);
+        });
+    }
+    /** The areas fields hold that fences watch, drawn faintly so the person sees where steps will run. */
+    function drawFenceAreas(values) {
+        for (const name of new Set((node.fences ?? []).flatMap((fence) => (fence.area !== undefined ? [fence.area] : [])))) {
+            const area = (0, geo_1.readArea)(values[name]);
+            const drawn = JSON.stringify(area);
+            const had = fenceShapes.get(name);
+            if (had?.drawn === drawn)
+                continue;
+            had?.path.remove();
+            fenceShapes.delete(name);
+            if (!area)
+                continue;
+            const style = { className: 'fd-map-fence', pane: 'fd-reach', interactive: false };
+            const path = area.shape === 'circle' ? L.circle([area.center.lat, area.center.lng], { ...style, radius: area.radius }) : L.polygon(area.points.map((p) => [p.lat, p.lng]), style);
+            fenceShapes.set(name, { drawn, path: path.addTo(map) });
+        }
+    }
+    function checkFences(values, positionOf) {
+        node.fences?.forEach((fence, i) => {
+            // Where the place is going, not where its pin is gliding.
+            const at = positionOf(fence.layer);
+            if (!at)
+                return;
+            let inside;
+            if (fence.area !== undefined) {
+                const area = (0, geo_1.readArea)(values[fence.area]);
+                if (!area)
+                    return;
+                inside = insideArea(at, area);
+            }
+            else {
+                const found = reaches.get(fence.within)?.found;
+                if (!found)
+                    return;
+                inside = found.rings.some((ring) => insideRing(at, ring));
+            }
+            const was = insideNow.get(i);
+            insideNow.set(i, inside);
+            if (was === undefined || was === inside)
+                return;
+            if (inside === (fence.when === 'enter'))
+                options.run(fence.steps);
+        });
+    }
+    const areas = {
+        update(values, positionOf, hidden) {
+            if (gone)
+                return;
+            last = [values, positionOf, hidden];
+            drawReaches(positionOf, hidden);
+            drawFenceAreas(values);
+            checkFences(values, positionOf);
+        },
+        destroy() {
+            gone = true;
+            for (const state of reaches.values()) {
+                state.abort?.abort();
+                state.drawn?.remove();
+            }
+            for (const shape of fenceShapes.values())
+                shape.path.remove();
+        },
+    };
+    return areas;
+}
+//# sourceMappingURL=reach.js.map

package/src/lib/reach.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reach.js","sourceRoot":"","sources":["../../../../../libs/map/src/lib/reach.ts"],"names":[],"mappings":";;AA8BA,gCAOC;AAGD,gCAEC;AAQD,8BA6HC;AA7KD,+BAAwE;AAExE,yCAAsC;AAGtC;;;;;;;GAOG;AAEH,gHAAgH;AAChH,MAAM,YAAY,GAAG,GAAG,CAAC;AACzB,MAAM,cAAc,GAAG,MAAM,CAAC;AAW9B,kHAAkH;AAClH,SAAgB,UAAU,CAAC,EAAU,EAAE,IAAuB;IAC5D,IAAI,GAAG,GAAG,KAAK,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QAC9D,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,IAAI,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG;YAAE,GAAG,GAAG,CAAC,GAAG,CAAC;IAC/H,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,2HAA2H;AAC3H,SAAgB,UAAU,CAAC,EAAU,EAAE,IAAU;IAC/C,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAA,mBAAa,EAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;AAC/G,CAAC;AAQD,SAAgB,SAAS,CAAC,OAUzB;IACC,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC;IACjC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC9C,qEAAqE;IACrE,MAAM,SAAS,GAAG,IAAI,GAAG,EAAmB,CAAC;IAC7C,MAAM,WAAW,GAAG,IAAI,GAAG,EAAiD,CAAC;IAC7E,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,IAAI,IAAI,GAA2C,IAAI,CAAC;IACxD,+DAA+D;IAC/D,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC;QAAE,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC;IAE9E,SAAS,WAAW,CAAC,UAAyC,EAAE,MAA+B;QAC7F,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC;YAC7B,IAAI,CAAC,IAAI;gBAAE,SAAS;YACpB,IAAI,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAClC,IAAI,CAAC,KAAK;gBAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YACvE,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnC,IAAI,CAAC,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC9B,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;gBACtB,KAAK,CAAC,KAAK,GAAG,SAAS,CAAC;gBACxB,SAAS;YACX,CAAC;YACD,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,IAAA,mBAAa,EAAC,KAAK,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,YAAY,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,OAAO,GAAG,cAAc,CAAC,CAAC;YACzH,IAAI,KAAK;gBAAE,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,CAAC;YACxE,IAAI,KAAK,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;gBAChC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAqB,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAChM,CAAC;QACH,CAAC;IACH,CAAC;IAED,SAAS,GAAG,CAAC,EAAU,EAAE,KAAiB,EAAE,EAAU,EAAE,OAAe,EAAE,IAA6B;QACpG,KAAK,CAAC,EAAE,GAAG,EAAE,CAAC;QACd,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC3B,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACpB,IAAA,mBAAQ,EAAC,uBAAuB,OAAO,CAAC,QAAQ,+GAA+G,CAAC,CAAC;YACjK,OAAO;QACT,CAAC;QACD,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,IAAI,eAAe,EAAE,CAAC;QACpC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;QACpB,MAAM,KAAK,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC;QAC7B,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAC9D,CAAC,KAAK,EAAE,EAAE;YACR,IAAI,IAAI,IAAI,KAAK,KAAK,KAAK,CAAC,MAAM;gBAAE,OAAO;YAC3C,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC;YAC3B,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;YACpB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;YACtB,KAAK,CAAC,KAAK,GAAG,SAAS,CAAC;YACxB,IAAI,IAAI;gBAAE,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;YAChC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC,EACD,CAAC,KAAK,EAAE,EAAE;YACR,IAAI,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO;gBAAE,OAAO;YACzC,IAAA,mBAAQ,EAAC,uBAAuB,EAAE,oBAAoB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClH,CAAC,CACF,CAAC;IACJ,CAAC;IAED,sGAAsG;IACtG,SAAS,cAAc,CAAC,MAAc;QACpC,KAAK,MAAM,IAAI,IAAI,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnH,MAAM,IAAI,GAAG,IAAA,cAAQ,EAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;YACpC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YACnC,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAClC,IAAI,GAAG,EAAE,KAAK,KAAK,KAAK;gBAAE,SAAS;YACnC,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;YACnB,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACzB,IAAI,CAAC,IAAI;gBAAE,SAAS;YACpB,MAAM,KAAK,GAAG,EAAE,SAAS,EAAE,cAAc,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;YAClF,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAqB,CAAC,EAAE,KAAK,CAAC,CAAC;YACtM,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,SAAS,WAAW,CAAC,MAAc,EAAE,UAAyC;QAC5E,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;YAChC,0DAA0D;YAC1D,MAAM,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACnC,IAAI,CAAC,EAAE;gBAAE,OAAO;YAChB,IAAI,MAAe,CAAC;YACpB,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC7B,MAAM,IAAI,GAAG,IAAA,cAAQ,EAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC1C,IAAI,CAAC,IAAI;oBAAE,OAAO;gBAClB,MAAM,GAAG,UAAU,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YAChC,CAAC;iBAAM,CAAC;gBACN,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAgB,CAAC,EAAE,KAAK,CAAC;gBACzD,IAAI,CAAC,KAAK;oBAAE,OAAO;gBACnB,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC;YAC5D,CAAC;YACD,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAC7B,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;YACzB,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,MAAM;gBAAE,OAAO;YAChD,IAAI,MAAM,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC;gBAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACpE,CAAC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,KAAK,GAAc;QACvB,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM;YAC/B,IAAI,IAAI;gBAAE,OAAO;YACjB,IAAI,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;YACpC,WAAW,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YAChC,cAAc,CAAC,MAAM,CAAC,CAAC;YACvB,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAClC,CAAC;QACD,OAAO;YACL,IAAI,GAAG,IAAI,CAAC;YACZ,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;gBACrC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC;gBACrB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;YACxB,CAAC;YACD,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,MAAM,EAAE;gBAAE,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QAChE,CAAC;KACF,CAAC;IACF,OAAO,KAAK,CAAC;AACf,CAAC"}

package/src/lib/reach.mjs

@@ -0,0 +1,153 @@
+import { metresBetween, readArea } from './geo.mjs';
+import { warnOnce } from './map-core.mjs';
+/**
+ * A form's map's areas that follow its places: the area within some minutes
+ * of a place, asked of the map's provider (or the app) and asked again once
+ * the place has moved far enough; and its fences, the areas fields hold drawn
+ * faintly, each fence's steps run when the place it watches goes into its
+ * area or comes out of it — never at first sight, when it was there already.
+ * Loaded with the first map that has either.
+ */
+/** A reachable area is asked for again once its place has moved this far, in metres, and at most this often. */
+const REACH_MOVE_M = 250;
+const REACH_EVERY_MS = 10_000;
+/** Whether a place is inside a ring of places: a line from it crosses the ring's edges an odd number of times. */
+export function insideRing(at, ring) {
+    let odd = false;
+    for (let i = 0, j = ring.length - 1; i < ring.length; j = i++) {
+        const [a, b] = [ring[i], ring[j]];
+        if (a.lat > at.lat !== b.lat > at.lat && at.lng < ((b.lng - a.lng) * (at.lat - a.lat)) / (b.lat - a.lat) + a.lng)
+            odd = !odd;
+    }
+    return odd;
+}
+/** Whether a place is inside an area as an area field keeps it: within a circle's radius, or inside a polygon or a box. */
+export function insideArea(at, area) {
+    return area.shape === 'circle' ? metresBetween(area.center, at) <= area.radius : insideRing(at, area.points);
+}
+export function formAreas(options) {
+    const { node, map, L } = options;
+    const reaches = new Map();
+    /** Whether each fence's place was inside its area when last seen. */
+    const insideNow = new Map();
+    const fenceShapes = new Map();
+    let gone = false;
+    let last = null;
+    // Their own pane: over areas by colour, under routes and pins.
+    if (!map.getPane('fd-reach'))
+        map.createPane('fd-reach').style.zIndex = '390';
+    function drawReaches(positionOf, hidden) {
+        for (const layer of node.layers) {
+            const spec = layer.reachable;
+            if (!spec)
+                continue;
+            let state = reaches.get(layer.id);
+            if (!state)
+                reaches.set(layer.id, (state = { asking: 0, askedAt: 0 }));
+            const from = positionOf(spec.from);
+            if (!from || hidden(layer.id)) {
+                state.drawn?.remove();
+                state.drawn = undefined;
+                continue;
+            }
+            const moved = !state.at || (metresBetween(state.at, from) > REACH_MOVE_M && Date.now() - state.askedAt > REACH_EVERY_MS);
+            if (moved)
+                ask(layer.id, state, from, spec.minutes, spec.mode ?? 'car');
+            if (state.found && !state.drawn) {
+                state.drawn = L.polygon(state.found.rings.map((ring) => ring.map((p) => [p.lat, p.lng])), { className: 'fd-map-reach', pane: 'fd-reach', interactive: false }).addTo(map);
+            }
+        }
+    }
+    function ask(id, state, at, minutes, mode) {
+        state.at = at;
+        state.askedAt = Date.now();
+        if (!options.finder) {
+            warnOnce(`The map's provider (${options.provider}) works out no reachable areas: give the maps a reach function of the app's own, or use Azure Maps or Mapbox.`);
+            return;
+        }
+        state.abort?.abort();
+        const abort = new AbortController();
+        state.abort = abort;
+        const asked = ++state.asking;
+        options.finder({ at, minutes, mode, signal: abort.signal }).then((found) => {
+            if (gone || asked !== state.asking)
+                return;
+            const first = !state.found;
+            state.found = found;
+            state.drawn?.remove();
+            state.drawn = undefined;
+            if (last)
+                areas.update(...last);
+            options.found(first, found.rings.flat());
+        }, (error) => {
+            if (gone || abort.signal.aborted)
+                return;
+            warnOnce(`The reachable area "${id}" was not found: ${error instanceof Error ? error.message : String(error)}`);
+        });
+    }
+    /** The areas fields hold that fences watch, drawn faintly so the person sees where steps will run. */
+    function drawFenceAreas(values) {
+        for (const name of new Set((node.fences ?? []).flatMap((fence) => (fence.area !== undefined ? [fence.area] : [])))) {
+            const area = readArea(values[name]);
+            const drawn = JSON.stringify(area);
+            const had = fenceShapes.get(name);
+            if (had?.drawn === drawn)
+                continue;
+            had?.path.remove();
+            fenceShapes.delete(name);
+            if (!area)
+                continue;
+            const style = { className: 'fd-map-fence', pane: 'fd-reach', interactive: false };
+            const path = area.shape === 'circle' ? L.circle([area.center.lat, area.center.lng], { ...style, radius: area.radius }) : L.polygon(area.points.map((p) => [p.lat, p.lng]), style);
+            fenceShapes.set(name, { drawn, path: path.addTo(map) });
+        }
+    }
+    function checkFences(values, positionOf) {
+        node.fences?.forEach((fence, i) => {
+            // Where the place is going, not where its pin is gliding.
+            const at = positionOf(fence.layer);
+            if (!at)
+                return;
+            let inside;
+            if (fence.area !== undefined) {
+                const area = readArea(values[fence.area]);
+                if (!area)
+                    return;
+                inside = insideArea(at, area);
+            }
+            else {
+                const found = reaches.get(fence.within)?.found;
+                if (!found)
+                    return;
+                inside = found.rings.some((ring) => insideRing(at, ring));
+            }
+            const was = insideNow.get(i);
+            insideNow.set(i, inside);
+            if (was === undefined || was === inside)
+                return;
+            if (inside === (fence.when === 'enter'))
+                options.run(fence.steps);
+        });
+    }
+    const areas = {
+        update(values, positionOf, hidden) {
+            if (gone)
+                return;
+            last = [values, positionOf, hidden];
+            drawReaches(positionOf, hidden);
+            drawFenceAreas(values);
+            checkFences(values, positionOf);
+        },
+        destroy() {
+            gone = true;
+            for (const state of reaches.values()) {
+                state.abort?.abort();
+                state.drawn?.remove();
+            }
+            for (const shape of fenceShapes.values())
+                shape.path.remove();
+        },
+    };
+    return areas;
+}
+//# sourceMappingURL=reach.mjs.map

package/src/lib/reach.mjs.map

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

package/src/lib/regions.d.mts

@@ -0,0 +1,137 @@
+import type * as Leaflet from 'leaflet';
+import type { Locale, MapLayer, MapRegions, ResolvedFilter } from '@fieldia/core';
+import { type MapLabels } from './labels.mjs';
+import type { LeafletModule } from './leaflet.mjs';
+import { type MapBox } from './map-core.mjs';
+/**
+ * Areas shaded by colour on a map: districts, zones, municipalities. Their
+ * borders are the app's (a GeoJSON FeatureCollection of polygons), each known
+ * by one of its properties and named by another. An area's number shades it
+ * in up to five steps of the page's accent, from light to strong, with a
+ * legend; an area with none is outlined only. The pointer over one lights it
+ * and says its name and number; a press does what the map says (search for its
+ * records, or choose it). On the keyboard the areas are one stop: Tab reaches
+ * the first (or the one chosen), the arrow keys go from area to area in
+ * reading order, Enter or Space presses one. Loaded with the first map that
+ * has them.
+ */
+export interface Border {
+    /** Its key as text, and as the border holds it: what a record's field holds. */
+    key: string;
+    value: string | number;
+    name: string;
+    properties: Record<string, unknown>;
+    /** Its polygons, each as rings of [longitude, latitude]: the outer ring, then its holes. */
+    polygons: [number, number][][][];
+}
+/** The borders a set holds: Polygon and MultiPolygon features with a key; anything else is passed over. */
+export declare function readBorders(collection: unknown, spec: {
+    key: string;
+    name?: string;
+}): Border[];
+/** A set of borders the app's maps give, by name: asked for once for all the maps sharing the settings; undefined when there is no such set. */
+export declare function loadBorders(sets: Record<string, unknown> | undefined, name: string): Promise<unknown>;
+/**
+ * The shades' steps: up to five, each ending on a round number, so the legend
+ * reads "11–20, 21–30…" rather than "9.6–19.2". They start from nothing, or
+ * from a round number under the least when every number is well above
+ * nothing (fees of 15 to 40 start at 10). Whole numbers (counts) step by whole
+ * numbers.
+ */
+export declare function shadeSteps(values: readonly number[]): {
+    from: number;
+    ends: number[];
+};
+/** The shade a number falls in: 0 for the lightest, null for none. */
+export declare function shadeOf(value: number | null | undefined, steps: readonly number[]): number | null;
+export declare const REGIONS_CSS = "\npath.fd-map-region { stroke: var(--fd-surface); stroke-width: 1.4; stroke-opacity: 0.95; fill: var(--fd-accent); fill-opacity: 0.06; cursor: pointer; transition: fill-opacity 0.12s; }\npath.fd-map-region[data-shade] { fill: var(--fd-region); fill-opacity: 0.5; }\npath.fd-map-region:hover, path.fd-map-region[data-lit] { fill-opacity: 0.8; stroke: var(--fd-text); stroke-width: 2; }\npath.fd-map-region[data-chosen] { stroke: var(--fd-accent); stroke-width: 3.5; stroke-opacity: 1; }\npath.fd-map-region:focus { outline: none; }\n/* While a way is measured or an area drawn, every press is the map's. */\n.fd-map-box[data-measuring] path.fd-map-region, .fd-map-box[data-drawing] path.fd-map-region { pointer-events: none; }\npath.fd-map-region:focus-visible { stroke: var(--fd-focus); stroke-width: 4; stroke-opacity: 1; }\n.fd-map-box[data-plain] path.fd-map-region { cursor: default; }\n.fd-map-legend {\n  position: absolute; right: 8px; bottom: 26px; z-index: 1000; display: grid; gap: 3px; max-width: min(240px, 60%); padding: 6px 9px; border-radius: 6px;\n  font-size: 12px; line-height: 1.35; background: color-mix(in srgb, var(--fd-surface) 94%, transparent); color: var(--fd-text); box-shadow: 0 1px 4px rgba(0, 0, 0, 0.18);\n}\n.fd-map-legend[hidden] { display: none; }\n.fd-map-legend-title { font-weight: 700; overflow-wrap: anywhere; }\n.fd-map-legend ol { list-style: none; margin: 0; padding: 0; display: grid; gap: 2px; }\n.fd-map-legend li { display: flex; align-items: center; gap: 7px; font-variant-numeric: tabular-nums; }\n.fd-map-legend i { width: 18px; height: 11px; flex: none; border-radius: 2px; background: var(--fd-region, transparent); border: 1px solid color-mix(in srgb, var(--fd-text) 35%, transparent); }\n.fd-map-legend i[data-shade] { background: color-mix(in srgb, var(--fd-region) 50%, var(--fd-surface)); }\n.leaflet-tooltip.fd-map-tip {\n  padding: 3px 8px; border: 0; border-radius: 6px; font: inherit; font-size: 12.5px; font-weight: 600; white-space: nowrap;\n  background: var(--fd-surface); color: var(--fd-text); box-shadow: 0 1px 5px rgba(0, 0, 0, 0.3);\n}\n.leaflet-tooltip.fd-map-tip::before { display: none; }\n";
+export interface RegionsLayer {
+    /** Each area's number, by its key (null: none shaded), and the area chosen. */
+    shade(values: ReadonlyMap<string, number> | null, chosen: string | null): void;
+    /** The area under a place, if any: for a fence, or a record's own area. */
+    at(lat: number, lng: number): Border | null;
+    /** On the map or off it, as its layer's `invisible` says. */
+    show(on: boolean): void;
+    destroy(): void;
+}
+export declare function drawRegions(options: {
+    box: MapBox;
+    map: Leaflet.Map;
+    L: LeafletModule;
+    document: Document;
+    locale: Locale;
+    labels: MapLabels;
+    borders: Border[];
+    /** The legend's title, and the areas' name as a group: "Orders", "Districts". */
+    title: string;
+    legend: boolean;
+    /** What a press on an area does; without it, the areas are only shown. */
+    press?: (border: Border) => void;
+}): RegionsLayer;
+/** Inside a polygon: inside its outer ring and none of its holes. */
+export declare function insideRings(x: number, y: number, rings: [number, number][][]): boolean;
+/**
+ * A list's areas shaded by its records: drawn once their borders load, their
+ * numbers asked for again with each search — each area's records under the
+ * search but for an area searched itself, so the others keep their shades —
+ * or a number of their own. A press searches for an area's records.
+ */
+export declare function listRegions(options: {
+    sets: Record<string, unknown> | undefined;
+    spec: MapRegions & {
+        field: string;
+    };
+    box: MapBox;
+    map: Leaflet.Map;
+    L: LeafletModule;
+    document: Document;
+    locale: Locale;
+    labels: MapLabels & {
+        inRegion: string;
+    };
+    title: string;
+    model: string;
+    dataSource: {
+        groups?(request: {
+            model: string;
+            field: string;
+            filter: ResolvedFilter[];
+        }): Promise<{
+            value: unknown;
+            count: number;
+        }[]>;
+    } | undefined;
+    addSearch(search: {
+        label: string;
+        filter: ResolvedFilter[];
+    }): void;
+    /** The records the map has, to count when the data source cannot. */
+    records(): readonly {
+        values: Record<string, unknown>;
+    }[];
+}): {
+    shade(filter: readonly ResolvedFilter[], current: () => boolean): Promise<void>;
+    destroy(): void;
+};
+/**
+ * A form's areas by colour, a layer each: shaded by a number of their own,
+ * the one the record's field holds drawn strong, a press choosing one into
+ * that field where the person may change it; on the map or off it as each
+ * layer's `invisible` says.
+ */
+export declare function formRegions(options: {
+    sets: Record<string, unknown> | undefined;
+    layers: readonly MapLayer[];
+    box: MapBox;
+    map: Leaflet.Map;
+    L: LeafletModule;
+    document: Document;
+    locale: Locale;
+    labels: MapLabels;
+    /** Whether a person may write a field now: a press chooses only where they may. */
+    writable(field: string): boolean;
+    choose(field: string, value: string | number): void;
+}): {
+    update(values: Record<string, unknown>, hidden: (layerId: string) => boolean): void;
+    destroy(): void;
+};

package/src/lib/regions.d.ts

@@ -0,0 +1,137 @@
+import type * as Leaflet from 'leaflet';
+import type { Locale, MapLayer, MapRegions, ResolvedFilter } from '@fieldia/core';
+import { type MapLabels } from './labels';
+import type { LeafletModule } from './leaflet';
+import { type MapBox } from './map-core';
+/**
+ * Areas shaded by colour on a map: districts, zones, municipalities. Their
+ * borders are the app's (a GeoJSON FeatureCollection of polygons), each known
+ * by one of its properties and named by another. An area's number shades it
+ * in up to five steps of the page's accent, from light to strong, with a
+ * legend; an area with none is outlined only. The pointer over one lights it
+ * and says its name and number; a press does what the map says (search for its
+ * records, or choose it). On the keyboard the areas are one stop: Tab reaches
+ * the first (or the one chosen), the arrow keys go from area to area in
+ * reading order, Enter or Space presses one. Loaded with the first map that
+ * has them.
+ */
+export interface Border {
+    /** Its key as text, and as the border holds it: what a record's field holds. */
+    key: string;
+    value: string | number;
+    name: string;
+    properties: Record<string, unknown>;
+    /** Its polygons, each as rings of [longitude, latitude]: the outer ring, then its holes. */
+    polygons: [number, number][][][];
+}
+/** The borders a set holds: Polygon and MultiPolygon features with a key; anything else is passed over. */
+export declare function readBorders(collection: unknown, spec: {
+    key: string;
+    name?: string;
+}): Border[];
+/** A set of borders the app's maps give, by name: asked for once for all the maps sharing the settings; undefined when there is no such set. */
+export declare function loadBorders(sets: Record<string, unknown> | undefined, name: string): Promise<unknown>;
+/**
+ * The shades' steps: up to five, each ending on a round number, so the legend
+ * reads "11–20, 21–30…" rather than "9.6–19.2". They start from nothing, or
+ * from a round number under the least when every number is well above
+ * nothing (fees of 15 to 40 start at 10). Whole numbers (counts) step by whole
+ * numbers.
+ */
+export declare function shadeSteps(values: readonly number[]): {
+    from: number;
+    ends: number[];
+};
+/** The shade a number falls in: 0 for the lightest, null for none. */
+export declare function shadeOf(value: number | null | undefined, steps: readonly number[]): number | null;
+export declare const REGIONS_CSS = "\npath.fd-map-region { stroke: var(--fd-surface); stroke-width: 1.4; stroke-opacity: 0.95; fill: var(--fd-accent); fill-opacity: 0.06; cursor: pointer; transition: fill-opacity 0.12s; }\npath.fd-map-region[data-shade] { fill: var(--fd-region); fill-opacity: 0.5; }\npath.fd-map-region:hover, path.fd-map-region[data-lit] { fill-opacity: 0.8; stroke: var(--fd-text); stroke-width: 2; }\npath.fd-map-region[data-chosen] { stroke: var(--fd-accent); stroke-width: 3.5; stroke-opacity: 1; }\npath.fd-map-region:focus { outline: none; }\n/* While a way is measured or an area drawn, every press is the map's. */\n.fd-map-box[data-measuring] path.fd-map-region, .fd-map-box[data-drawing] path.fd-map-region { pointer-events: none; }\npath.fd-map-region:focus-visible { stroke: var(--fd-focus); stroke-width: 4; stroke-opacity: 1; }\n.fd-map-box[data-plain] path.fd-map-region { cursor: default; }\n.fd-map-legend {\n  position: absolute; right: 8px; bottom: 26px; z-index: 1000; display: grid; gap: 3px; max-width: min(240px, 60%); padding: 6px 9px; border-radius: 6px;\n  font-size: 12px; line-height: 1.35; background: color-mix(in srgb, var(--fd-surface) 94%, transparent); color: var(--fd-text); box-shadow: 0 1px 4px rgba(0, 0, 0, 0.18);\n}\n.fd-map-legend[hidden] { display: none; }\n.fd-map-legend-title { font-weight: 700; overflow-wrap: anywhere; }\n.fd-map-legend ol { list-style: none; margin: 0; padding: 0; display: grid; gap: 2px; }\n.fd-map-legend li { display: flex; align-items: center; gap: 7px; font-variant-numeric: tabular-nums; }\n.fd-map-legend i { width: 18px; height: 11px; flex: none; border-radius: 2px; background: var(--fd-region, transparent); border: 1px solid color-mix(in srgb, var(--fd-text) 35%, transparent); }\n.fd-map-legend i[data-shade] { background: color-mix(in srgb, var(--fd-region) 50%, var(--fd-surface)); }\n.leaflet-tooltip.fd-map-tip {\n  padding: 3px 8px; border: 0; border-radius: 6px; font: inherit; font-size: 12.5px; font-weight: 600; white-space: nowrap;\n  background: var(--fd-surface); color: var(--fd-text); box-shadow: 0 1px 5px rgba(0, 0, 0, 0.3);\n}\n.leaflet-tooltip.fd-map-tip::before { display: none; }\n";
+export interface RegionsLayer {
+    /** Each area's number, by its key (null: none shaded), and the area chosen. */
+    shade(values: ReadonlyMap<string, number> | null, chosen: string | null): void;
+    /** The area under a place, if any: for a fence, or a record's own area. */
+    at(lat: number, lng: number): Border | null;
+    /** On the map or off it, as its layer's `invisible` says. */
+    show(on: boolean): void;
+    destroy(): void;
+}
+export declare function drawRegions(options: {
+    box: MapBox;
+    map: Leaflet.Map;
+    L: LeafletModule;
+    document: Document;
+    locale: Locale;
+    labels: MapLabels;
+    borders: Border[];
+    /** The legend's title, and the areas' name as a group: "Orders", "Districts". */
+    title: string;
+    legend: boolean;
+    /** What a press on an area does; without it, the areas are only shown. */
+    press?: (border: Border) => void;
+}): RegionsLayer;
+/** Inside a polygon: inside its outer ring and none of its holes. */
+export declare function insideRings(x: number, y: number, rings: [number, number][][]): boolean;
+/**
+ * A list's areas shaded by its records: drawn once their borders load, their
+ * numbers asked for again with each search — each area's records under the
+ * search but for an area searched itself, so the others keep their shades —
+ * or a number of their own. A press searches for an area's records.
+ */
+export declare function listRegions(options: {
+    sets: Record<string, unknown> | undefined;
+    spec: MapRegions & {
+        field: string;
+    };
+    box: MapBox;
+    map: Leaflet.Map;
+    L: LeafletModule;
+    document: Document;
+    locale: Locale;
+    labels: MapLabels & {
+        inRegion: string;
+    };
+    title: string;
+    model: string;
+    dataSource: {
+        groups?(request: {
+            model: string;
+            field: string;
+            filter: ResolvedFilter[];
+        }): Promise<{
+            value: unknown;
+            count: number;
+        }[]>;
+    } | undefined;
+    addSearch(search: {
+        label: string;
+        filter: ResolvedFilter[];
+    }): void;
+    /** The records the map has, to count when the data source cannot. */
+    records(): readonly {
+        values: Record<string, unknown>;
+    }[];
+}): {
+    shade(filter: readonly ResolvedFilter[], current: () => boolean): Promise<void>;
+    destroy(): void;
+};
+/**
+ * A form's areas by colour, a layer each: shaded by a number of their own,
+ * the one the record's field holds drawn strong, a press choosing one into
+ * that field where the person may change it; on the map or off it as each
+ * layer's `invisible` says.
+ */
+export declare function formRegions(options: {
+    sets: Record<string, unknown> | undefined;
+    layers: readonly MapLayer[];
+    box: MapBox;
+    map: Leaflet.Map;
+    L: LeafletModule;
+    document: Document;
+    locale: Locale;
+    labels: MapLabels;
+    /** Whether a person may write a field now: a press chooses only where they may. */
+    writable(field: string): boolean;
+    choose(field: string, value: string | number): void;
+}): {
+    update(values: Record<string, unknown>, hidden: (layerId: string) => boolean): void;
+    destroy(): void;
+};