@fieldia/map 0.17.0 → 0.19.0

package/src/lib/address-search.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addressSearchWidget = addressSearchWidget;
+const widgets_1 = require("@fieldia/widgets");
+const address_line_1 = require("./address-line");
+const search_box_1 = require("./search-box");
+/**
+ * An address typed on one line (`"widget": "address-search"` on a char
+ * field), the addresses the map's provider suggests as people type in a list
+ * under it, and no map: the place search's own combobox, its pauses, its
+ * credits and its language. What is typed is the answer when nothing is
+ * picked. A suggestion picked writes its whole address, and where the page
+ * says, its place into a place field (`placeField`: a json field's GeoJSON
+ * Point, or a float field's latitude with `longitudeField` for its
+ * longitude) and its parts into an address field (`partsField`, a
+ * `json.address`: street, city, region, postcode and country, the line under
+ * the street kept as typed). `countries` (ISO codes) keeps the suggestions to
+ * those countries; `near` (`{ "lat", "lng" }`) puts those near it first, as
+ * where the app's maps open does unless it says.
+ *
+ * The box is the app's own text box, there at once; the suggestions come
+ * with their code, loaded the first time an address field is shown. With no
+ * address search to ask, the text box is all there is.
+ */
+function addressSearchWidget(settings) {
+    return (context) => {
+        const plain = (0, widgets_1.createWidget)({ ...context, node: { ...context.node, widget: undefined } });
+        const search = settings.search ?? settings.provider.search;
+        const input = (plain.element.tagName === 'INPUT' ? plain.element : plain.element.querySelector('input'));
+        if (!search || !input)
+            return plain;
+        const element = context.document.createElement('div');
+        element.className = 'fd-address-search';
+        element.append(plain.element);
+        let stop;
+        // The place search's own combobox and line are handed over, as the page has them already: the suggestions' chunk carries neither.
+        Promise.resolve().then(() => require('./address-suggest')).then(({ suggest }) => {
+            if (stop === undefined)
+                stop = suggest({ settings, context, search, element, input, searchBox: search_box_1.searchBox, addressLine: address_line_1.addressLine });
+        });
+        return {
+            ...plain,
+            element,
+            destroy() {
+                stop?.();
+                stop = null;
+                plain.destroy?.();
+            },
+        };
+    };
+}
+//# sourceMappingURL=address-search.js.map

package/src/lib/address-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address-search.js","sourceRoot":"","sources":["../../../../../libs/map/src/lib/address-search.ts"],"names":[],"mappings":";;AAuBA,kDAwBC;AA/CD,8CAAoE;AACpE,iDAA6C;AAC7C,6CAAyC;AAGzC;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAgB,mBAAmB,CAAC,QAAqB;IACvD,OAAO,CAAC,OAAO,EAAE,EAAE;QACjB,MAAM,KAAK,GAAG,IAAA,sBAAY,EAAC,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;QACzF,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;QAC3D,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAA4B,CAAC;QACpI,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QACpC,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACtD,OAAO,CAAC,SAAS,GAAG,mBAAmB,CAAC;QACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC9B,IAAI,IAAqC,CAAC;QAC1C,kIAAkI;QAClI,qCAAO,mBAAmB,GAAE,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE;YAC/C,IAAI,IAAI,KAAK,SAAS;gBAAE,IAAI,GAAG,OAAO,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAT,sBAAS,EAAE,WAAW,EAAX,0BAAW,EAAE,CAAC,CAAC;QAChH,CAAC,CAAC,CAAC;QACH,OAAO;YACL,GAAG,KAAK;YACR,OAAO;YACP,OAAO;gBACL,IAAI,EAAE,EAAE,CAAC;gBACT,IAAI,GAAG,IAAI,CAAC;gBACZ,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YACpB,CAAC;SACF,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/src/lib/address-search.mjs

