@fieldia/map 0.14.1 → 0.16.0

package/src/lib/pins.js

@@ -0,0 +1,165 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.comma = void 0;
+exports.makePins = makePins;
+exports.withCurrency = withCurrency;
+exports.shown = shown;
+exports.pinText = pinText;
+exports.imageSource = imageSource;
+const core_1 = require("@fieldia/core");
+const widgets_1 = require("@fieldia/widgets");
+const map_icons_1 = require("./map-icons");
+/** The icons drawn as seen from above, facing north: they turn whole with a record's heading. */
+const FROM_ABOVE = new Set(['car', 'arrow']);
+const PIN = `<svg viewBox="0 0 30 40" aria-hidden="true" focusable="false"><path class="fd-map-face-body" d="M15 1C7.3 1 1 7.1 1 14.7 1 25.3 15 39 15 39s14-13.7 14-24.3C29 7.1 22.7 1 15 1z"/></svg>`;
+function makePins(options) {
+    const { document: doc, page, locale, pin } = options;
+    const icons = { ...map_icons_1.MAP_ICONS, ...options.icons };
+    const look = pin.widget ? 'own' : (pin.look ?? (pin.label ? 'label' : pin.image ? 'photo' : pin.icon || pin.iconField ? 'icon' : 'pin'));
+    const drawer = pin.widget ? options.drawers?.[pin.widget] : undefined;
+    const tones = (pin.tones ?? []).map(({ tone, when }) => ({ tone, when: (0, core_1.compileModifier)(when) }));
+    const fields = [
+        ...new Set([options.title, pin.label, pin.iconField, pin.image, pin.turn, ...tones.flatMap((t) => t.when.fields)]
+            .filter((name) => !!name && name in page.fields)
+            .flatMap((name) => withCurrency(page, name))),
+    ];
+    const toneOf = (values) => {
+        if (!tones.length)
+            return undefined;
+        const context = (0, core_1.expressionContext)(values, page.fields);
+        return tones.find((t) => t.when.evaluate(context))?.tone;
+    };
+    const icon = (values) => {
+        const named = pin.iconField ? values[pin.iconField] : undefined;
+        const name = typeof named === 'string' && named ? named : pin.icon;
+        return (0, widgets_1.drawIcon)(doc, name, icons) ?? (0, widgets_1.drawIcon)(doc, pin.icon ?? 'pin', icons);
+    };
+    const span = (className, ...children) => {
+        const element = doc.createElement('span');
+        element.className = className;
+        element.append(...children);
+        return element;
+    };
+    function face(record) {
+        const { values } = record;
+        const element = doc.createElement('div');
+        element.className = 'fd-map-face';
+        element.dataset['look'] = look;
+        const tone = toneOf(values);
+        if (tone)
+            element.dataset['tone'] = tone;
+        const said = pin.label ? pinText(page, pin.label, values, locale) : '';
+        if (look === 'own') {
+            if (drawer)
+                element.append(drawer(record, { document: doc, locale, page }));
+            element.dataset['stands'] = 'middle';
+            return { element, stands: 'middle', height: 32 };
+        }
+        if (look === 'label' && said) {
+            element.append(span('fd-map-face-text', said));
+            element.dataset['stands'] = 'foot';
+            return { element, stands: 'foot', height: 34 };
+        }
+        if (look === 'pin') {
+            element.innerHTML = PIN;
+            const inside = pin.icon || pin.iconField ? icon(values) : null;
+            element.append(span('fd-map-face-icon', ...(inside ? [inside] : [])));
+            element.dataset['stands'] = 'foot';
+            return { element, stands: 'foot', height: 40 };
+        }
+        if (look === 'icon') {
+            const drawn = icon(values);
+            const glyph = span('fd-map-face-icon', ...(drawn ? [drawn] : []));
+            element.append(glyph);
+            const turn = pin.turn ? values[pin.turn] : null;
+            if (typeof turn === 'number' && Number.isFinite(turn)) {
+                // A car seen from above turns itself; a scooter seen from its side stays upright, a pointer on its edge showing the way.
+                if (FROM_ABOVE.has(drawn?.dataset['icon'] ?? ''))
+                    glyph.style.transform = `rotate(${turn}deg)`;
+                else {
+                    const pointer = span('fd-map-face-turn');
+                    pointer.style.transform = `rotate(${turn}deg)`;
+                    element.append(pointer);
+                }
+            }
+            element.dataset['stands'] = 'middle';
+            return { element, stands: 'middle', height: 34 };
+        }
+        if (look === 'photo') {
+            const source = pin.image ? imageSource(values[pin.image]) : '';
+            if (source) {
+                const img = doc.createElement('img');
+                img.className = 'fd-map-face-photo';
+                img.alt = '';
+                img.decoding = 'async';
+                img.src = source;
+                element.append(img);
+            }
+            else
+                element.append(span('fd-map-face-photo', ...[(0, widgets_1.drawIcon)(doc, 'user', icons)].filter((n) => !!n)));
+            if (said)
+                element.append(span('fd-map-face-text', said));
+            element.dataset['stands'] = 'middle';
+            return { element, stands: 'middle', height: 42 };
+        }
+        // A dot; and a label with nothing to say.
+        element.dataset['look'] = 'dot';
+        element.dataset['stands'] = 'middle';
+        return { element, stands: 'middle', height: 16 };
+    }
+    function name(record) {
+        const title = shown(page, options.title, record.values, locale);
+        const said = pin.label && pin.label !== options.title ? shown(page, pin.label, record.values, locale) : '';
+        return [title, said].filter(Boolean).join((0, exports.comma)(locale)) || String(record.id);
+    }
+    return { face, name, fields };
+}
+/** The comma between a name's parts, in the page's language. */
+const comma = (locale) => (locale === 'ar' ? '، ' : ', ');
+exports.comma = comma;
+/** A field, and the field its amount's currency is in. */
+function withCurrency(page, name) {
+    const def = page.fields[name];
+    return def?.type === 'monetary' && def.currencyField && !def.currencyField.startsWith('parent.') ? [name, def.currencyField] : [name];
+}
+/** A value as a person reads it in full: a card's line, a pin's name. */
+function shown(page, name, values, locale) {
+    const def = page.fields[name];
+    const value = values[name];
+    if (value === null || value === undefined || value === '')
+        return '';
+    return def ? (0, widgets_1.displayValue)(def, value, values, locale) : String(value);
+}
+/**
+ * What a pin says, short enough for a pin: an amount or a number in the
+ * page's language, compact ("E£9.5M", "12K", "4.6"); anything else as a
+ * card would show it.
+ */
+function pinText(page, name, values, locale) {
+    const def = page.fields[name];
+    const value = values[name];
+    if (def && typeof value === 'number' && Number.isFinite(value) && (def.type === 'monetary' || def.type === 'integer' || def.type === 'float')) {
+        const currency = (0, widgets_1.currencyOf)(def, values);
+        const plain = { notation: 'compact', numberingSystem: 'latn', maximumFractionDigits: 1 };
+        try {
+            if (currency)
+                return new Intl.NumberFormat(locale, { ...plain, style: 'currency', currency, currencyDisplay: 'narrowSymbol' }).format(value);
+        }
+        catch {
+            // A currency named by words that are no code: written before the amount, as it is.
+            return `${currency} ${new Intl.NumberFormat(locale, plain).format(value)}`;
+        }
+        return new Intl.NumberFormat(locale, plain).format(value);
+    }
+    return shown(page, name, values, locale);
+}
+/** An image field's picture as an address: its first file's data, or where it is kept. */
+function imageSource(value) {
+    const file = (Array.isArray(value) ? value[0] : value);
+    if (!file)
+        return '';
+    if (typeof file === 'string')
+        return file;
+    return file.data ? `data:${file.type};base64,${file.data}` : (file.url ?? '');
+}
+//# sourceMappingURL=pins.js.map

