@fieldia/map 0.0.0-stage → 0.14.1

package/src/lib/place.mjs

@@ -0,0 +1,360 @@
+import { formatNumber } from '@fieldia/widgets';
+import { asJson, isLatLng, parseCoordinate, readPoint, writePoint } from './geo.mjs';
+import { fill, mapLabels } from './labels.mjs';
+import { createMapBox, warnOnce } from './map-core.mjs';
+import { searchBox } from './search-box.mjs';
+/**
+ * A place on a form: a click on the map, a dragged pin, an address found,
+ * or "My location". Kept as a GeoJSON Point in a json field, or in two
+ * number fields (`latitude` with `options.longitudeField`), the way Odoo
+ * keeps a partner's place. The coordinates stay typeable under the map:
+ * that is the way in without a mouse, beside Enter on the map (the place
+ * at its centre) and the arrow keys on the pin.
+ *
+ * Options: `longitudeField`, `addressField` (filled from the address
+ * found, or named from the point where the provider can), `myLocation`
+ * (on unless false), `search` (on unless false), `zoom` (15), `height`.
+ */
+const PIN = `<svg viewBox="0 0 28 40" aria-hidden="true"><path class="fd-map-pin-body" d="M14 1C6.8 1 1 6.7 1 13.8 1 23.6 14 39 14 39s13-15.4 13-25.2C27 6.7 21.2 1 14 1z"/><circle class="fd-map-pin-dot" cx="14" cy="14" r="5"/></svg>`;
+const round6 = (n) => Math.round(n * 1e6) / 1e6;
+export function placeWidget(settings) {
+    return (context) => {
+        const { form, name, field, node, id, document: doc } = context;
+        const options = node.options ?? {};
+        const labels = mapLabels(context.locale, settings.labels?.[context.locale ?? 'en']);
+        const longitudeField = typeof options['longitudeField'] === 'string' ? options['longitudeField'] : null;
+        const addressField = typeof options['addressField'] === 'string' ? options['addressField'] : null;
+        const inFields = field.type === 'float';
+        if (inFields && !longitudeField)
+            throw new Error(`The place on "${name}" keeps its latitude there and needs options.longitudeField for its longitude`);
+        const zoom = typeof options['zoom'] === 'number' ? options['zoom'] : 15;
+        const search = options['search'] === false ? undefined : (settings.search ?? settings.provider.search);
+        const reverse = settings.reverse ?? settings.provider.reverse;
+        const asYouType = settings.search ? (settings.searchAsYouType ?? true) : !!settings.provider.searchAsYouType;
+        const geolocation = options['myLocation'] === false ? undefined : doc.defaultView?.navigator.geolocation;
+        let readonly = false;
+        let point = null;
+        /** The address this field last wrote: one a person typed is never written over. */
+        let addressWritten;
+        let values = form.getState().values;
+        const element = doc.createElement('div');
+        element.className = 'fd-map-field fd-place';
+        element.setAttribute('role', 'group');
+        element.setAttribute('aria-labelledby', `${id}-label`);
+        const tools = doc.createElement('div');
+        tools.className = 'fd-map-tools';
+        const note = doc.createElement('p');
+        note.className = 'fd-map-note';
+        note.setAttribute('aria-live', 'polite');
+        note.hidden = true;
+        const say = (words, tone) => {
+            note.textContent = words ?? '';
+            note.hidden = !words;
+            if (tone)
+                note.dataset['tone'] = tone;
+            else
+                delete note.dataset['tone'];
+        };
+        const box = createMapBox({
+            document: doc,
+            provider: settings.provider,
+            locale: context.locale ?? 'en',
+            labels,
+            name: field.label,
+            keys: labels.placeKeys,
+            center: settings.center,
+            zoom: settings.center ? (settings.zoom ?? 11) : undefined,
+            height: typeof options['height'] === 'number' ? options['height'] : undefined,
+        });
+        // ---- the coordinates, typeable -------------------------------------------
+        const coords = doc.createElement('div');
+        coords.className = 'fd-map-coords';
+        const coordinate = (words, inputId) => {
+            const label = doc.createElement('label');
+            const input = doc.createElement('input');
+            input.className = 'fd-input';
+            input.id = inputId;
+            input.inputMode = 'decimal';
+            input.autocomplete = 'off';
+            input.spellcheck = false;
+            label.append(words, input);
+            coords.append(label);
+            return input;
+        };
+        const lat = coordinate(labels.latitude, search ? `${id}-lat` : id);
+        const lng = coordinate(labels.longitude, `${id}-lng`);
+        const typed = () => {
+            const a = parseCoordinate(lat.value);
+            const b = parseCoordinate(lng.value);
+            const empty = !lat.value.trim() && !lng.value.trim();
+            const good = empty || isLatLng(a, b);
+            lat.setAttribute('aria-invalid', String(!good || (a !== null && Math.abs(a) > 90)));
+            lng.setAttribute('aria-invalid', String(!good || (b !== null && Math.abs(b) > 180)));
+            if (!good)
+                return say(labels.notACoordinate, 'error');
+            say(null);
+            if (empty)
+                return set(null);
+            set({ lat: a, lng: b }, { fly: true, name: true });
+        };
+        for (const input of [lat, lng]) {
+            input.addEventListener('change', typed);
+            input.addEventListener('keydown', (event) => event.key === 'Enter' && (event.preventDefault(), typed()));
+        }
+        // ---- writing ---------------------------------------------------------------
+        function write(next) {
+            if (inFields) {
+                form.setValue(name, next ? round6(next.lat) : null);
+                form.setValue(longitudeField, next ? round6(next.lng) : null);
+            }
+            else
+                form.setValue(name, next ? asJson(writePoint(next)) : null);
+        }
+        let naming = null;
+        /** The address from the point, where the provider can say one, unless a person typed their own. */
+        function nameFrom(at) {
+            if (!addressField || !reverse)
+                return;
+            const current = values[addressField];
+            if (current !== null && current !== undefined && current !== '' && current !== addressWritten)
+                return;
+            naming?.abort();
+            naming = new AbortController();
+            reverse({ ...at, locale: context.locale ?? 'en', signal: naming.signal })
+                .then((label) => {
+                if (!label)
+                    return;
+                addressWritten = label;
+                form.setValue(addressField, label);
+            })
+                .catch((error) => error.name !== 'AbortError' && warnOnce(`Naming the place failed: ${error.message}`));
+        }
+        function set(next, how = {}) {
+            if (readonly)
+                return;
+            // How sure "My location" was: a circle while the place is the one it gave.
+            showAccuracy(next && how.within !== undefined ? { at: next, metres: how.within } : null);
+            if (next)
+                next = { lat: round6(next.lat), lng: round6(next.lng) };
+            point = next;
+            show(how.fly);
+            write(next);
+            if (next && how.address !== undefined && addressField) {
+                addressWritten = how.address;
+                form.setValue(addressField, how.address);
+            }
+            else if (next && how.name)
+                nameFrom(next);
+        }
+        // ---- the map and its pin ---------------------------------------------------
+        let marker = null;
+        let accuracy = null;
+        /** The map, once it is there: where it is and how close, for the search's "near". */
+        let shown = null;
+        /** The circle a rough location may be anywhere in, fitted into view; a desktop's is often kilometres wide. */
+        function showAccuracy(within) {
+            box.ready((map, L) => {
+                accuracy?.remove();
+                accuracy = null;
+                if (!within)
+                    return;
+                accuracy = L.circle([within.at.lat, within.at.lng], { radius: within.metres, className: 'fd-map-accuracy', interactive: false }).addTo(map);
+                map.fitBounds(accuracy.getBounds(), { padding: [24, 24], maxZoom: zoom });
+            });
+        }
+        function show(fly = false) {
+            clear.hidden = readonly || !point;
+            box.ready((map, L) => {
+                if (!point) {
+                    marker?.remove();
+                    marker = null;
+                    return;
+                }
+                const at = [point.lat, point.lng];
+                if (!marker)
+                    marker = makeMarker(map, L, at);
+                else
+                    marker.setLatLng(at);
+                if (marker.dragging) {
+                    if (readonly)
+                        marker.dragging.disable();
+                    else
+                        marker.dragging.enable();
+                }
+                marker.getElement()?.setAttribute('aria-label', `${field.label}: ${point.lat}, ${point.lng}`);
+                if (fly)
+                    map.setView(at, Math.max(map.getZoom(), zoom));
+                // A rough location's circle has fitted the map already.
+                else if (!accuracy && !map.getBounds().contains(at))
+                    map.setView(at, map.getZoom() < 5 ? zoom : map.getZoom());
+            });
+        }
+        function makeMarker(map, L, at) {
+            const icon = L.divIcon({ className: 'fd-map-pin', html: PIN, iconSize: [28, 40], iconAnchor: [14, 39] });
+            const pin = L.marker(at, { icon, draggable: !readonly, keyboard: true, autoPan: true }).addTo(map);
+            pin.on('dragend', () => {
+                const moved = pin.getLatLng();
+                set({ lat: moved.lat, lng: moved.lng }, { name: true });
+            });
+            // The arrow keys carry the pin a few pixels; Shift, further.
+            pin.getElement()?.addEventListener('keydown', (event) => {
+                const step = event.shiftKey ? 16 : 4;
+                const by = { ArrowUp: [0, -step], ArrowDown: [0, step], ArrowLeft: [-step, 0], ArrowRight: [step, 0] }[event.key];
+                if (!by || readonly)
+                    return;
+                event.preventDefault();
+                event.stopPropagation();
+                const there = map.containerPointToLatLng(map.latLngToContainerPoint(pin.getLatLng()).add(L.point(by[0], by[1])));
+                set({ lat: there.lat, lng: there.lng }, { name: true });
+            });
+            return pin;
+        }
+        box.ready((map) => {
+            shown = map;
+            map.on('click', (event) => set({ lat: event.latlng.lat, lng: event.latlng.lng }, { name: true }));
+            // Enter on the map: the place at its centre, where the cross is.
+            box.element.addEventListener('keydown', (event) => {
+                if ((event.key !== 'Enter' && event.key !== ' ') || event.target !== box.element || readonly)
+                    return;
+                event.preventDefault();
+                const centre = map.getCenter();
+                set({ lat: centre.lat, lng: centre.lng }, { name: true });
+            });
+            show(true);
+        });
+        /** "3 km", "400 m", in the page's language and its way of writing numbers. */
+        const distance = (metres) => metres >= 1000 ? fill(labels.kilometres, { n: formatNumber(Math.round(metres / 1000), 0, context.locale ?? 'en') }) : fill(labels.metres, { n: formatNumber(Math.round(metres / 10) * 10, 0, context.locale ?? 'en') });
+        // ---- search, my location, clear ---------------------------------------------
+        const found = search
+            ? searchBox({
+                document: doc,
+                id: lat.id === id ? `${id}-search` : id,
+                labels,
+                search,
+                asYouType: asYouType,
+                locale: context.locale ?? 'en',
+                // Nearest where the map is looking first, as a map's own search does.
+                near: () => {
+                    const centre = shown?.getCenter();
+                    return centre ? { lat: centre.lat, lng: centre.lng } : (point ?? settings.center);
+                },
+                zoom: () => shown?.getZoom(),
+                // A place picked: where it is (looked up now, when the provider's suggestions carry no place), and its whole address for Address.
+                pick: async (place) => {
+                    const located = place.lat !== undefined && place.lng !== undefined
+                        ? { lat: place.lat, lng: place.lng, address: undefined }
+                        : await place.locate?.().catch((error) => (warnOnce(`Finding the place picked failed: ${error.message}`), null));
+                    if (!located)
+                        return say(labels.searchFailed, 'error');
+                    set({ lat: located.lat, lng: located.lng }, { fly: true, address: located.address ?? [place.label, place.detail].filter(Boolean).join(', ') });
+                },
+                say,
+            })
+            : null;
+        if (found)
+            tools.append(found.element);
+        const myLocation = doc.createElement('button');
+        myLocation.type = 'button';
+        myLocation.className = 'fd-button';
+        myLocation.innerHTML = '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" aria-hidden="true"><circle cx="12" cy="12" r="4"/><path d="M12 2v3M12 19v3M2 12h3M19 12h3"/></svg>';
+        myLocation.append(labels.myLocation);
+        let blocked = false;
+        myLocation.hidden = !geolocation;
+        myLocation.addEventListener('click', () => {
+            if (!geolocation)
+                return;
+            say(labels.locating);
+            geolocation.getCurrentPosition((position) => {
+                const metres = Math.round(position.coords.accuracy);
+                // Named only when it is sure: an address from a point kilometres off would be someone else's.
+                set({ lat: position.coords.latitude, lng: position.coords.longitude }, { name: metres <= 100, within: metres });
+                // A rough location says how rough: a desktop's comes from its network, and may be a city away.
+                if (metres > 100)
+                    say(fill(labels.locatedWithin, { distance: distance(metres) }));
+                else
+                    say(null);
+            }, (error) => {
+                if (error.code === error.PERMISSION_DENIED) {
+                    blocked = true;
+                    myLocation.hidden = true;
+                    say(labels.locationBlocked);
+                }
+                else
+                    say(labels.locationFailed, 'error');
+            }, { enableHighAccuracy: true, timeout: 10_000, maximumAge: 60_000 });
+        });
+        // Location blocked for the site: the button goes, with the reason in its place.
+        doc.defaultView?.navigator.permissions
+            ?.query({ name: 'geolocation' })
+            .then((status) => {
+            const read = () => {
+                blocked = status.state === 'denied';
+                myLocation.hidden = !geolocation || blocked || readonly;
+                if (blocked)
+                    say(labels.locationBlocked);
+            };
+            read();
+            status.onchange = read;
+        })
+            .catch(() => undefined);
+        const clear = doc.createElement('button');
+        clear.type = 'button';
+        clear.className = 'fd-button fd-button-link';
+        clear.textContent = labels.clear;
+        clear.hidden = true;
+        clear.addEventListener('click', () => {
+            set(null);
+            say(null);
+            (found?.input ?? lat).focus();
+        });
+        tools.append(myLocation, clear);
+        element.append(tools, box.element, coords, note);
+        const showCoords = () => {
+            for (const [input, n] of [[lat, point?.lat], [lng, point?.lng]]) {
+                if (doc.activeElement === input)
+                    continue;
+                input.value = n === undefined ? '' : String(n);
+                input.setAttribute('aria-invalid', 'false');
+            }
+        };
+        return {
+            element,
+            focus: () => (found?.input ?? lat).focus(),
+            destroy: () => {
+                naming?.abort();
+                found?.destroy();
+                box.destroy();
+            },
+            update(state) {
+                values = state.values;
+                readonly = state.readonly;
+                const next = inFields
+                    ? isLatLng(state.value, state.values[longitudeField])
+                        ? { lat: state.value, lng: state.values[longitudeField] }
+                        : null
+                    : readPoint(state.value);
+                const changed = next?.lat !== point?.lat || next?.lng !== point?.lng;
+                point = next;
+                tools.hidden = readonly;
+                myLocation.hidden = !geolocation || blocked || readonly;
+                for (const input of [lat, lng])
+                    input.readOnly = readonly;
+                const target = found?.input ?? lat;
+                target.setAttribute('aria-invalid', String(state.invalid));
+                target.setAttribute('aria-required', String(state.required));
+                if (state.describedBy)
+                    target.setAttribute('aria-describedby', state.describedBy);
+                else
+                    target.removeAttribute('aria-describedby');
+                lat.setAttribute('aria-required', String(state.required));
+                showCoords();
+                box.refresh();
+                if (changed)
+                    show();
+                else
+                    clear.hidden = readonly || !point;
+            },
+        };
+    };
+}
+//# sourceMappingURL=place.mjs.map