@@ -0,0 +1,49 @@
+import { createWidget } from '@fieldia/widgets';
+import { addressLine } from './address-line.mjs';
+import { searchBox } from './search-box.mjs';
+/**
+ * An address typed on one line (`"widget": "address-search"` on a char
+ * field), the addresses the map's provider suggests as people type in a list
+ * under it, and no map: the place search's own combobox, its pauses, its
+ * credits and its language. What is typed is the answer when nothing is
+ * picked. A suggestion picked writes its whole address, and where the page
+ * says, its place into a place field (`placeField`: a json field's GeoJSON
+ * Point, or a float field's latitude with `longitudeField` for its
+ * longitude) and its parts into an address field (`partsField`, a
+ * `json.address`: street, city, region, postcode and country, the line under
+ * the street kept as typed). `countries` (ISO codes) keeps the suggestions to
+ * those countries; `near` (`{ "lat", "lng" }`) puts those near it first, as
+ * where the app's maps open does unless it says.
+ *
+ * The box is the app's own text box, there at once; the suggestions come
+ * with their code, loaded the first time an address field is shown. With no
+ * address search to ask, the text box is all there is.
+ */
+export function addressSearchWidget(settings) {
+    return (context) => {
+        const plain = createWidget({ ...context, node: { ...context.node, widget: undefined } });
+        const search = settings.search ?? settings.provider.search;
+        const input = (plain.element.tagName === 'INPUT' ? plain.element : plain.element.querySelector('input'));
+        if (!search || !input)
+            return plain;
+        const element = context.document.createElement('div');
+        element.className = 'fd-address-search';
+        element.append(plain.element);
+        let stop;
+        // The place search's own combobox and line are handed over, as the page has them already: the suggestions' chunk carries neither.
+        import('./address-suggest.mjs').then(({ suggest }) => {
+            if (stop === undefined)
+                stop = suggest({ settings, context, search, element, input, searchBox, addressLine });
+        });
+        return {
+            ...plain,
+            element,
+            destroy() {
+                stop?.();
+                stop = null;
+                plain.destroy?.();
+            },
+        };
+    };
+}
+//# sourceMappingURL=address-search.mjs.map