package/src/lib/pins.js.map

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

package/src/lib/pins.mjs

@@ -0,0 +1,156 @@
+import { compileModifier, expressionContext } from '@fieldia/core';
+import { currencyOf, displayValue, drawIcon } from '@fieldia/widgets';
+import { MAP_ICONS } from './map-icons.mjs';
+/** The icons drawn as seen from above, facing north: they turn whole with a record's heading. */
+const FROM_ABOVE = new Set(['car', 'arrow']);
+const PIN = `<svg viewBox="0 0 30 40" aria-hidden="true" focusable="false"><path class="fd-map-face-body" d="M15 1C7.3 1 1 7.1 1 14.7 1 25.3 15 39 15 39s14-13.7 14-24.3C29 7.1 22.7 1 15 1z"/></svg>`;
+export function makePins(options) {
+    const { document: doc, page, locale, pin } = options;
+    const icons = { ...MAP_ICONS, ...options.icons };
+    const look = pin.widget ? 'own' : (pin.look ?? (pin.label ? 'label' : pin.image ? 'photo' : pin.icon || pin.iconField ? 'icon' : 'pin'));
+    const drawer = pin.widget ? options.drawers?.[pin.widget] : undefined;
+    const tones = (pin.tones ?? []).map(({ tone, when }) => ({ tone, when: compileModifier(when) }));
+    const fields = [
+        ...new Set([options.title, pin.label, pin.iconField, pin.image, pin.turn, ...tones.flatMap((t) => t.when.fields)]
+            .filter((name) => !!name && name in page.fields)
+            .flatMap((name) => withCurrency(page, name))),
+    ];
+    const toneOf = (values) => {
+        if (!tones.length)
+            return undefined;
+        const context = expressionContext(values, page.fields);
+        return tones.find((t) => t.when.evaluate(context))?.tone;
+    };
+    const icon = (values) => {
+        const named = pin.iconField ? values[pin.iconField] : undefined;
+        const name = typeof named === 'string' && named ? named : pin.icon;
+        return drawIcon(doc, name, icons) ?? drawIcon(doc, pin.icon ?? 'pin', icons);
+    };
+    const span = (className, ...children) => {
+        const element = doc.createElement('span');
+        element.className = className;
+        element.append(...children);
+        return element;
+    };
+    function face(record) {
+        const { values } = record;
+        const element = doc.createElement('div');
+        element.className = 'fd-map-face';
+        element.dataset['look'] = look;
+        const tone = toneOf(values);
+        if (tone)
+            element.dataset['tone'] = tone;
+        const said = pin.label ? pinText(page, pin.label, values, locale) : '';
+        if (look === 'own') {
+            if (drawer)
+                element.append(drawer(record, { document: doc, locale, page }));
+            element.dataset['stands'] = 'middle';
+            return { element, stands: 'middle', height: 32 };
+        }
+        if (look === 'label' && said) {
+            element.append(span('fd-map-face-text', said));
+            element.dataset['stands'] = 'foot';
+            return { element, stands: 'foot', height: 34 };
+        }
+        if (look === 'pin') {
+            element.innerHTML = PIN;
+            const inside = pin.icon || pin.iconField ? icon(values) : null;
+            element.append(span('fd-map-face-icon', ...(inside ? [inside] : [])));
+            element.dataset['stands'] = 'foot';
+            return { element, stands: 'foot', height: 40 };
+        }
+        if (look === 'icon') {
+            const drawn = icon(values);
+            const glyph = span('fd-map-face-icon', ...(drawn ? [drawn] : []));
+            element.append(glyph);
+            const turn = pin.turn ? values[pin.turn] : null;
+            if (typeof turn === 'number' && Number.isFinite(turn)) {
+                // A car seen from above turns itself; a scooter seen from its side stays upright, a pointer on its edge showing the way.
+                if (FROM_ABOVE.has(drawn?.dataset['icon'] ?? ''))
+                    glyph.style.transform = `rotate(${turn}deg)`;
+                else {
+                    const pointer = span('fd-map-face-turn');
+                    pointer.style.transform = `rotate(${turn}deg)`;
+                    element.append(pointer);
+                }
+            }
+            element.dataset['stands'] = 'middle';
+            return { element, stands: 'middle', height: 34 };
+        }
+        if (look === 'photo') {
+            const source = pin.image ? imageSource(values[pin.image]) : '';
+            if (source) {
+                const img = doc.createElement('img');
+                img.className = 'fd-map-face-photo';
+                img.alt = '';
+                img.decoding = 'async';
+                img.src = source;
+                element.append(img);
+            }
+            else
+                element.append(span('fd-map-face-photo', ...[drawIcon(doc, 'user', icons)].filter((n) => !!n)));
+            if (said)
+                element.append(span('fd-map-face-text', said));
+            element.dataset['stands'] = 'middle';
+            return { element, stands: 'middle', height: 42 };
+        }
+        // A dot; and a label with nothing to say.
+        element.dataset['look'] = 'dot';
+        element.dataset['stands'] = 'middle';
+        return { element, stands: 'middle', height: 16 };
+    }
+    function name(record) {
+        const title = shown(page, options.title, record.values, locale);
+        const said = pin.label && pin.label !== options.title ? shown(page, pin.label, record.values, locale) : '';
+        return [title, said].filter(Boolean).join(comma(locale)) || String(record.id);
+    }
+    return { face, name, fields };
+}
+/** The comma between a name's parts, in the page's language. */
+export const comma = (locale) => (locale === 'ar' ? '، ' : ', ');
+/** A field, and the field its amount's currency is in. */
+export function withCurrency(page, name) {
+    const def = page.fields[name];
+    return def?.type === 'monetary' && def.currencyField && !def.currencyField.startsWith('parent.') ? [name, def.currencyField] : [name];
+}
+/** A value as a person reads it in full: a card's line, a pin's name. */
+export function shown(page, name, values, locale) {
+    const def = page.fields[name];
+    const value = values[name];
+    if (value === null || value === undefined || value === '')
+        return '';
+    return def ? displayValue(def, value, values, locale) : String(value);
+}
+/**
+ * What a pin says, short enough for a pin: an amount or a number in the
+ * page's language, compact ("E£9.5M", "12K", "4.6"); anything else as a
+ * card would show it.
+ */
+export function pinText(page, name, values, locale) {
+    const def = page.fields[name];
+    const value = values[name];
+    if (def && typeof value === 'number' && Number.isFinite(value) && (def.type === 'monetary' || def.type === 'integer' || def.type === 'float')) {
+        const currency = currencyOf(def, values);
+        const plain = { notation: 'compact', numberingSystem: 'latn', maximumFractionDigits: 1 };
+        try {
+            if (currency)
+                return new Intl.NumberFormat(locale, { ...plain, style: 'currency', currency, currencyDisplay: 'narrowSymbol' }).format(value);
+        }
+        catch {
+            // A currency named by words that are no code: written before the amount, as it is.
+            return `${currency} ${new Intl.NumberFormat(locale, plain).format(value)}`;
+        }
+        return new Intl.NumberFormat(locale, plain).format(value);
+    }
+    return shown(page, name, values, locale);
+}
+/** An image field's picture as an address: its first file's data, or where it is kept. */
+export function imageSource(value) {
+    const file = (Array.isArray(value) ? value[0] : value);
+    if (!file)
+        return '';
+    if (typeof file === 'string')
+        return file;
+    return file.data ? `data:${file.type};base64,${file.data}` : (file.url ?? '');
+}
+//# sourceMappingURL=pins.mjs.map

