@fieldia/map 0.17.0 → 0.19.0

package/README.md

@@ -108,6 +108,59 @@ styles or its words.
 A card offers the list's own buttons too, each pressed for its record alone
 ("Assign", for this driver).
 
+How the map sits in its page: `height` is pixels, or `fill` (as tall as the
+element it is put in), as tall as the window allows (320 to 640 pixels) unless
+said; `gestures: "all"` lets the map take every gesture — one finger pans, the
+wheel zooms with no key held — where it is most of its page (unless said, one
+finger and the wheel scroll the page past it); `fitZoom` is the closest it comes
+when it fits its records, 16 unless said.
+
+Once the map is moved, "Search this area" says how many records the view holds,
+"Search this area (24)", when the records on hand can tell (all the search
+finds, and a view within any area already searched). Otherwise, with
+`countArea: true` in the settings, the data source is asked: one record, its
+`total` the count, a moment after the map stops, the request's `signal` aborted
+when it moves again; or `countArea` is the app's own
+`(filter, signal) => Promise<number>`. Each time it stops, the map's element
+sends `fd-map-view` (it bubbles): `{ center, zoom, bounds, byPerson }`.
+
+## A list's map in a page of your own
+
+A page that is not Fieldia's — its own list, filters and address — shows a list's
+map beside them with `mountListMap`. The app gives the page that describes the
+records (a list with `map`), a data source or the records themselves, the
+conditions they are found by, and what to do when the map asks for something; it
+gets back the map.
+
+```ts
+import { mountListMap, azureMaps } from '@fieldia/map';
+
+const map = mountListMap(element, {
+  page,                                          // a list page with "map"
+  provider: azureMaps({ key }),
+  dataSource,                                    // or records: [{ id, values }, …]
+  filter: () => yourSearch(),                    // the conditions the records are found by
+  start: { center: { lat: 30.05, lng: 31.23 }, zoom: 13 },   // from the address: no fit at first
+  countArea: true,
+  onSearch: ({ kind, filter }) => { keep(kind, filter); map.reload(); },  // 'view', 'drawn' or 'region'
+  onViewChange: ({ center, zoom, bounds, byPerson }) => writeTheAddress(center, zoom),
+  onHighlight: (id) => lightYourRow(id),
+  onOpenRecord: (id) => location.assign(`/homes/${id}`),
+});
+map.highlight(id);   // a row of yours under the pointer
+map.reload();        // your search changed
+map.destroy();
+```
+
+Also `locale` (a tag; the document's language unless said), `sort`, `icons`,
+`isChosen` and `onChoose`, `actions` and `onAction`, `onSort` (Nearest first),
+and every setting `mapListViews` takes. Without `onSearch` the map offers no
+search. It brings its own base on its own element alone (a part hidden stays
+hidden, words for a screen reader, its buttons) and Fieldia's colours as tokens,
+light or dark by the page's `color-scheme`: set your own on `.fd-map-embed`
+(`.fd-map-embed { --fd-accent: #375dfb; }`), and your rule wins whatever its
+weight.
+
 ## A map on a form
 
 A part of type `map` shows the record's places as layers: the record's own
@@ -136,6 +189,14 @@ seconds, metres and line go into. Routes come from the provider (`route`),
 loaded the first time one is asked for, or from the app's own `route` in the
 settings.
 
+Pins that crowd are gathered as a list's map gathers them, again at each zoom:
+a bubble with their count ("2 here: Delta Foods, Amira Clinics. Zoom in to see
+them."), pressed to zoom in until they part, or to list them when they stand on
+one spot. A place that moves is never hidden in a bubble: the pins that crowd
+it are gathered under it, and it wears their count, still gliding, greying and
+followed. Routes, reachable areas and fences read where places are, never where
+a bubble stands.
+
 ## Areas by colour, reach and fences
 
 Districts, zones or municipalities shaded in up to five steps of the page's
@@ -163,8 +224,10 @@ the browser showing the map: what must happen once, your server watches.
 
 A list's map with `heat` shows its records as a heat map from afar (each
 weighing one, or `weight`), their pins back at the streets. Any map takes
-`tools`: `satellite`, `fullscreen`, `measure`, and on a list's map `nearest`
-(its records nearest the reader first, the data source sorting by `near`).
+`tools`: `satellite`, `traffic` (the provider's live traffic over the map),
+`fullscreen`, `measure`, and on a list's map `nearest` (its records nearest the
+reader first, the data source sorting by `near`). A provider with no satellite
+images or no traffic shows no button for them.
 Areas, reach, fences, the heat map and the tools each load with the first map
 that has them.
 
@@ -180,17 +243,19 @@ move the map.
 
 On a list's map, Tab goes from the map to each pin and bubble by its name;
 Enter or Space opens a pin's card (Ctrl or ⌘ with it chooses the record) or
-zooms into a bubble, and Escape closes the card, back on its pin.
+zooms into a bubble, and Escape closes the card, back on its pin. A form's map
+does the same, its bubbles saying whose pins they hold; the keys stay on the
+pin, or the bubble, that holds the place they were on.
 
 ## Providers
 
-| Provider | Road | Dark | Satellite | Address search | Routes | Reachable area |
-| --- | --- | --- | --- | --- | --- | --- |
-| `azureMaps({ key })` or `({ token, clientId })` | yes | yes | yes | yes, as people type | car, foot | car |
-| `googleMaps({ key, region, logo })` (Map Tiles API) | yes | no | yes | Places API, as people type | car, bike, foot (Routes API) | no |
-| `mapbox({ token })` | yes | yes | yes | yes, as people type | car (traffic), bike, foot | car, bike, foot |
-| `tiles({ url, credit, route, reach })` | the app's own map images | | | the app's own | the app's own | the app's own |
-| `openStreetMap()` | yes, **for demos only** | no | no | Photon, as people type, nearest first (or `{ search: 'nominatim' }`, on Enter) | OSRM's demo server, car only (or `osrmUrl`) | no |
+| Provider | Road | Dark | Satellite | Traffic | Address search | Routes | Reachable area |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| `azureMaps({ key })` or `({ token, clientId })` | yes | yes | yes | yes, from zoom 6, in dark colours on the dark map, drawn again every four minutes | yes, as people type | car, foot | car |
+| `googleMaps({ key, region, logo })` (Map Tiles API) | yes | no | yes | yes, its traffic layer | Places API, as people type | car, bike, foot (Routes API) | no |
+| `mapbox({ token, trafficStyle })` | yes | yes | yes | from `trafficStyle`, a style of yours with Mapbox Traffic's lines alone | yes, as people type | car (traffic), bike, foot | car, bike, foot |
+| `tiles({ url, credit, trafficUrl, route, reach })` | the app's own map images | | | the app's own (`trafficUrl`) | the app's own | the app's own | the app's own |
+| `openStreetMap()` | yes, **for demos only** | no | no | no | Photon, as people type, nearest first (or `{ search: 'nominatim' }`, on Enter) | OSRM's demo server, car only (or `osrmUrl`) | no |
 
 Keys never live in Fieldia: pass one restricted to your sites, or a function
 fetching a short-lived token from your server. Each provider's credits are shown

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fieldia/map",
-  "version": "0.17.0",
+  "version": "0.19.0",
   "description": "Fieldia's maps: a place and an area as fields, and a list's records on a map, on any map provider. Leaflet, loaded only where a map is shown.",
   "license": "MIT",
   "homepage": "https://fieldia.dev",
@@ -21,9 +21,9 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@fieldia/core": "0.17.0",
-    "@fieldia/viewer": "0.17.0",
-    "@fieldia/widgets": "0.17.0",
+    "@fieldia/core": "0.19.0",
+    "@fieldia/viewer": "0.19.0",
+    "@fieldia/widgets": "0.19.0",
     "leaflet": "^1.9.4",
     "tslib": "^2.8.1"
   },