package/src/lib/place.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"place.mjs","sourceRoot":"","sources":["../../../../../libs/map/src/lib/place.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAyE,MAAM,kBAAkB,CAAC;AACvH,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,SAAS,EAAE,UAAU,EAAe,MAAM,OAAO,CAAC;AAC9F,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE3C,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC;;;;;;;;;;;GAWG;AAEH,MAAM,GAAG,GAAG,6NAA6N,CAAC;AAE1O,MAAM,MAAM,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;AAExD,MAAM,UAAU,WAAW,CAAC,QAAqB;IAC/C,OAAO,CAAC,OAAsB,EAAU,EAAE;QACxC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;QAC/D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC;QACpF,MAAM,cAAc,GAAG,OAAO,OAAO,CAAC,gBAAgB,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACxG,MAAM,YAAY,GAAG,OAAO,OAAO,CAAC,cAAc,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAClG,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC;QACxC,IAAI,QAAQ,IAAI,CAAC,cAAc;YAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,+EAA+E,CAAC,CAAC;QACvJ,MAAM,IAAI,GAAG,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACvG,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;QAC9D,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,eAAe,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC;QAC7G,MAAM,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,SAAS,CAAC,WAAW,CAAC;QAEzG,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,IAAI,KAAK,GAAkB,IAAI,CAAC;QAChC,mFAAmF;QACnF,IAAI,cAAiC,CAAC;QACtC,IAAI,MAAM,GAAoC,IAAI,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC;QAErE,MAAM,OAAO,GAAG,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACzC,OAAO,CAAC,SAAS,GAAG,uBAAuB,CAAC;QAC5C,OAAO,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACtC,OAAO,CAAC,YAAY,CAAC,iBAAiB,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;QACvD,MAAM,KAAK,GAAG,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACvC,KAAK,CAAC,SAAS,GAAG,cAAc,CAAC;QACjC,MAAM,IAAI,GAAG,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,CAAC,SAAS,GAAG,aAAa,CAAC;QAC/B,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QACzC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,MAAM,GAAG,GAAG,CAAC,KAAoB,EAAE,IAAc,EAAE,EAAE;YACnD,IAAI,CAAC,WAAW,GAAG,KAAK,IAAI,EAAE,CAAC;YAC/B,IAAI,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC;YACrB,IAAI,IAAI;gBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;;gBACjC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACnC,CAAC,CAAC;QAEF,MAAM,GAAG,GAAG,YAAY,CAAC;YACvB,QAAQ,EAAE,GAAG;YACb,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;YAC9B,MAAM;YACN,IAAI,EAAE,KAAK,CAAC,KAAK;YACjB,IAAI,EAAE,MAAM,CAAC,SAAS;YACtB,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;YACzD,MAAM,EAAE,OAAO,OAAO,CAAC,QAAQ,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS;SAC9E,CAAC,CAAC;QAEH,6EAA6E;QAC7E,MAAM,MAAM,GAAG,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACxC,MAAM,CAAC,SAAS,GAAG,eAAe,CAAC;QACnC,MAAM,UAAU,GAAG,CAAC,KAAa,EAAE,OAAe,EAAE,EAAE;YACpD,MAAM,KAAK,GAAG,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YACzC,MAAM,KAAK,GAAG,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YACzC,KAAK,CAAC,SAAS,GAAG,UAAU,CAAC;YAC7B,KAAK,CAAC,EAAE,GAAG,OAAO,CAAC;YACnB,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;YAC5B,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC;YAC3B,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC;YACzB,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YAC3B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACrB,OAAO,KAAK,CAAC;QACf,CAAC,CAAC;QACF,MAAM,GAAG,GAAG,UAAU,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACnE,MAAM,GAAG,GAAG,UAAU,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;QACtD,MAAM,KAAK,GAAG,GAAG,EAAE;YACjB,MAAM,CAAC,GAAG,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACrC,MAAM,CAAC,GAAG,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACrC,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YACrD,MAAM,IAAI,GAAG,KAAK,IAAI,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACrC,GAAG,CAAC,YAAY,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;YACpF,GAAG,CAAC,YAAY,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;YACrF,IAAI,CAAC,IAAI;gBAAE,OAAO,GAAG,CAAC,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;YACtD,GAAG,CAAC,IAAI,CAAC,CAAC;YACV,IAAI,KAAK;gBAAE,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC;YAC5B,GAAG,CAAC,EAAE,GAAG,EAAE,CAAE,EAAE,GAAG,EAAE,CAAE,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACvD,CAAC,CAAC;QACF,KAAK,MAAM,KAAK,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;YAC/B,KAAK,CAAC,gBAAgB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YACxC,KAAK,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,KAAK,OAAO,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAC3G,CAAC;QAED,+EAA+E;QAC/E,SAAS,KAAK,CAAC,IAAmB;YAChC,IAAI,QAAQ,EAAE,CAAC;gBACb,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBACpD,IAAI,CAAC,QAAQ,CAAC,cAAe,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACjE,CAAC;;gBAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACrE,CAAC;QAED,IAAI,MAAM,GAA2B,IAAI,CAAC;QAC1C,mGAAmG;QACnG,SAAS,QAAQ,CAAC,EAAU;YAC1B,IAAI,CAAC,YAAY,IAAI,CAAC,OAAO;gBAAE,OAAO;YACtC,MAAM,OAAO,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;YACrC,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,EAAE,IAAI,OAAO,KAAK,cAAc;gBAAE,OAAO;YACtG,MAAM,EAAE,KAAK,EAAE,CAAC;YAChB,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;YAC/B,OAAO,CAAC,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;iBACtE,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;gBACd,IAAI,CAAC,KAAK;oBAAE,OAAO;gBACnB,cAAc,GAAG,KAAK,CAAC;gBACvB,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;YACrC,CAAC,CAAC;iBACD,KAAK,CAAC,CAAC,KAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,YAAY,IAAI,QAAQ,CAAC,4BAA4B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACnH,CAAC;QAED,SAAS,GAAG,CAAC,IAAmB,EAAE,MAA4E,EAAE;YAC9G,IAAI,QAAQ;gBAAE,OAAO;YACrB,2EAA2E;YAC3E,YAAY,CAAC,IAAI,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACzF,IAAI,IAAI;gBAAE,IAAI,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAClE,KAAK,GAAG,IAAI,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,KAAK,CAAC,IAAI,CAAC,CAAC;YACZ,IAAI,IAAI,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI,YAAY,EAAE,CAAC;gBACtD,cAAc,GAAG,GAAG,CAAC,OAAO,CAAC;gBAC7B,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;YAC3C,CAAC;iBAAM,IAAI,IAAI,IAAI,GAAG,CAAC,IAAI;gBAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC9C,CAAC;QAED,+EAA+E;QAC/E,IAAI,MAAM,GAA0B,IAAI,CAAC;QACzC,IAAI,QAAQ,GAA0B,IAAI,CAAC;QAC3C,qFAAqF;QACrF,IAAI,KAAK,GAAuB,IAAI,CAAC;QAErC,8GAA8G;QAC9G,SAAS,YAAY,CAAC,MAA6C;YACjE,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;gBACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;gBACnB,QAAQ,GAAG,IAAI,CAAC;gBAChB,IAAI,CAAC,MAAM;oBAAE,OAAO;gBACpB,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,iBAAiB,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBAC5I,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5E,CAAC,CAAC,CAAC;QACL,CAAC;QACD,SAAS,IAAI,CAAC,GAAG,GAAG,KAAK;YACvB,KAAK,CAAC,MAAM,GAAG,QAAQ,IAAI,CAAC,KAAK,CAAC;YAClC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;gBACnB,IAAI,CAAC,KAAK,EAAE,CAAC;oBACX,MAAM,EAAE,MAAM,EAAE,CAAC;oBACjB,MAAM,GAAG,IAAI,CAAC;oBACd,OAAO;gBACT,CAAC;gBACD,MAAM,EAAE,GAAqB,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;gBACpD,IAAI,CAAC,MAAM;oBAAE,MAAM,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;;oBACxC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;gBAC1B,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;oBACpB,IAAI,QAAQ;wBAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;;wBACnC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;gBAChC,CAAC;gBACD,MAAM,CAAC,UAAU,EAAE,EAAE,YAAY,CAAC,YAAY,EAAE,GAAG,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,GAAG,KAAK,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;gBAC9F,IAAI,GAAG;oBAAE,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC;gBACxD,wDAAwD;qBACnD,IAAI,CAAC,QAAQ,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAAE,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YACjH,CAAC,CAAC,CAAC;QACL,CAAC;QAED,SAAS,UAAU,CAAC,GAAgB,EAAE,CAAgB,EAAE,EAAoB;YAC1E,MAAM,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;YACzG,MAAM,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACnG,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;gBACrB,MAAM,KAAK,GAAG,GAAG,CAAC,SAAS,EAAE,CAAC;gBAC9B,GAAG,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAC1D,CAAC,CAAC,CAAC;YACH,6DAA6D;YAC7D,GAAG,CAAC,UAAU,EAAE,EAAE,gBAAgB,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE;gBACtD,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;gBACrC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBAClH,IAAI,CAAC,EAAE,IAAI,QAAQ;oBAAE,OAAO;gBAC5B,KAAK,CAAC,cAAc,EAAE,CAAC;gBACvB,KAAK,CAAC,eAAe,EAAE,CAAC;gBACxB,MAAM,KAAK,GAAG,GAAG,CAAC,sBAAsB,CAAC,GAAG,CAAC,sBAAsB,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACjH,GAAG,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAC1D,CAAC,CAAC,CAAC;YACH,OAAO,GAAG,CAAC;QACb,CAAC;QAED,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YAChB,KAAK,GAAG,GAAG,CAAC;YACZ,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAgC,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAC7H,iEAAiE;YACjE,GAAG,CAAC,OAAO,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE;gBAChD,IAAI,CAAC,KAAK,CAAC,GAAG,KAAK,OAAO,IAAI,KAAK,CAAC,GAAG,KAAK,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,CAAC,OAAO,IAAI,QAAQ;oBAAE,OAAO;gBACrG,KAAK,CAAC,cAAc,EAAE,CAAC;gBACvB,MAAM,MAAM,GAAG,GAAG,CAAC,SAAS,EAAE,CAAC;gBAC/B,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5D,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,CAAC;QACb,CAAC,CAAC,CAAC;QAEH,8EAA8E;QAC9E,MAAM,QAAQ,GAAG,CAAC,MAAc,EAAE,EAAE,CAClC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC,EAAE,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC;QAE1N,gFAAgF;QAChF,MAAM,KAAK,GAAG,MAAM;YAClB,CAAC,CAAC,SAAS,CAAC;gBACR,QAAQ,EAAE,GAAG;gBACb,EAAE,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE;gBACvC,MAAM;gBACN,MAAM;gBACN,SAAS,EAAE,SAAS;gBACpB,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;gBAC9B,sEAAsE;gBACtE,IAAI,EAAE,GAAG,EAAE;oBACT,MAAM,MAAM,GAAG,KAAK,EAAE,SAAS,EAAE,CAAC;oBAClC,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;gBACpF,CAAC;gBACD,IAAI,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE;gBAC5B,kIAAkI;gBAClI,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;oBACpB,MAAM,OAAO,GACX,KAAK,CAAC,GAAG,KAAK,SAAS,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS;wBAChD,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE;wBACxD,CAAC,CAAC,MAAM,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,KAAY,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,oCAAoC,KAAK,CAAC,OAAO,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;oBAC5H,IAAI,CAAC,OAAO;wBAAE,OAAO,GAAG,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;oBACvD,GAAG,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACjJ,CAAC;gBACD,GAAG;aACJ,CAAC;YACJ,CAAC,CAAC,IAAI,CAAC;QACT,IAAI,KAAK;YAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAEvC,MAAM,UAAU,GAAG,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC/C,UAAU,CAAC,IAAI,GAAG,QAAQ,CAAC;QAC3B,UAAU,CAAC,SAAS,GAAG,WAAW,CAAC;QACnC,UAAU,CAAC,SAAS,GAAG,gLAAgL,CAAC;QACxM,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACrC,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,UAAU,CAAC,MAAM,GAAG,CAAC,WAAW,CAAC;QACjC,UAAU,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;YACxC,IAAI,CAAC,WAAW;gBAAE,OAAO;YACzB,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YACrB,WAAW,CAAC,kBAAkB,CAC5B,CAAC,QAAQ,EAAE,EAAE;gBACX,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBACpD,8FAA8F;gBAC9F,GAAG,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,IAAI,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;gBAChH,+FAA+F;gBAC/F,IAAI,MAAM,GAAG,GAAG;oBAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;;oBAC7E,GAAG,CAAC,IAAI,CAAC,CAAC;YACjB,CAAC,EACD,CAAC,KAAK,EAAE,EAAE;gBACR,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,iBAAiB,EAAE,CAAC;oBAC3C,OAAO,GAAG,IAAI,CAAC;oBACf,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC;oBACzB,GAAG,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;gBAC9B,CAAC;;oBAAM,GAAG,CAAC,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;YAC7C,CAAC,EACD,EAAE,kBAAkB,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,CAClE,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,gFAAgF;QAChF,GAAG,CAAC,WAAW,EAAE,SAAS,CAAC,WAAW;YACpC,EAAE,KAAK,CAAC,EAAE,IAAI,EAAE,aAA+B,EAAE,CAAC;aACjD,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YACf,MAAM,IAAI,GAAG,GAAG,EAAE;gBAChB,OAAO,GAAG,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC;gBACpC,UAAU,CAAC,MAAM,GAAG,CAAC,WAAW,IAAI,OAAO,IAAI,QAAQ,CAAC;gBACxD,IAAI,OAAO;oBAAE,GAAG,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;YAC3C,CAAC,CAAC;YACF,IAAI,EAAE,CAAC;YACP,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC;QACzB,CAAC,CAAC;aACD,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAE1B,MAAM,KAAK,GAAG,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC1C,KAAK,CAAC,IAAI,GAAG,QAAQ,CAAC;QACtB,KAAK,CAAC,SAAS,GAAG,0BAA0B,CAAC;QAC7C,KAAK,CAAC,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC;QACjC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;QACpB,KAAK,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;YACnC,GAAG,CAAC,IAAI,CAAC,CAAC;YACV,GAAG,CAAC,IAAI,CAAC,CAAC;YACV,CAAC,KAAK,EAAE,KAAK,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC;QAChC,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAChC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QAEjD,MAAM,UAAU,GAAG,GAAG,EAAE;YACtB,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,CAAU,EAAE,CAAC;gBACzE,IAAI,GAAG,CAAC,aAAa,KAAK,KAAK;oBAAE,SAAS;gBAC1C,KAAK,CAAC,KAAK,GAAG,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;gBAC/C,KAAK,CAAC,YAAY,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC,CAAC;QAEF,OAAO;YACL,OAAO;YACP,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE;YAC1C,OAAO,EAAE,GAAG,EAAE;gBACZ,MAAM,EAAE,KAAK,EAAE,CAAC;gBAChB,KAAK,EAAE,OAAO,EAAE,CAAC;gBACjB,GAAG,CAAC,OAAO,EAAE,CAAC;YAChB,CAAC;YACD,MAAM,CAAC,KAAkB;gBACvB,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;gBACtB,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;gBAC1B,MAAM,IAAI,GAAG,QAAQ;oBACnB,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,cAAe,CAAC,CAAC;wBACpD,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,KAAe,EAAE,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,cAAe,CAAW,EAAE;wBAC9E,CAAC,CAAC,IAAI;oBACR,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBAC3B,MAAM,OAAO,GAAG,IAAI,EAAE,GAAG,KAAK,KAAK,EAAE,GAAG,IAAI,IAAI,EAAE,GAAG,KAAK,KAAK,EAAE,GAAG,CAAC;gBACrE,KAAK,GAAG,IAAI,CAAC;gBACb,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC;gBACxB,UAAU,CAAC,MAAM,GAAG,CAAC,WAAW,IAAI,OAAO,IAAI,QAAQ,CAAC;gBACxD,KAAK,MAAM,KAAK,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC;oBAAE,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAC;gBAC1D,MAAM,MAAM,GAAG,KAAK,EAAE,KAAK,IAAI,GAAG,CAAC;gBACnC,MAAM,CAAC,YAAY,CAAC,cAAc,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;gBAC3D,MAAM,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAC7D,IAAI,KAAK,CAAC,WAAW;oBAAE,MAAM,CAAC,YAAY,CAAC,kBAAkB,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;;oBAC7E,MAAM,CAAC,eAAe,CAAC,kBAAkB,CAAC,CAAC;gBAChD,GAAG,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAC1D,UAAU,EAAE,CAAC;gBACb,GAAG,CAAC,OAAO,EAAE,CAAC;gBACd,IAAI,OAAO;oBAAE,IAAI,EAAE,CAAC;;oBACf,KAAK,CAAC,MAAM,GAAG,QAAQ,IAAI,CAAC,KAAK,CAAC;YACzC,CAAC;SACF,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/src/lib/providers.d.mts

@@ -0,0 +1,152 @@
+import type { Locale } from '@fieldia/core';
+import type { Bounds, LatLng } from './geo.mjs';
+/**
+ * Where a map's images, credits and address search come from. Every map in
+ * the package draws through one of these, so an app changes provider in one
+ * place and nothing else moves. Keys never live in Fieldia: the app passes
+ * them, or a function that fetches a short-lived token from its own server.
+ * Credits are text and links built here, never HTML from a provider.
+ */
+export type BaseMap = 'road' | 'dark' | 'satellite';
+export interface TileSpec {
+    /** With `{z}`, `{x}` and `{y}` where the tile's numbers go. */
+    url: string;
+    maxZoom: number;
+    tileSize?: number;
+    zoomOffset?: number;
+    /** Headers each image is fetched with: a token that must not sit in an address. */
+    headers?: () => Promise<Record<string, string>>;
+}
+export interface Credit {
+    text: string;
+    href?: string;
+}
+export interface MapView {
+    zoom: number;
+    bounds: Bounds;
+}
+export interface PlaceFound {
+    /** The place itself: a name, or a street and its number. */
+    label: string;
+    /** Where it is, on the line under it: its district, city, country. */
+    detail?: string;
+    /** Where it is on the map; or, for a provider whose suggestions carry none (Google's), `locate` finds it when the place is picked. */
+    lat?: number;
+    lng?: number;
+    locate?: () => Promise<{
+        lat: number;
+        lng: number;
+        address?: string;
+    }>;
+}
+export interface SearchRequest {
+    text: string;
+    /** Where the map is: results near it first. */
+    near?: LatLng;
+    /** How close the map is, for how far "near" reaches. */
+    zoom?: number;
+    locale: Locale;
+    signal?: AbortSignal;
+}
+export type AddressSearch = (request: SearchRequest) => Promise<PlaceFound[]>;
+export type ReverseSearch = (at: LatLng & {
+    locale: Locale;
+    signal?: AbortSignal;
+}) => Promise<string | null>;
+export interface MapProvider {
+    readonly id: string;
+    /** The map images of a kind, or null when the provider has none of it. */
+    tiles(kind: BaseMap, locale: Locale): Promise<TileSpec | null>;
+    /** What must be credited under the map, for what is in view. */
+    credits(kind: BaseMap, view: MapView, locale: Locale): Promise<Credit[]>;
+    /** The provider's mark, which its terms ask for in the map's corner. */
+    readonly logo?: {
+        text: string;
+        image?: string;
+        href?: string;
+    };
+    readonly search?: AddressSearch;
+    readonly reverse?: ReverseSearch;
+    /** Whether its terms allow a search for each pause in typing; otherwise it searches when Enter is pressed. */
+    readonly searchAsYouType?: boolean;
+    /** Free for trying things out, not for an app in use: a warning says so once. */
+    readonly demoOnly?: boolean;
+}
+type Fetch = typeof globalThis.fetch;
+export interface OpenStreetMapOptions {
+    /**
+     * Whose search: Photon (komoot's, on OpenStreetMap's data), which answers as
+     * people type, nearest the map first; or Nominatim, OpenStreetMap's own,
+     * whose policy allows a search only when Enter is pressed.
+     */
+    search?: 'photon' | 'nominatim';
+    /** Photon's address, for a copy of it the app runs: `https://photon.komoot.io` unless said. */
+    photonUrl?: string;
+    fetch?: Fetch;
+}
+/**
+ * OpenStreetMap's own map images, for demos and development only (its usage
+ * policy treats an app in production as heavy use), with Photon's search,
+ * which answers as people type, or Nominatim's.
+ */
+export declare function openStreetMap(options?: OpenStreetMapOptions): MapProvider;
+export interface AzureMapsOptions {
+    /** A subscription key, restricted to the app's sites in Azure. */
+    key?: string;
+    /** Or a Microsoft Entra token, fetched from the app's own server; sent in a header with `clientId`. */
+    token?: () => Promise<string>;
+    clientId?: string;
+    fetch?: Fetch;
+}
+/** Microsoft Azure Maps: road, dark and satellite map images, credits for the view, and address search. */
+export declare function azureMaps(options: AzureMapsOptions): MapProvider;
+export interface GoogleMapsOptions {
+    key: string;
+    /** The country whose borders and names the map follows (CLDR, such as `EG`). */
+    region?: string;
+    /** Google's logo, as an image the app serves; its name is shown in its place until one is given. */
+    logo?: string;
+    fetch?: Fetch;
+}
+/**
+ * Google's map images through its Map Tiles API (a session for each kind and
+ * language, credits for the view, Google's mark in the corner its terms
+ * name), its Places API's suggestions as people type, and its Geocoding API
+ * to name a point. The key needs those three APIs enabled, and should be
+ * restricted to the app's sites.
+ */
+export declare function googleMaps(options: GoogleMapsOptions): MapProvider;
+export interface MapboxOptions {
+    token: string;
+    /** Style ids, `owner/style`. */
+    style?: string;
+    darkStyle?: string;
+    satelliteStyle?: string;
+    /** Mapbox's wordmark, as an image the app serves; its name is shown until one is given. */
+    logo?: string;
+    /**
+     * Ask for results the app may keep (Mapbox's permanent geocoding). On by
+     * default, because a place field keeps what it finds; off only for an app
+     * that stores nothing.
+     */
+    permanent?: boolean;
+    fetch?: Fetch;
+}
+/** Mapbox: its styles as map images, its credits and wordmark, and its address search as people type. */
+export declare function mapbox(options: MapboxOptions): MapProvider;
+export interface TilesOptions {
+    /** With `{z}`, `{x}` and `{y}`: the app's own map images, or any provider's. */
+    url: string;
+    darkUrl?: string;
+    satelliteUrl?: string;
+    credit: Credit | Credit[];
+    maxZoom?: number;
+    tileSize?: number;
+    zoomOffset?: number;
+    search?: AddressSearch;
+    reverse?: ReverseSearch;
+    searchAsYouType?: boolean;
+}
+/** Map images from any address, such as the app's own server, with their credit. */
+export declare function tiles(options: TilesOptions): MapProvider;
+export {};