package/src/lib/pins.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pins.mjs","sourceRoot":"","sources":["../../../../../libs/map/src/lib/pins.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAuH,MAAM,eAAe,CAAC;AACxL,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAgB,MAAM,kBAAkB,CAAC;AACpF,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AA6CxC,iGAAiG;AACjG,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;AAE7C,MAAM,GAAG,GAAG,0LAA0L,CAAC;AAEvM,MAAM,UAAU,QAAQ,CAAC,OAAoB;IAC3C,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;IACrD,MAAM,KAAK,GAAY,EAAE,GAAG,SAAS,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAC1D,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IACzI,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACtE,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IACjG,MAAM,MAAM,GAAG;QACb,GAAG,IAAI,GAAG,CACR,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;aACnG,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC;aAC/D,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAC/C;KACF,CAAC;IAEF,MAAM,MAAM,GAAG,CAAC,MAAc,EAAoB,EAAE;QAClD,IAAI,CAAC,KAAK,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QACpC,MAAM,OAAO,GAAG,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACvD,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,CAAC;IAC3D,CAAC,CAAC;IACF,MAAM,IAAI,GAAG,CAAC,MAAc,EAAE,EAAE;QAC9B,MAAM,KAAK,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAChE,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;QACnE,OAAO,QAAQ,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,IAAI,KAAK,EAAE,KAAK,CAAC,CAAC;IAC/E,CAAC,CAAC;IACF,MAAM,IAAI,GAAG,CAAC,SAAiB,EAAE,GAAG,QAA2B,EAAE,EAAE;QACjE,MAAM,OAAO,GAAG,GAAG,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAC1C,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;QAC9B,OAAO,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC;QAC5B,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC;IAEF,SAAS,IAAI,CAAC,MAAiB;QAC7B,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;QAC1B,MAAM,OAAO,GAAG,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACzC,OAAO,CAAC,SAAS,GAAG,aAAa,CAAC;QAClC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;QAC/B,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5B,IAAI,IAAI;YAAE,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;QACzC,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACvE,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;YACnB,IAAI,MAAM;gBAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAC5E,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;YACrC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QACnD,CAAC;QACD,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,EAAE,CAAC;YAC7B,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC,CAAC;YAC/C,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC;YACnC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QACjD,CAAC;QACD,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;YACnB,OAAO,CAAC,SAAS,GAAG,GAAG,CAAC;YACxB,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAC/D,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YACtE,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC;YACnC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QACjD,CAAC;QACD,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACpB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;YAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,kBAAkB,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAClE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACtB,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAChD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtD,yHAAyH;gBACzH,IAAI,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;oBAAE,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,UAAU,IAAI,MAAM,CAAC;qBAC1F,CAAC;oBACJ,MAAM,OAAO,GAAG,IAAI,CAAC,kBAAkB,CAAC,CAAC;oBACzC,OAAO,CAAC,KAAK,CAAC,SAAS,GAAG,UAAU,IAAI,MAAM,CAAC;oBAC/C,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBAC1B,CAAC;YACH,CAAC;YACD,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;YACrC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QACnD,CAAC;QACD,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YACrB,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/D,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,GAAG,GAAG,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;gBACrC,GAAG,CAAC,SAAS,GAAG,mBAAmB,CAAC;gBACpC,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC;gBACb,GAAG,CAAC,QAAQ,GAAG,OAAO,CAAC;gBACvB,GAAG,CAAC,GAAG,GAAG,MAAM,CAAC;gBACjB,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACtB,CAAC;;gBAAM,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,mBAAmB,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAsB,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3H,IAAI,IAAI;gBAAE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC,CAAC;YACzD,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;YACrC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QACnD,CAAC;QACD,0CAA0C;QAC1C,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC;QAChC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;QACrC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACnD,CAAC;IAED,SAAS,IAAI,CAAC,MAAiB;QAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChE,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3G,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAChF,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAChC,CAAC;AAED,gEAAgE;AAChE,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,MAAc,EAAE,EAAE,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAEzE,0DAA0D;AAC1D,MAAM,UAAU,YAAY,CAAC,IAAU,EAAE,IAAY;IACnD,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,GAAG,EAAE,IAAI,KAAK,UAAU,IAAI,GAAG,CAAC,aAAa,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACxI,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,KAAK,CAAC,IAAU,EAAE,IAAY,EAAE,MAAc,EAAE,MAAc;IAC5E,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3B,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC;IACrE,OAAO,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,GAAgB,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACrF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,IAAU,EAAE,IAAY,EAAE,MAAc,EAAE,MAAc;IAC9E,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,KAAK,GAAsB,MAAM,CAAC,IAAI,CAAC,CAAC;IAC9C,IAAI,GAAG,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,UAAU,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,CAAC,EAAE,CAAC;QAC9I,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAgB,EAAE,MAAM,CAAC,CAAC;QACtD,MAAM,KAAK,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC,EAAW,CAAC;QAClG,IAAI,CAAC;YACH,IAAI,QAAQ;gBAAE,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,eAAe,EAAE,cAAc,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/I,CAAC;QAAC,MAAM,CAAC;YACP,mFAAmF;YACnF,OAAO,GAAG,QAAQ,IAAI,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7E,CAAC;QACD,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAC3C,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,WAAW,CAAC,KAAwB;IAClD,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAA0C,CAAC;IAChG,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC1C,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,IAAI,WAAW,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;AAChF,CAAC"}