package/src/index.d.mts

@@ -8,3 +8,8 @@ export type { MapSettings } from './lib/settings.mjs';
 export { azureMaps, googleMaps, mapbox, openStreetMap, tiles, type AddressSearch, type AzureMapsOptions, type BaseMap, type Credit, type GoogleMapsOptions, type MapboxOptions, type MapProvider, type MapView, type OpenStreetMapOptions, type PlaceFound, type ReachFinder, type ReachFound, type ReachRequest, type ReverseSearch, type RouteFinder, type RouteFound, type RouteRequest, type TravelMode, type SearchRequest, type TileSpec, type TilesOptions, } from './lib/providers.mjs';
 export { readArea, readPoint, writeArea, writePoint, metresBetween, type Area, type AreaFeature, type LatLng, type PointGeometry, type Shape } from './lib/geo.mjs';
 export { MAP_LABELS, type MapLabels } from './lib/labels.mjs';
+export type { AddressLabels } from './lib/address-labels.mjs';
+export type { AddressParts } from './lib/address-parts.mjs';
+export { mountListMap, type ListMapHandle, type ListMapOptions } from './lib/embed.mjs';
+export type { MapSearch, MapViewChange } from './lib/list-view.mjs';
+export type { Box as MapBounds } from './lib/view-box.mjs';

package/src/index.d.ts

@@ -8,3 +8,8 @@ export type { MapSettings } from './lib/settings';
 export { azureMaps, googleMaps, mapbox, openStreetMap, tiles, type AddressSearch, type AzureMapsOptions, type BaseMap, type Credit, type GoogleMapsOptions, type MapboxOptions, type MapProvider, type MapView, type OpenStreetMapOptions, type PlaceFound, type ReachFinder, type ReachFound, type ReachRequest, type ReverseSearch, type RouteFinder, type RouteFound, type RouteRequest, type TravelMode, type SearchRequest, type TileSpec, type TilesOptions, } from './lib/providers';
 export { readArea, readPoint, writeArea, writePoint, metresBetween, type Area, type AreaFeature, type LatLng, type PointGeometry, type Shape } from './lib/geo';
 export { MAP_LABELS, type MapLabels } from './lib/labels';
+export type { AddressLabels } from './lib/address-labels';
+export type { AddressParts } from './lib/address-parts';
+export { mountListMap, type ListMapHandle, type ListMapOptions } from './lib/embed';
+export type { MapSearch, MapViewChange } from './lib/list-view';
+export type { Box as MapBounds } from './lib/view-box';