package/src/lib/address-search.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"address-search.mjs","sourceRoot":"","sources":["../../../../../libs/map/src/lib/address-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAsB,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAqB;IACvD,OAAO,CAAC,OAAO,EAAE,EAAE;QACjB,MAAM,KAAK,GAAG,YAAY,CAAC,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;QACzF,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;QAC3D,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAA4B,CAAC;QACpI,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QACpC,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACtD,OAAO,CAAC,SAAS,GAAG,mBAAmB,CAAC;QACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC9B,IAAI,IAAqC,CAAC;QAC1C,kIAAkI;QAClI,MAAM,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE;YAC/C,IAAI,IAAI,KAAK,SAAS;gBAAE,IAAI,GAAG,OAAO,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,CAAC;QAChH,CAAC,CAAC,CAAC;QACH,OAAO;YACL,GAAG,KAAK;YACR,OAAO;YACP,OAAO;gBACL,IAAI,EAAE,EAAE,CAAC;gBACT,IAAI,GAAG,IAAI,CAAC;gBACZ,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YACpB,CAAC;SACF,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/src/lib/address-suggest.d.mts

@@ -0,0 +1,18 @@
+import type { WidgetContext } from '@fieldia/widgets';
+import type { addressLine } from './address-line.mjs';
+import type { AddressSearch } from './providers.mjs';
+import type { searchBox } from './search-box.mjs';
+import type { MapSettings } from './settings.mjs';
+export interface SuggestOptions {
+    settings: MapSettings;
+    context: WidgetContext;
+    search: AddressSearch;
+    /** The field's box, and what holds it (and the list under it). */
+    element: HTMLElement;
+    input: HTMLInputElement;
+    /** The place search's combobox, and the line it writes. */
+    searchBox: typeof searchBox;
+    addressLine: typeof addressLine;
+}
+/** The suggestions on the field's box; what it gives back takes them off. */
+export declare function suggest({ settings, context, search, element, input, searchBox, addressLine }: SuggestOptions): () => void;

package/src/lib/address-suggest.d.ts

@@ -0,0 +1,18 @@
+import type { WidgetContext } from '@fieldia/widgets';
+import type { addressLine } from './address-line';
+import type { AddressSearch } from './providers';
+import type { searchBox } from './search-box';
+import type { MapSettings } from './settings';
+export interface SuggestOptions {
+    settings: MapSettings;
+    context: WidgetContext;
+    search: AddressSearch;
+    /** The field's box, and what holds it (and the list under it). */
+    element: HTMLElement;
+    input: HTMLInputElement;
+    /** The place search's combobox, and the line it writes. */
+    searchBox: typeof searchBox;
+    addressLine: typeof addressLine;
+}
+/** The suggestions on the field's box; what it gives back takes them off. */
+export declare function suggest({ settings, context, search, element, input, searchBox, addressLine }: SuggestOptions): () => void;

package/src/lib/address-suggest.js

@@ -0,0 +1,140 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.suggest = suggest;
+const geo_1 = require("./geo");
+const address_labels_1 = require("./address-labels");
+const labels_1 = require("./labels");
+const map_core_1 = require("./map-core");
+const styles_1 = require("./styles");
+/**
+ * An address field's suggestions (address-search.ts), loaded the first time
+ * one is shown: the place search's combobox on the field's own box, its list
+ * in a box of its own under it with the provider's credit, and what a
+ * suggestion picked writes.
+ */
+/** The list as the place search draws it, in a box of its own with the credit under it; hidden with the list. */
+const ADDRESS_CSS = `
+.fd-address-search { position: relative; min-width: 0; }
+.fd-address-popup {
+  position: absolute; inset-inline: 0; top: calc(100% + 4px); z-index: 1100; overflow: hidden;
+  background: var(--fd-surface); color: var(--fd-text); border: 1px solid var(--fd-border); border-radius: var(--fd-control-radius); box-shadow: 0 8px 24px rgba(0, 0, 0, 0.16);
+}
+.fd-address-popup:has(> .fd-map-results[hidden]) { display: none; }
+.fd-address-popup .fd-map-results { position: static; max-height: 264px; border: 0; border-radius: 0; box-shadow: none; background: none; }
+.fd-address-credit { display: block; padding: 3px 10px 5px; border-top: 1px solid var(--fd-border); font-size: 11px; line-height: 1.4; color: var(--fd-muted); text-align: end; text-decoration: none; }
+a.fd-address-credit:hover { text-decoration: underline; }
+.fd-address-credit img { height: 14px; vertical-align: middle; }
+`;
+const round6 = (n) => Math.round(n * 1e6) / 1e6;
+const isObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+/** The suggestions on the field's box; what it gives back takes them off. */
+function suggest({ settings, context, search, element, input, searchBox, addressLine }) {
+    const { form, name, node, id, document: doc } = context;
+    const locale = context.locale ?? 'en';
+    const options = node.options ?? {};
+    const words = (0, address_labels_1.addressLabels)(locale, settings.labels?.[locale]);
+    const named = (key) => (typeof options[key] === 'string' ? options[key] : null);
+    const [placeField, longitudeField, partsField] = [named('placeField'), named('longitudeField'), named('partsField')];
+    const listed = options['countries'];
+    const countries = (Array.isArray(listed) ? listed.map(String) : typeof listed === 'string' ? listed.split(',') : []).map((code) => code.trim().toUpperCase()).filter(Boolean);
+    const near = isObject(options['near']) && (0, geo_1.isLatLng)(options['near']['lat'], options['near']['lng']) ? options['near'] : settings.center;
+    (0, styles_1.installMapStyles)(doc);
+    if (!doc.getElementById('fieldia-address-styles')) {
+        const style = doc.createElement('style');
+        style.id = 'fieldia-address-styles';
+        style.textContent = ADDRESS_CSS;
+        doc.head.prepend(style);
+    }
+    const status = doc.createElement('span');
+    status.className = 'fd-sr-only';
+    status.setAttribute('role', 'status');
+    /** Said to screen readers alone: how many suggestions came, or why none did. A typed address needs none to be an answer. */
+    const say = (said) => {
+        status.textContent = said ?? (box.list.hidden ? '' : (0, labels_1.fill)(words.suggested, { n: box.list.children.length }));
+        // Suggestions come: all of them in sight, as near the bottom of a phone's screen as the box is.
+        if (!box.list.hidden)
+            popup.scrollIntoView?.({ block: 'nearest' });
+    };
+    const write = (text) => {
+        input.value = text;
+        form.setValue(name, text || null);
+    };
+    let picking = 0;
+    const box = searchBox({
+        document: doc,
+        id,
+        input,
+        labels: words,
+        search: (request) => search({ ...request, ...(countries.length ? { countries } : {}), ...(partsField ? { parts: true } : {}) }),
+        asYouType: settings.search ? (settings.searchAsYouType ?? true) : !!settings.provider.searchAsYouType,
+        locale,
+        near: () => near,
+        zoom: () => settings.zoom,
+        freeText: true,
+        say,
+        // Its whole address at once; its place and parts as soon as they are known (looked up now, for a provider whose suggestions carry none).
+        async pick(place) {
+            const mine = ++picking;
+            const whole = addressLine([place.label, place.detail], locale);
+            write(whole);
+            let at = place.lat !== undefined && place.lng !== undefined ? { lat: place.lat, lng: place.lng } : null;
+            let parts = place.parts;
+            if (!at && place.locate && (placeField || (partsField && !parts))) {
+                const located = await place.locate().catch((error) => ((0, map_core_1.warnOnce)(`Finding the address picked failed: ${error.message}`), null));
+                if (mine !== picking || !located)
+                    return;
+                at = located;
+                parts = located.parts ?? parts;
+                // The provider's own way of writing it, unless a person has typed since.
+                if (located.address && input.value === whole)
+                    write(addressLine([located.address], locale));
+            }
+            if (at && placeField) {
+                if (form.page.fields[placeField]?.type !== 'float')
+                    form.setValue(placeField, (0, geo_1.asJson)((0, geo_1.writePoint)(at)));
+                else if (longitudeField) {
+                    form.setValue(placeField, round6(at.lat));
+                    form.setValue(longitudeField, round6(at.lng));
+                }
+            }
+            if (parts && partsField) {
+                const now = form.getState().values[partsField];
+                const line2 = isObject(now) && typeof now['line2'] === 'string' ? { line2: now['line2'] } : {};
+                form.setValue(partsField, { ...parts, ...line2 });
+            }
+        },
+    });
+    // The list with what the provider's terms ask to be said under it: its mark, or its credit.
+    const popup = doc.createElement('div');
+    popup.className = 'fd-address-popup';
+    popup.append(box.list);
+    const mark = settings.search ? undefined : (settings.provider.logo ?? settings.provider.searchCredit);
+    if (mark) {
+        const credit = doc.createElement(mark.href ? 'a' : 'span');
+        credit.className = 'fd-address-credit';
+        if (mark.href)
+            Object.assign(credit, { href: mark.href, target: '_blank', rel: 'noopener', tabIndex: -1 });
+        const image = 'image' in mark ? mark.image : undefined;
+        if (image) {
+            const img = doc.createElement('img');
+            Object.assign(img, { src: image, alt: mark.text });
+            credit.append(img);
+        }
+        else {
+            // Its own words in their own direction: "© OpenStreetMap contributors" in an Arabic page too.
+            const text = doc.createElement('bdi');
+            text.textContent = mark.text;
+            credit.append(text);
+        }
+        popup.append(credit);
+    }
+    // A press on it keeps the box's focus, so the list stays open and a credit's link opens.
+    popup.addEventListener('mousedown', (event) => event.preventDefault());
+    element.append(popup, status);
+    return () => {
+        box.destroy();
+        popup.remove();
+        status.remove();
+    };
+}
+//# sourceMappingURL=address-suggest.js.map

package/src/lib/address-suggest.js.map

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

package/src/lib/address-suggest.mjs

@@ -0,0 +1,137 @@
+import { asJson, isLatLng, writePoint } from './geo.mjs';
+import { addressLabels } from './address-labels.mjs';
+import { fill } from './labels.mjs';
+import { warnOnce } from './map-core.mjs';
+import { installMapStyles } from './styles.mjs';
+/**
+ * An address field's suggestions (address-search.ts), loaded the first time
+ * one is shown: the place search's combobox on the field's own box, its list
+ * in a box of its own under it with the provider's credit, and what a
+ * suggestion picked writes.
+ */
+/** The list as the place search draws it, in a box of its own with the credit under it; hidden with the list. */
+const ADDRESS_CSS = `
+.fd-address-search { position: relative; min-width: 0; }
+.fd-address-popup {
+  position: absolute; inset-inline: 0; top: calc(100% + 4px); z-index: 1100; overflow: hidden;
+  background: var(--fd-surface); color: var(--fd-text); border: 1px solid var(--fd-border); border-radius: var(--fd-control-radius); box-shadow: 0 8px 24px rgba(0, 0, 0, 0.16);
+}
+.fd-address-popup:has(> .fd-map-results[hidden]) { display: none; }
+.fd-address-popup .fd-map-results { position: static; max-height: 264px; border: 0; border-radius: 0; box-shadow: none; background: none; }
+.fd-address-credit { display: block; padding: 3px 10px 5px; border-top: 1px solid var(--fd-border); font-size: 11px; line-height: 1.4; color: var(--fd-muted); text-align: end; text-decoration: none; }
+a.fd-address-credit:hover { text-decoration: underline; }
+.fd-address-credit img { height: 14px; vertical-align: middle; }
+`;
+const round6 = (n) => Math.round(n * 1e6) / 1e6;
+const isObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+/** The suggestions on the field's box; what it gives back takes them off. */
+export function suggest({ settings, context, search, element, input, searchBox, addressLine }) {
+    const { form, name, node, id, document: doc } = context;
+    const locale = context.locale ?? 'en';
+    const options = node.options ?? {};
+    const words = addressLabels(locale, settings.labels?.[locale]);
+    const named = (key) => (typeof options[key] === 'string' ? options[key] : null);
+    const [placeField, longitudeField, partsField] = [named('placeField'), named('longitudeField'), named('partsField')];
+    const listed = options['countries'];
+    const countries = (Array.isArray(listed) ? listed.map(String) : typeof listed === 'string' ? listed.split(',') : []).map((code) => code.trim().toUpperCase()).filter(Boolean);
+    const near = isObject(options['near']) && isLatLng(options['near']['lat'], options['near']['lng']) ? options['near'] : settings.center;
+    installMapStyles(doc);
+    if (!doc.getElementById('fieldia-address-styles')) {
+        const style = doc.createElement('style');
+        style.id = 'fieldia-address-styles';
+        style.textContent = ADDRESS_CSS;
+        doc.head.prepend(style);
+    }
+    const status = doc.createElement('span');
+    status.className = 'fd-sr-only';
+    status.setAttribute('role', 'status');
+    /** Said to screen readers alone: how many suggestions came, or why none did. A typed address needs none to be an answer. */
+    const say = (said) => {
+        status.textContent = said ?? (box.list.hidden ? '' : fill(words.suggested, { n: box.list.children.length }));
+        // Suggestions come: all of them in sight, as near the bottom of a phone's screen as the box is.
+        if (!box.list.hidden)
+            popup.scrollIntoView?.({ block: 'nearest' });
+    };
+    const write = (text) => {
+        input.value = text;
+        form.setValue(name, text || null);
+    };
+    let picking = 0;
+    const box = searchBox({
+        document: doc,
+        id,
+        input,
+        labels: words,
+        search: (request) => search({ ...request, ...(countries.length ? { countries } : {}), ...(partsField ? { parts: true } : {}) }),
+        asYouType: settings.search ? (settings.searchAsYouType ?? true) : !!settings.provider.searchAsYouType,
+        locale,
+        near: () => near,
+        zoom: () => settings.zoom,
+        freeText: true,
+        say,
+        // Its whole address at once; its place and parts as soon as they are known (looked up now, for a provider whose suggestions carry none).
+        async pick(place) {
+            const mine = ++picking;
+            const whole = addressLine([place.label, place.detail], locale);
+            write(whole);
+            let at = place.lat !== undefined && place.lng !== undefined ? { lat: place.lat, lng: place.lng } : null;
+            let parts = place.parts;
+            if (!at && place.locate && (placeField || (partsField && !parts))) {
+                const located = await place.locate().catch((error) => (warnOnce(`Finding the address picked failed: ${error.message}`), null));
+                if (mine !== picking || !located)
+                    return;
+                at = located;
+                parts = located.parts ?? parts;
+                // The provider's own way of writing it, unless a person has typed since.
+                if (located.address && input.value === whole)
+                    write(addressLine([located.address], locale));
+            }
+            if (at && placeField) {
+                if (form.page.fields[placeField]?.type !== 'float')
+                    form.setValue(placeField, asJson(writePoint(at)));
+                else if (longitudeField) {
+                    form.setValue(placeField, round6(at.lat));
+                    form.setValue(longitudeField, round6(at.lng));
+                }
+            }
+            if (parts && partsField) {
+                const now = form.getState().values[partsField];
+                const line2 = isObject(now) && typeof now['line2'] === 'string' ? { line2: now['line2'] } : {};
+                form.setValue(partsField, { ...parts, ...line2 });
+            }
+        },
+    });
+    // The list with what the provider's terms ask to be said under it: its mark, or its credit.
+    const popup = doc.createElement('div');
+    popup.className = 'fd-address-popup';
+    popup.append(box.list);
+    const mark = settings.search ? undefined : (settings.provider.logo ?? settings.provider.searchCredit);
+    if (mark) {
+        const credit = doc.createElement(mark.href ? 'a' : 'span');
+        credit.className = 'fd-address-credit';
+        if (mark.href)
+            Object.assign(credit, { href: mark.href, target: '_blank', rel: 'noopener', tabIndex: -1 });
+        const image = 'image' in mark ? mark.image : undefined;
+        if (image) {
+            const img = doc.createElement('img');
+            Object.assign(img, { src: image, alt: mark.text });
+            credit.append(img);
+        }
+        else {
+            // Its own words in their own direction: "© OpenStreetMap contributors" in an Arabic page too.
+            const text = doc.createElement('bdi');
+            text.textContent = mark.text;
+            credit.append(text);
+        }
+        popup.append(credit);
+    }
+    // A press on it keeps the box's focus, so the list stays open and a credit's link opens.
+    popup.addEventListener('mousedown', (event) => event.preventDefault());
+    element.append(popup, status);
+    return () => {
+        box.destroy();
+        popup.remove();
+        status.remove();
+    };
+}
+//# sourceMappingURL=address-suggest.mjs.map

package/src/lib/address-suggest.mjs.map

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

package/src/lib/area-count.d.mts

@@ -0,0 +1,47 @@
+import type { ListMap, ResolvedFilter } from '@fieldia/core';
+import type { LatLng } from './geo.mjs';
+import { type Box } from './view-box.mjs';
+/**
+ * How many records a list map's view holds, said on "Search this area"
+ * before it is pressed: counted among the records on hand when they can
+ * tell, asked otherwise. Its code comes the first time the button shows.
+ */
+/** Whether a place lies in a box, its edges included, as `between` takes them. */
+export declare function inBox(at: LatLng, box: Box): boolean;
+/** Whether one box lies within another. */
+export declare function boxWithin(inner: Box, outer: Box): boolean;
+/**
+ * The view a search already holds, as the map's "Search this area" puts it
+ * (its very conditions, found among the search's), and the search's other
+ * conditions: a new view takes its place, as a search bar keeps one.
+ */
+export declare function ownBox(spec: ListMap, filter: readonly ResolvedFilter[]): {
+    box: Box;
+    rest: ResolvedFilter[];
+} | null;
+/**
+ * One question at a time, the last one winning: each ask waits `wait`
+ * milliseconds (a run of moves asks once), aborts the one before it, and an
+ * answer that comes after a newer ask is dropped. A refusal says nothing.
+ */
+export declare function lastAsk<T>(wait: number): {
+    ask(question: (signal: AbortSignal) => Promise<T>, answer: (value: T) => void): void;
+    stop: () => void;
+};
+/** What the map has on hand: the search its records were found by, whether they are all it finds, and where each is. */
+export interface OnHand {
+    filter: readonly ResolvedFilter[];
+    all: boolean;
+    places: readonly (LatLng | null)[];
+}
+/**
+ * The count for a view: the records on hand say it when they are all the
+ * search finds and the view lies within any area it already holds;
+ * otherwise `ask` (the app's count, or its source's) is asked, for the
+ * search with the view in the area's place, a moment after the map stops;
+ * otherwise there is no number.
+ */
+export declare function areaCounter(spec: ListMap, ask: ((filter: ResolvedFilter[], signal: AbortSignal) => Promise<number>) | null, say: (n: number) => void): {
+    count(view: Box, shown: OnHand): void;
+    stop: () => void;
+};

package/src/lib/area-count.d.ts

@@ -0,0 +1,47 @@
+import type { ListMap, ResolvedFilter } from '@fieldia/core';
+import type { LatLng } from './geo';
+import { type Box } from './view-box';
+/**
+ * How many records a list map's view holds, said on "Search this area"
+ * before it is pressed: counted among the records on hand when they can
+ * tell, asked otherwise. Its code comes the first time the button shows.
+ */
+/** Whether a place lies in a box, its edges included, as `between` takes them. */
+export declare function inBox(at: LatLng, box: Box): boolean;
+/** Whether one box lies within another. */
+export declare function boxWithin(inner: Box, outer: Box): boolean;
+/**
+ * The view a search already holds, as the map's "Search this area" puts it
+ * (its very conditions, found among the search's), and the search's other
+ * conditions: a new view takes its place, as a search bar keeps one.
+ */
+export declare function ownBox(spec: ListMap, filter: readonly ResolvedFilter[]): {
+    box: Box;
+    rest: ResolvedFilter[];
+} | null;
+/**
+ * One question at a time, the last one winning: each ask waits `wait`
+ * milliseconds (a run of moves asks once), aborts the one before it, and an
+ * answer that comes after a newer ask is dropped. A refusal says nothing.
+ */
+export declare function lastAsk<T>(wait: number): {
+    ask(question: (signal: AbortSignal) => Promise<T>, answer: (value: T) => void): void;
+    stop: () => void;
+};
+/** What the map has on hand: the search its records were found by, whether they are all it finds, and where each is. */
+export interface OnHand {
+    filter: readonly ResolvedFilter[];
+    all: boolean;
+    places: readonly (LatLng | null)[];
+}
+/**
+ * The count for a view: the records on hand say it when they are all the
+ * search finds and the view lies within any area it already holds;
+ * otherwise `ask` (the app's count, or its source's) is asked, for the
+ * search with the view in the area's place, a moment after the map stops;
+ * otherwise there is no number.
+ */
+export declare function areaCounter(spec: ListMap, ask: ((filter: ResolvedFilter[], signal: AbortSignal) => Promise<number>) | null, say: (n: number) => void): {
+    count(view: Box, shown: OnHand): void;
+    stop: () => void;
+};