package/src/lib/providers.d.mts

@@ -1,7 +1,8 @@
 import type { Locale } from '@fieldia/core';
+import { type Fetch } from './answers.mjs';
 import type { Bounds, LatLng } from './geo.mjs';
 /**
- * Where a map's images, credits and address search come from. Every map in
+ * Where a map's images, credits, address search and routes 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.
@@ -53,6 +54,21 @@ export type ReverseSearch = (at: LatLng & {
     locale: Locale;
     signal?: AbortSignal;
 }) => Promise<string | null>;
+export type TravelMode = 'car' | 'bike' | 'foot';
+export interface RouteRequest {
+    /** Where it starts, the places it passes in order, and where it ends. */
+    points: LatLng[];
+    mode: TravelMode;
+    locale: Locale;
+    signal?: AbortSignal;
+}
+/** A route along the roads: its line, how long it is, and how long it takes. */
+export interface RouteFound {
+    line: LatLng[];
+    metres: number;
+    seconds: number;
+}
+export type RouteFinder = (request: RouteRequest) => Promise<RouteFound>;
 export interface MapProvider {
     readonly id: string;
     /** The map images of a kind, or null when the provider has none of it. */
@@ -71,8 +87,9 @@ export interface MapProvider {
     readonly searchAsYouType?: boolean;
     /** Free for trying things out, not for an app in use: a warning says so once. */
     readonly demoOnly?: boolean;
+    /** A route along the roads, for a map's routes. */
+    readonly route?: RouteFinder;
 }
-type Fetch = typeof globalThis.fetch;
 export interface OpenStreetMapOptions {
     /**
      * Whose search: Photon (komoot's, on OpenStreetMap's data), which answers as
@@ -82,6 +99,12 @@ export interface OpenStreetMapOptions {
     search?: 'photon' | 'nominatim';
     /** Photon's address, for a copy of it the app runs: `https://photon.komoot.io` unless said. */
     photonUrl?: string;
+    /**
+     * OSRM's address, for routes: its public demo server unless said, which
+     * routes by car alone and is for trying things out. A copy the app runs
+     * routes by the profiles it was built with (`driving`, `cycling`, `walking`).
+     */
+    osrmUrl?: string;
     fetch?: Fetch;
 }
 /**
@@ -146,7 +169,8 @@ export interface TilesOptions {
     search?: AddressSearch;
     reverse?: ReverseSearch;
     searchAsYouType?: boolean;
+    /** The app's own routes. */
+    route?: RouteFinder;
 }
 /** Map images from any address, such as the app's own server, with their credit. */
 export declare function tiles(options: TilesOptions): MapProvider;