package/src/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MAP_LABELS = exports.metresBetween = exports.writePoint = exports.writeArea = exports.readPoint = exports.readArea = exports.tiles = exports.openStreetMap = exports.mapbox = exports.googleMaps = exports.azureMaps = exports.mapKinds = exports.MAP_ICONS = exports.mapParts = exports.mapListViews = exports.mapWidgets = void 0;
+exports.mountListMap = exports.MAP_LABELS = exports.metresBetween = exports.writePoint = exports.writeArea = exports.readPoint = exports.readArea = exports.tiles = exports.openStreetMap = exports.mapbox = exports.googleMaps = exports.azureMaps = exports.mapKinds = exports.MAP_ICONS = exports.mapParts = exports.mapListViews = exports.mapWidgets = void 0;
 var widgets_1 = require("./lib/widgets");
 Object.defineProperty(exports, "mapWidgets", { enumerable: true, get: function () { return widgets_1.mapWidgets; } });
 var list_view_1 = require("./lib/list-view");
@@ -25,4 +25,7 @@ Object.defineProperty(exports, "writePoint", { enumerable: true, get: function (
 Object.defineProperty(exports, "metresBetween", { enumerable: true, get: function () { return geo_1.metresBetween; } });
 var labels_1 = require("./lib/labels");
 Object.defineProperty(exports, "MAP_LABELS", { enumerable: true, get: function () { return labels_1.MAP_LABELS; } });
+// A list's map in a page of the app's own, outside the viewer.
+var embed_1 = require("./lib/embed");
+Object.defineProperty(exports, "mountListMap", { enumerable: true, get: function () { return embed_1.mountListMap; } });
 //# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/map/src/index.ts"],"names":[],"mappings":";;;AAAA,yCAA2C;AAAlC,qGAAA,UAAU,OAAA;AACnB,6CAA+C;AAAtC,yGAAA,YAAY,OAAA;AACrB,2CAA0C;AAAjC,oGAAA,QAAQ,OAAA;AACjB,6CAA4C;AAAnC,sGAAA,SAAS,OAAA;AAElB,qCAA0E;AAAjE,iGAAA,QAAQ,OAAA;AAEjB,6CA2ByB;AA1BvB,sGAAA,SAAS,OAAA;AACT,uGAAA,UAAU,OAAA;AACV,mGAAA,MAAM,OAAA;AACN,0GAAA,aAAa,OAAA;AACb,kGAAA,KAAK,OAAA;AAuBP,iCAAgK;AAAvJ,+FAAA,QAAQ,OAAA;AAAE,gGAAA,SAAS,OAAA;AAAE,gGAAA,SAAS,OAAA;AAAE,iGAAA,UAAU,OAAA;AAAE,oGAAA,aAAa,OAAA;AAClE,uCAA0D;AAAjD,oGAAA,UAAU,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/map/src/index.ts"],"names":[],"mappings":";;;AAAA,yCAA2C;AAAlC,qGAAA,UAAU,OAAA;AACnB,6CAA+C;AAAtC,yGAAA,YAAY,OAAA;AACrB,2CAA0C;AAAjC,oGAAA,QAAQ,OAAA;AACjB,6CAA4C;AAAnC,sGAAA,SAAS,OAAA;AAElB,qCAA0E;AAAjE,iGAAA,QAAQ,OAAA;AAEjB,6CA2ByB;AA1BvB,sGAAA,SAAS,OAAA;AACT,uGAAA,UAAU,OAAA;AACV,mGAAA,MAAM,OAAA;AACN,0GAAA,aAAa,OAAA;AACb,kGAAA,KAAK,OAAA;AAuBP,iCAAgK;AAAvJ,+FAAA,QAAQ,OAAA;AAAE,gGAAA,SAAS,OAAA;AAAE,gGAAA,SAAS,OAAA;AAAE,iGAAA,UAAU,OAAA;AAAE,oGAAA,aAAa,OAAA;AAClE,uCAA0D;AAAjD,oGAAA,UAAU,OAAA;AAGnB,+DAA+D;AAC/D,qCAAoF;AAA3E,qGAAA,YAAY,OAAA"}

package/src/index.mjs

@@ -6,4 +6,6 @@ export { mapKinds } from './lib/kinds.mjs';
 export { azureMaps, googleMaps, mapbox, openStreetMap, tiles, } from './lib/providers.mjs';
 export { readArea, readPoint, writeArea, writePoint, metresBetween } from './lib/geo.mjs';
 export { MAP_LABELS } from './lib/labels.mjs';
+// A list's map in a page of the app's own, outside the viewer.
+export { mountListMap } from './lib/embed.mjs';
 //# sourceMappingURL=index.mjs.map

package/src/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../../libs/map/src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,QAAQ,EAAqC,MAAM,aAAa,CAAC;AAE1E,OAAO,EACL,SAAS,EACT,UAAU,EACV,MAAM,EACN,aAAa,EACb,KAAK,GAsBN,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAA4E,MAAM,WAAW,CAAC;AAChK,OAAO,EAAE,UAAU,EAAkB,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../../libs/map/src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,QAAQ,EAAqC,MAAM,aAAa,CAAC;AAE1E,OAAO,EACL,SAAS,EACT,UAAU,EACV,MAAM,EACN,aAAa,EACb,KAAK,GAsBN,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAA4E,MAAM,WAAW,CAAC;AAChK,OAAO,EAAE,UAAU,EAAkB,MAAM,cAAc,CAAC;AAG1D,+DAA+D;AAC/D,OAAO,EAAE,YAAY,EAA2C,MAAM,aAAa,CAAC"}

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

@@ -0,0 +1,21 @@
+import type { Locale } from '@fieldia/core';
+import { type MapLabels } from './labels.mjs';
+/**
+ * The words of an address field that suggests addresses
+ * (`char.address-search`), and of its kind in the designer: in a module of
+ * their own, so a page that shows forms (and no designer) loads them with
+ * the field's suggestions, not before.
+ */
+export interface AddressLabels {
+    /** Said to screen readers as suggestions come: `{n}` how many. */
+    suggested: string;
+    addressKind: string;
+    /** The designer's settings: the field a picked address's place goes into, the field its parts go into, the country it keeps to. */
+    settingPlace: string;
+    settingParts: string;
+    settingCountry: string;
+    anywhere: string;
+}
+export declare const ADDRESS_LABELS: Record<Locale, AddressLabels>;
+/** An address field's words for a page's language, the maps' own with them, and the app's own over both. */
+export declare function addressLabels(locale: Locale | undefined, own?: Partial<MapLabels & AddressLabels>): MapLabels & AddressLabels;

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

@@ -0,0 +1,21 @@
+import type { Locale } from '@fieldia/core';
+import { type MapLabels } from './labels';
+/**
+ * The words of an address field that suggests addresses
+ * (`char.address-search`), and of its kind in the designer: in a module of
+ * their own, so a page that shows forms (and no designer) loads them with
+ * the field's suggestions, not before.
+ */
+export interface AddressLabels {
+    /** Said to screen readers as suggestions come: `{n}` how many. */
+    suggested: string;
+    addressKind: string;
+    /** The designer's settings: the field a picked address's place goes into, the field its parts go into, the country it keeps to. */
+    settingPlace: string;
+    settingParts: string;
+    settingCountry: string;
+    anywhere: string;
+}
+export declare const ADDRESS_LABELS: Record<Locale, AddressLabels>;
+/** An address field's words for a page's language, the maps' own with them, and the app's own over both. */
+export declare function addressLabels(locale: Locale | undefined, own?: Partial<MapLabels & AddressLabels>): MapLabels & AddressLabels;

package/src/lib/address-labels.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ADDRESS_LABELS = void 0;
+exports.addressLabels = addressLabels;
+const labels_1 = require("./labels");
+exports.ADDRESS_LABELS = {
+    en: { suggested: 'Suggestions: {n}', addressKind: 'Address search', settingPlace: 'Place goes into', settingParts: 'Parts go into', settingCountry: 'Addresses in', anywhere: 'Any country' },
+    ar: { suggested: 'الاقتراحات: {n}', addressKind: 'بحث عن عنوان', settingPlace: 'يُكتب المكان في', settingParts: 'تُكتب أجزاؤه في', settingCountry: 'العناوين في', anywhere: 'أي بلد' },
+    fr: { suggested: 'Suggestions : {n}', addressKind: 'Recherche d’adresse', settingPlace: 'Le lieu va dans', settingParts: 'Ses parties vont dans', settingCountry: 'Pays des adresses', anywhere: 'Tous les pays' },
+    de: { suggested: 'Vorschläge: {n}', addressKind: 'Adresssuche', settingPlace: 'Ort kommt in', settingParts: 'Teile kommen in', settingCountry: 'Land der Adressen', anywhere: 'Alle Länder' },
+};
+/** An address field's words for a page's language, the maps' own with them, and the app's own over both. */
+function addressLabels(locale, own) {
+    return { ...labels_1.MAP_LABELS[locale ?? 'en'], ...exports.ADDRESS_LABELS[locale ?? 'en'], ...own };
+}
+//# sourceMappingURL=address-labels.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"address-labels.js","sourceRoot":"","sources":["../../../../../libs/map/src/lib/address-labels.ts"],"names":[],"mappings":";;;AA4BA,sCAEC;AA7BD,qCAAsD;AAmBzC,QAAA,cAAc,GAAkC;IAC3D,EAAE,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,QAAQ,EAAE,aAAa,EAAE;IAC7L,EAAE,EAAE,EAAE,SAAS,EAAE,iBAAiB,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE;IACtL,EAAE,EAAE,EAAE,SAAS,EAAE,mBAAmB,EAAE,WAAW,EAAE,qBAAqB,EAAE,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,uBAAuB,EAAE,cAAc,EAAE,mBAAmB,EAAE,QAAQ,EAAE,eAAe,EAAE;IAClN,EAAE,EAAE,EAAE,SAAS,EAAE,iBAAiB,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,mBAAmB,EAAE,QAAQ,EAAE,aAAa,EAAE;CAC9L,CAAC;AAEF,4GAA4G;AAC5G,SAAgB,aAAa,CAAC,MAA0B,EAAE,GAAwC;IAChG,OAAO,EAAE,GAAG,mBAAU,CAAC,MAAM,IAAI,IAAI,CAAC,EAAE,GAAG,sBAAc,CAAC,MAAM,IAAI,IAAI,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC;AACtF,CAAC"}

package/src/lib/address-labels.mjs

@@ -0,0 +1,12 @@
+import { MAP_LABELS } from './labels.mjs';
+export const ADDRESS_LABELS = {
+    en: { suggested: 'Suggestions: {n}', addressKind: 'Address search', settingPlace: 'Place goes into', settingParts: 'Parts go into', settingCountry: 'Addresses in', anywhere: 'Any country' },
+    ar: { suggested: 'الاقتراحات: {n}', addressKind: 'بحث عن عنوان', settingPlace: 'يُكتب المكان في', settingParts: 'تُكتب أجزاؤه في', settingCountry: 'العناوين في', anywhere: 'أي بلد' },
+    fr: { suggested: 'Suggestions : {n}', addressKind: 'Recherche d’adresse', settingPlace: 'Le lieu va dans', settingParts: 'Ses parties vont dans', settingCountry: 'Pays des adresses', anywhere: 'Tous les pays' },
+    de: { suggested: 'Vorschläge: {n}', addressKind: 'Adresssuche', settingPlace: 'Ort kommt in', settingParts: 'Teile kommen in', settingCountry: 'Land der Adressen', anywhere: 'Alle Länder' },
+};
+/** An address field's words for a page's language, the maps' own with them, and the app's own over both. */
+export function addressLabels(locale, own) {
+    return { ...MAP_LABELS[locale ?? 'en'], ...ADDRESS_LABELS[locale ?? 'en'], ...own };
+}
+//# sourceMappingURL=address-labels.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"address-labels.mjs","sourceRoot":"","sources":["../../../../../libs/map/src/lib/address-labels.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAkB,MAAM,UAAU,CAAC;AAmBtD,MAAM,CAAC,MAAM,cAAc,GAAkC;IAC3D,EAAE,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,QAAQ,EAAE,aAAa,EAAE;IAC7L,EAAE,EAAE,EAAE,SAAS,EAAE,iBAAiB,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE;IACtL,EAAE,EAAE,EAAE,SAAS,EAAE,mBAAmB,EAAE,WAAW,EAAE,qBAAqB,EAAE,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,uBAAuB,EAAE,cAAc,EAAE,mBAAmB,EAAE,QAAQ,EAAE,eAAe,EAAE;IAClN,EAAE,EAAE,EAAE,SAAS,EAAE,iBAAiB,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,mBAAmB,EAAE,QAAQ,EAAE,aAAa,EAAE;CAC9L,CAAC;AAEF,4GAA4G;AAC5G,MAAM,UAAU,aAAa,CAAC,MAA0B,EAAE,GAAwC;IAChG,OAAO,EAAE,GAAG,UAAU,CAAC,MAAM,IAAI,IAAI,CAAC,EAAE,GAAG,cAAc,CAAC,MAAM,IAAI,IAAI,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC;AACtF,CAAC"}

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

@@ -0,0 +1,2 @@
+import type { Locale } from '@fieldia/core';
+export declare function addressLine(pieces: unknown[], locale?: Locale): string;

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

@@ -0,0 +1,2 @@
+import type { Locale } from '@fieldia/core';
+export declare function addressLine(pieces: unknown[], locale?: Locale): string;

package/src/lib/address-line.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addressLine = addressLine;
+/**
+ * An address on one line, as a field keeps it and a suggestion's second line
+ * shows it: its pieces in order (a name or a street, then where it is), each
+ * said once, joined as the page's language joins them, "، " in Arabic and
+ * ", " in the others. A piece is cut where a provider put its own commas, and
+ * left out when it repeats one said before it: the same words ("Cairo",
+ * "Cairo"), or a wider place named after it ("Cairo Governorate" after
+ * "Cairo", "محافظة القاهرة" after "القاهرة") unless it carries a number of
+ * its own, a postcode. A narrower piece holding a wider one's name, a street
+ * named after its city, stays: it was said first.
+ */
+const MARKS = /[‎‏؜‪-‮⁦-⁩]/g;
+const words = (piece) => piece.toLowerCase().split(/\s+/);
+/** Whether `few` are in `many`, one after another, as whole words. */
+const within = (few, many) => many.some((_, at) => few.every((word, i) => many[at + i] === word));
+function addressLine(pieces, locale) {
+    const said = [];
+    const kept = [];
+    for (const piece of pieces.flatMap((p) => (typeof p === 'string' ? p.replace(MARKS, '').split(/[,،]/) : []))) {
+        const text = piece.trim();
+        if (!text)
+            continue;
+        const these = words(text);
+        if (said.some((before) => within(before, these) && (before.length === these.length || !/\p{Nd}/u.test(text))))
+            continue;
+        said.push(these);
+        kept.push(text);
+    }
+    return kept.join(locale === 'ar' ? '، ' : ', ');
+}
+//# sourceMappingURL=address-line.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"address-line.js","sourceRoot":"","sources":["../../../../../libs/map/src/lib/address-line.ts"],"names":[],"mappings":";;AAmBA,kCAYC;AA7BD;;;;;;;;;;GAUG;AAEH,MAAM,KAAK,GAAG,cAAc,CAAC;AAC7B,MAAM,KAAK,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAClE,sEAAsE;AACtE,MAAM,MAAM,GAAG,CAAC,GAAa,EAAE,IAAc,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;AAEtH,SAAgB,WAAW,CAAC,MAAiB,EAAE,MAAe;IAC5D,MAAM,IAAI,GAAe,EAAE,CAAC;IAC5B,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QAC7G,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC1B,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1B,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YAAE,SAAS;QACxH,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAClD,CAAC"}

package/src/lib/address-line.mjs

@@ -0,0 +1,31 @@
+/**
+ * An address on one line, as a field keeps it and a suggestion's second line
+ * shows it: its pieces in order (a name or a street, then where it is), each
+ * said once, joined as the page's language joins them, "، " in Arabic and
+ * ", " in the others. A piece is cut where a provider put its own commas, and
+ * left out when it repeats one said before it: the same words ("Cairo",
+ * "Cairo"), or a wider place named after it ("Cairo Governorate" after
+ * "Cairo", "محافظة القاهرة" after "القاهرة") unless it carries a number of
+ * its own, a postcode. A narrower piece holding a wider one's name, a street
+ * named after its city, stays: it was said first.
+ */
+const MARKS = /[‎‏؜‪-‮⁦-⁩]/g;
+const words = (piece) => piece.toLowerCase().split(/\s+/);
+/** Whether `few` are in `many`, one after another, as whole words. */
+const within = (few, many) => many.some((_, at) => few.every((word, i) => many[at + i] === word));
+export function addressLine(pieces, locale) {
+    const said = [];
+    const kept = [];
+    for (const piece of pieces.flatMap((p) => (typeof p === 'string' ? p.replace(MARKS, '').split(/[,،]/) : []))) {
+        const text = piece.trim();
+        if (!text)
+            continue;
+        const these = words(text);
+        if (said.some((before) => within(before, these) && (before.length === these.length || !/\p{Nd}/u.test(text))))
+            continue;
+        said.push(these);
+        kept.push(text);
+    }
+    return kept.join(locale === 'ar' ? '، ' : ', ');
+}
+//# sourceMappingURL=address-line.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"address-line.mjs","sourceRoot":"","sources":["../../../../../libs/map/src/lib/address-line.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAEH,MAAM,KAAK,GAAG,cAAc,CAAC;AAC7B,MAAM,KAAK,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAClE,sEAAsE;AACtE,MAAM,MAAM,GAAG,CAAC,GAAa,EAAE,IAAc,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;AAEtH,MAAM,UAAU,WAAW,CAAC,MAAiB,EAAE,MAAe;IAC5D,MAAM,IAAI,GAAe,EAAE,CAAC;IAC5B,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QAC7G,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC1B,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1B,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YAAE,SAAS;QACxH,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAClD,CAAC"}

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

@@ -0,0 +1,28 @@
+/**
+ * An address in its parts, as Fieldia's address field (`json.address`) keeps
+ * one: the street with its number, the city, the region (a state, a
+ * governorate), the postcode, and the country as its ISO code ("EG"). Each
+ * provider names them its own way; they are read into these here, asked for
+ * only by a search that wants them (`SearchRequest.parts`).
+ */
+export interface AddressParts {
+    street?: string;
+    city?: string;
+    region?: string;
+    postcode?: string;
+    country?: string;
+}
+/** Photon's properties: a street, or a city, may be the place itself. */
+export declare const photonParts: (p: unknown) => AddressParts | undefined;
+/** Nominatim's `address` (with `addressdetails=1`): a town or a village where there is no city. */
+export declare const nominatimParts: (a: unknown) => AddressParts | undefined;
+/** Azure's `address`: its own street line when it has one, its first admin district the region; its country's code is `ISO`, or `iso` in some answers. */
+export declare const azureParts: (a: unknown) => AddressParts | undefined;
+/** Google's `addressComponents`, each by its type: the country by its short code. */
+export declare const googleParts: (components: unknown) => AddressParts | undefined;
+/** Mapbox's `context`: its address's own line (number and street), or the street alone. */
+export declare const mapboxParts: (p: unknown) => AddressParts | undefined;
+/** Only places in the countries asked for, when some are: for a provider that cannot be asked to keep to them. */
+export declare const inCountries: <T extends {
+    parts?: AddressParts;
+}>(places: T[], countries?: string[]) => T[];

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

@@ -0,0 +1,28 @@
+/**
+ * An address in its parts, as Fieldia's address field (`json.address`) keeps
+ * one: the street with its number, the city, the region (a state, a
+ * governorate), the postcode, and the country as its ISO code ("EG"). Each
+ * provider names them its own way; they are read into these here, asked for
+ * only by a search that wants them (`SearchRequest.parts`).
+ */
+export interface AddressParts {
+    street?: string;
+    city?: string;
+    region?: string;
+    postcode?: string;
+    country?: string;
+}
+/** Photon's properties: a street, or a city, may be the place itself. */
+export declare const photonParts: (p: unknown) => AddressParts | undefined;
+/** Nominatim's `address` (with `addressdetails=1`): a town or a village where there is no city. */
+export declare const nominatimParts: (a: unknown) => AddressParts | undefined;
+/** Azure's `address`: its own street line when it has one, its first admin district the region; its country's code is `ISO`, or `iso` in some answers. */
+export declare const azureParts: (a: unknown) => AddressParts | undefined;
+/** Google's `addressComponents`, each by its type: the country by its short code. */
+export declare const googleParts: (components: unknown) => AddressParts | undefined;
+/** Mapbox's `context`: its address's own line (number and street), or the street alone. */
+export declare const mapboxParts: (p: unknown) => AddressParts | undefined;
+/** Only places in the countries asked for, when some are: for a provider that cannot be asked to keep to them. */
+export declare const inCountries: <T extends {
+    parts?: AddressParts;
+}>(places: T[], countries?: string[]) => T[];

package/src/lib/address-parts.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.inCountries = exports.mapboxParts = exports.googleParts = exports.azureParts = exports.nominatimParts = exports.photonParts = void 0;
+const answers_1 = require("./answers");
+/** Words without the direction marks Azure and Google put in Arabic. */
+const text = (value) => (typeof value === 'string' ? value.replace(/[‎‏؜‪-‮⁦-⁩]/g, '').trim() : '');
+/** The parts there are, the street with its number after it (as a place's name has it), the country's code in capitals; nothing when none is. */
+function partsOf(street, number, city, region, postcode, country) {
+    const found = {
+        street: [text(street), text(street) && text(number)].filter(Boolean).join(' '),
+        city: text(city),
+        region: text(region),
+        postcode: text(postcode),
+        country: text(country).toUpperCase(),
+    };
+    const parts = Object.fromEntries(Object.entries(found).filter(([, value]) => value));
+    return Object.keys(parts).length ? parts : undefined;
+}
+/** Photon's properties: a street, or a city, may be the place itself. */
+const photonParts = (p) => {
+    const kind = (0, answers_1.pathOf)(p, 'type');
+    const own = (as) => (kind === as ? (0, answers_1.pathOf)(p, 'name') : undefined);
+    return partsOf((0, answers_1.pathOf)(p, 'street') ?? own('street'), (0, answers_1.pathOf)(p, 'housenumber'), (0, answers_1.pathOf)(p, 'city') ?? own('city'), (0, answers_1.pathOf)(p, 'state'), (0, answers_1.pathOf)(p, 'postcode'), (0, answers_1.pathOf)(p, 'countrycode'));
+};
+exports.photonParts = photonParts;
+/** Nominatim's `address` (with `addressdetails=1`): a town or a village where there is no city. */
+const nominatimParts = (a) => partsOf((0, answers_1.pathOf)(a, 'road'), (0, answers_1.pathOf)(a, 'house_number'), (0, answers_1.pathOf)(a, 'city') ?? (0, answers_1.pathOf)(a, 'town') ?? (0, answers_1.pathOf)(a, 'village'), (0, answers_1.pathOf)(a, 'state'), (0, answers_1.pathOf)(a, 'postcode'), (0, answers_1.pathOf)(a, 'country_code'));
+exports.nominatimParts = nominatimParts;
+/** Azure's `address`: its own street line when it has one, its first admin district the region; its country's code is `ISO`, or `iso` in some answers. */
+const azureParts = (a) => partsOf(text((0, answers_1.pathOf)(a, 'addressLine')) || (0, answers_1.pathOf)(a, 'streetName'), text((0, answers_1.pathOf)(a, 'addressLine')) ? '' : (0, answers_1.pathOf)(a, 'streetNumber'), (0, answers_1.pathOf)(a, 'locality'), (0, answers_1.pathOf)(a, 'adminDistricts')?.map((d) => text((0, answers_1.pathOf)(d, 'name')) || (0, answers_1.pathOf)(d, 'shortName'))[0], (0, answers_1.pathOf)(a, 'postalCode'), (0, answers_1.pathOf)(a, 'countryRegion', 'ISO') ?? (0, answers_1.pathOf)(a, 'countryRegion', 'iso'));
+exports.azureParts = azureParts;
+/** Google's `addressComponents`, each by its type: the country by its short code. */
+const googleParts = (components) => {
+    const of = (type, short) => (0, answers_1.pathOf)((Array.isArray(components) ? components : []).find((c) => (0, answers_1.pathOf)(c, 'types')?.includes(type)), short ? 'shortText' : 'longText');
+    return partsOf(of('route'), of('street_number'), of('locality') ?? of('postal_town'), of('administrative_area_level_1'), of('postal_code'), of('country', true));
+};
+exports.googleParts = googleParts;
+/** Mapbox's `context`: its address's own line (number and street), or the street alone. */
+const mapboxParts = (p) => {
+    const at = (...path) => (0, answers_1.pathOf)(p, 'context', ...path);
+    return partsOf(at('address', 'name') ?? at('street', 'name'), '', at('place', 'name') ?? at('locality', 'name'), at('region', 'name'), at('postcode', 'name'), at('country', 'country_code'));
+};
+exports.mapboxParts = mapboxParts;
+/** Only places in the countries asked for, when some are: for a provider that cannot be asked to keep to them. */
+const inCountries = (places, countries) => countries?.length ? places.filter((place) => countries.includes(place.parts?.country ?? '')) : places;
+exports.inCountries = inCountries;
+//# sourceMappingURL=address-parts.js.map

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

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

package/src/lib/address-parts.mjs

@@ -0,0 +1,38 @@
+import { pathOf } from './answers.mjs';
+/** Words without the direction marks Azure and Google put in Arabic. */
+const text = (value) => (typeof value === 'string' ? value.replace(/[‎‏؜‪-‮⁦-⁩]/g, '').trim() : '');
+/** The parts there are, the street with its number after it (as a place's name has it), the country's code in capitals; nothing when none is. */
+function partsOf(street, number, city, region, postcode, country) {
+    const found = {
+        street: [text(street), text(street) && text(number)].filter(Boolean).join(' '),
+        city: text(city),
+        region: text(region),
+        postcode: text(postcode),
+        country: text(country).toUpperCase(),
+    };
+    const parts = Object.fromEntries(Object.entries(found).filter(([, value]) => value));
+    return Object.keys(parts).length ? parts : undefined;
+}
+/** Photon's properties: a street, or a city, may be the place itself. */
+export const photonParts = (p) => {
+    const kind = pathOf(p, 'type');
+    const own = (as) => (kind === as ? pathOf(p, 'name') : undefined);
+    return partsOf(pathOf(p, 'street') ?? own('street'), pathOf(p, 'housenumber'), pathOf(p, 'city') ?? own('city'), pathOf(p, 'state'), pathOf(p, 'postcode'), pathOf(p, 'countrycode'));
+};
+/** Nominatim's `address` (with `addressdetails=1`): a town or a village where there is no city. */
+export const nominatimParts = (a) => partsOf(pathOf(a, 'road'), pathOf(a, 'house_number'), pathOf(a, 'city') ?? pathOf(a, 'town') ?? pathOf(a, 'village'), pathOf(a, 'state'), pathOf(a, 'postcode'), pathOf(a, 'country_code'));
+/** Azure's `address`: its own street line when it has one, its first admin district the region; its country's code is `ISO`, or `iso` in some answers. */
+export const azureParts = (a) => partsOf(text(pathOf(a, 'addressLine')) || pathOf(a, 'streetName'), text(pathOf(a, 'addressLine')) ? '' : pathOf(a, 'streetNumber'), pathOf(a, 'locality'), pathOf(a, 'adminDistricts')?.map((d) => text(pathOf(d, 'name')) || pathOf(d, 'shortName'))[0], pathOf(a, 'postalCode'), pathOf(a, 'countryRegion', 'ISO') ?? pathOf(a, 'countryRegion', 'iso'));
+/** Google's `addressComponents`, each by its type: the country by its short code. */
+export const googleParts = (components) => {
+    const of = (type, short) => pathOf((Array.isArray(components) ? components : []).find((c) => pathOf(c, 'types')?.includes(type)), short ? 'shortText' : 'longText');
+    return partsOf(of('route'), of('street_number'), of('locality') ?? of('postal_town'), of('administrative_area_level_1'), of('postal_code'), of('country', true));
+};
+/** Mapbox's `context`: its address's own line (number and street), or the street alone. */
+export const mapboxParts = (p) => {
+    const at = (...path) => pathOf(p, 'context', ...path);
+    return partsOf(at('address', 'name') ?? at('street', 'name'), '', at('place', 'name') ?? at('locality', 'name'), at('region', 'name'), at('postcode', 'name'), at('country', 'country_code'));
+};
+/** Only places in the countries asked for, when some are: for a provider that cannot be asked to keep to them. */
+export const inCountries = (places, countries) => countries?.length ? places.filter((place) => countries.includes(place.parts?.country ?? '')) : places;
+//# sourceMappingURL=address-parts.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"address-parts.mjs","sourceRoot":"","sources":["../../../../../libs/map/src/lib/address-parts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAiBnC,wEAAwE;AACxE,MAAM,IAAI,GAAG,CAAC,KAAc,EAAE,EAAE,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAE7G,iJAAiJ;AACjJ,SAAS,OAAO,CAAC,MAAe,EAAE,MAAe,EAAE,IAAa,EAAE,MAAe,EAAE,QAAiB,EAAE,OAAgB;IACpH,MAAM,KAAK,GAA2B;QACpC,MAAM,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QAC9E,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC;QAChB,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;QACpB,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC;QACxB,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE;KACrC,CAAC;IACF,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IACrF,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED,yEAAyE;AACzE,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAU,EAAE,EAAE;IACxC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC/B,MAAM,GAAG,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC1E,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,aAAa,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC;AACxL,CAAC,CAAC;AAEF,mGAAmG;AACnG,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAU,EAAE,EAAE,CAC3C,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC;AAE9L,0JAA0J;AAC1J,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAU,EAAE,EAAE,CACvC,OAAO,CACL,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,EAAE,YAAY,CAAC,EACzD,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,cAAc,CAAC,EAC/D,MAAM,CAAC,CAAC,EAAE,UAAU,CAAC,EACpB,MAAM,CAAC,CAAC,EAAE,gBAAgB,CAA2B,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,EACxH,MAAM,CAAC,CAAC,EAAE,YAAY,CAAC,EACvB,MAAM,CAAC,CAAC,EAAE,eAAe,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,CAAC,EAAE,eAAe,EAAE,KAAK,CAAC,CACvE,CAAC;AAEJ,qFAAqF;AACrF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,UAAmB,EAAE,EAAE;IACjD,MAAM,EAAE,GAAG,CAAC,IAAY,EAAE,KAAe,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAE,MAAM,CAAC,CAAC,EAAE,OAAO,CAA0B,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAChN,OAAO,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,aAAa,CAAC,EAAE,EAAE,CAAC,6BAA6B,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,EAAE,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC;AACnK,CAAC,CAAC;AAEF,2FAA2F;AAC3F,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAU,EAAE,EAAE;IACxC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAc,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,CAAC;IAChE,OAAO,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC;AAChM,CAAC,CAAC;AAEF,kHAAkH;AAClH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAqC,MAAW,EAAE,SAAoB,EAAE,EAAE,CACnG,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC"}

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

@@ -0,0 +1,21 @@
+import { type WidgetFactory } from '@fieldia/widgets';
+import type { MapSettings } from './settings.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 declare function addressSearchWidget(settings: MapSettings): WidgetFactory;

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

@@ -0,0 +1,21 @@
+import { type WidgetFactory } from '@fieldia/widgets';
+import type { MapSettings } from './settings';
+/**
+ * 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 declare function addressSearchWidget(settings: MapSettings): WidgetFactory;