-export {};

package/src/lib/providers.d.ts

@@ -1,7 +1,8 @@
 import type { Locale } from '@fieldia/core';
+import { type Fetch } from './answers';
 import type { Bounds, LatLng } from './geo';
 /**
- * Where a map's images, credits and address search come from. Every map in
+ * Where a map's images, credits, address search and routes 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.
@@ -53,6 +54,21 @@ export type ReverseSearch = (at: LatLng & {
     locale: Locale;
     signal?: AbortSignal;
 }) => Promise<string | null>;
+export type TravelMode = 'car' | 'bike' | 'foot';
+export interface RouteRequest {
+    /** Where it starts, the places it passes in order, and where it ends. */
+    points: LatLng[];
+    mode: TravelMode;
+    locale: Locale;
+    signal?: AbortSignal;
+}
+/** A route along the roads: its line, how long it is, and how long it takes. */
+export interface RouteFound {
+    line: LatLng[];
+    metres: number;
+    seconds: number;
+}
+export type RouteFinder = (request: RouteRequest) => Promise<RouteFound>;
 export interface MapProvider {
     readonly id: string;
     /** The map images of a kind, or null when the provider has none of it. */
@@ -71,8 +87,9 @@ export interface MapProvider {
     readonly searchAsYouType?: boolean;
     /** Free for trying things out, not for an app in use: a warning says so once. */
     readonly demoOnly?: boolean;
+    /** A route along the roads, for a map's routes. */
+    readonly route?: RouteFinder;
 }
-type Fetch = typeof globalThis.fetch;
 export interface OpenStreetMapOptions {
     /**
      * Whose search: Photon (komoot's, on OpenStreetMap's data), which answers as
@@ -82,6 +99,12 @@ export interface OpenStreetMapOptions {
     search?: 'photon' | 'nominatim';
     /** Photon's address, for a copy of it the app runs: `https://photon.komoot.io` unless said. */
     photonUrl?: string;
+    /**
+     * OSRM's address, for routes: its public demo server unless said, which
+     * routes by car alone and is for trying things out. A copy the app runs
+     * routes by the profiles it was built with (`driving`, `cycling`, `walking`).
+     */
+    osrmUrl?: string;
     fetch?: Fetch;
 }
 /**
@@ -146,7 +169,8 @@ export interface TilesOptions {
     search?: AddressSearch;
     reverse?: ReverseSearch;
     searchAsYouType?: boolean;
+    /** The app's own routes. */
+    route?: RouteFinder;
 }
 /** Map images from any address, such as the app's own server, with their credit. */
 export declare function tiles(options: TilesOptions): MapProvider;
-export {};