@fieldia/map 0.18.0 → 0.19.1

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
@@ -199,7 +252,7 @@ pin, or the bubble, that holds the place they were on.
 | 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 |
+| `googleMaps({ key, region, logo })` (Map Tiles API) | yes | no | yes | yes, its traffic layer | Places API, as people type | car (with traffic), foot; bike where Google has bicycle routes, none in Egypt, Saudi Arabia, the UAE or Jordan (Routes API) | no: Google's Isochrones API is in preview, and Fieldia does not use it yet |
 | `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 |
@@ -214,11 +267,98 @@ treat an app in use as heavy use. Photon can run on your own server
 (`openStreetMap({ photonUrl })`).
 
 Suggestions come as people type where the provider allows it, nearest where the
-map is looking first, each on two lines (the place, then where it is); Enter
-takes the first. "My location" says how sure it is: a rough location (a
+map is looking first (a map of the whole world, opened with no centre, looks
+nowhere), each on two lines (the place, then where it is); Enter takes the one
+marked with the arrows (Down marks the first, Up the last, each going round at
+the end), or the first of a list made for the words in the box:
+words typed after the list came are searched for at once, and nothing is
+picked from the list before them. "My location" says how sure it is: a rough location (a
 desktop's, placed by its network) shows the circle it may be anywhere in, says
 how wide, and names no address from it.
 
+An address with suggestions (`address-search` on a char field) keeps them to
+the `countries` the page names (ISO codes; "UK" is read as "GB", a code no one
+knows is left out and said in the console). Azure Maps is asked once for each
+country, up to ten (an autocomplete request is a tenth of a Search
+transaction); Google, for fifteen at most; Mapbox and Nominatim, for the list;
+Photon's answers are kept to them. Nearest `near` first (or where the app's
+maps open), so give a point in the page's own country: Azure ranks another
+country's suggestions by their distance from it. Addresses come before shops
+and malls where the provider says which are which (Google, Azure), and an
+address field asks Azure for no postcodes alone, and the word for a district
+typed before its name ("حي الروضة") is left out of the words it is asked, as
+Azure names its districts without it. A suggestion of Azure's is located when
+picked, asked of Azure's geocoding by its own address in its structured form
+(its street, its district for the locality where it names one, then its
+locality, its governorate or province, postcode and country), and only
+there: a district named alike in another town is never taken for it, as no
+hit outside its own admin districts is. A street is placed in its own
+district: the stretch that says it is there, else one in the district's box
+as Azure has it (a road with a name a little beyond it, as it runs on into
+the next); never a street of the name in another district ("Kamel El
+Shenawy" in Garden City, not New Cairo's), and for a street named by its
+number alone ("30 Street", "شارع 6") never another district's of that number.
+Its city is read from them each country's way (in Egypt the governorate's
+city where the governorate is one, Zamalek is Cairo's, and the town
+elsewhere, Mansoura in Dakahlia; in Saudi Arabia the governorate's city; in
+the emirate of Abu Dhabi, the city it is in); a suggestion that names no
+region ("البرشاء 2") takes its city and region from the place found, and one
+that says less of a place listed beside it is left out. A region or a city
+of Egypt, Saudi Arabia, the UAE or Jordan is named one way in each language,
+whichever of its names or codes Azure gives ("Sharjah Emirate", "Ash
+Shāriqah" and "SH" are Sharjah; "Ţanţā" and "طنطا" are Tanta), and once in a
+line ("Giza", never "Giza, Al Jizah"); a district Azure names only in its own
+line is said too ("30 Street, Al Fisht, Sharjah"), and named so where it is
+a road's with no name of its own ("Abu Tina", never Azure's French
+"Charjah"). It is said to be only near (`precise: false`) when Azure is
+unsure of it, or finds only the street for a house, the district for a
+street (its own, before its town), the town for a district; found nowhere in
+its own districts, no place is written (the field says so under the box),
+and its parts still are. A search still waiting when
+a suggestion is picked or the box is left is dropped, and Enter never searches
+for the address a pick wrote. The place and parts a pick wrote stay while the
+words are only edited (a flat added, a word taken out); once the box is left
+emptied, or with the address picked typed over (all of it selected, then typed
+or pasted), they go with it.
+
+Azure's and Google's suggestions, places and parts were checked against their
+live services in October 2026, in English and Arabic, across Egypt, Saudi
+Arabia, the UAE and Jordan. Mapbox's are read as its documentation describes
+them and have not yet been checked against its live service.
+
+Escape drops a search waiting or on its way, as more typing, a pick and
+leaving the box do, and no search is said to be going once it is dropped; a
+list closed takes what was said of it with it. A search waiting is never
+sent; one on its way is not called back, as the provider has it and may bill
+it, but its answer opens nothing. While one address is typed, words asked for
+once (near the same place) show what they brought again, however they come
+back (a letter taken back, Enter after Escape), and words still on their way,
+though dropped, are waited for, not asked again; after a pick they are a new
+address's, asked for anew, and what is still on its way is called back. A
+pick that finds no place, or no parts, takes back the ones the pick before it
+wrote (another address's), never a place set by hand since, as emptying the
+box and leaving it does (with other words typed in their place or none);
+words only edited keep them. One found only near the address (`precise:
+false`) is written, and the field says so under the box; one whose place the
+map did not answer for (a line dropped, the provider down) says that, not
+that it is not on the map. Google writes the UAE's addresses with dashes
+between their pieces ("Sheikh Zayed Rd - Dubai - United Arab Emirates"): they
+are read as its commas elsewhere, each piece said once, a landmark's name too,
+and a suggestion's name not again on the line under it.
+
+Google's costs, as its pricing pages put them (October 2026): a session of
+suggestions ended by a pick bills its first 12 requests (Autocomplete
+Requests) and the place's details (Place Details Essentials: its place, its
+line and its parts, `location,formattedAddress,addressComponents`, are all
+three that SKU's fields, asked for whatever the page keeps, as the parts name
+the country the line is written with; the place's name, `displayName`, would
+make it Pro, and the suggestion gives it); a session
+never picked bills each request. A session's token goes with its first Place
+Details alone: Google bills a token used again as no session. A route by car
+asks for traffic, which makes it Compute Routes Pro; on foot (or by bike) with
+up to 10 stops it is Essentials, 11 to 25 stops Pro, and Google refuses more
+than 25.
+
 Pass your own `search` (and `reverse`) to `mapWidgets` to use your own address
 search with any provider.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fieldia/map",
-  "version": "0.18.0",
+  "version": "0.19.1",
   "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.18.0",
-    "@fieldia/viewer": "0.18.0",
-    "@fieldia/widgets": "0.18.0",
+    "@fieldia/core": "0.19.1",
+    "@fieldia/viewer": "0.19.1",
+    "@fieldia/widgets": "0.19.1",
     "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,33 @@
+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;
+    /**
+     * Shown under the box when the address picked is not found on the map, and
+     * no place is written for it; when it is placed only near it (`precise:
+     * false`); when its place could not be asked for, the map not answering (a
+     * line dropped). Their words come with the suggestions.
+     */
+    notPlaced: string;
+    placedNear: string;
+    locateFailed: 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;
+}
+/** The words said under the box, which come with the suggestions' code (address-suggest.ts). */
+type SaidAfterAPick = 'notPlaced' | 'placedNear' | 'locateFailed';
+export declare const ADDRESS_LABELS: Record<Locale, Omit<AddressLabels, SaidAfterAPick>>;
+/** 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 & Omit<AddressLabels, SaidAfterAPick> & Partial<AddressLabels>;
+export {};

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

@@ -0,0 +1,33 @@
+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;
+    /**
+     * Shown under the box when the address picked is not found on the map, and
+     * no place is written for it; when it is placed only near it (`precise:
+     * false`); when its place could not be asked for, the map not answering (a
+     * line dropped). Their words come with the suggestions.
+     */
+    notPlaced: string;
+    placedNear: string;
+    locateFailed: 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;
+}
+/** The words said under the box, which come with the suggestions' code (address-suggest.ts). */
+type SaidAfterAPick = 'notPlaced' | 'placedNear' | 'locateFailed';
+export declare const ADDRESS_LABELS: Record<Locale, Omit<AddressLabels, SaidAfterAPick>>;
+/** 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 & Omit<AddressLabels, SaidAfterAPick> & Partial<AddressLabels>;
+export {};

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":";;;AAwCA,sCAEC;AAzCD,qCAAsD;AA+BzC,QAAA,cAAc,GAAwD;IACjF,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;AA+BtD,MAAM,CAAC,MAAM,cAAc,GAAwD;IACjF,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,11 @@
+import type { Locale } from '@fieldia/core';
+/** `before`: what is said already, on a line above (a suggestion's name), and not said again. */
+export declare function addressLine(pieces: unknown[], locale?: Locale, before?: unknown[]): string;
+/**
+ * The direction most of a text's letters are written in, for a box or a
+ * line that shows an address in its own words: "rtl" for one mostly in
+ * Arabic, though it starts with a Latin street ("El Tahrir، الإسماعيلية،
+ * مصر"), "ltr" for one mostly in Latin on an Arabic page ("1 Mohammed
+ * Mahmoud"); "" when there are no letters, or as many each way: the page's.
+ */
+export declare function directionOf(text: string): 'ltr' | 'rtl' | '';

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

@@ -0,0 +1,11 @@
+import type { Locale } from '@fieldia/core';
+/** `before`: what is said already, on a line above (a suggestion's name), and not said again. */
+export declare function addressLine(pieces: unknown[], locale?: Locale, before?: unknown[]): string;
+/**
+ * The direction most of a text's letters are written in, for a box or a
+ * line that shows an address in its own words: "rtl" for one mostly in
+ * Arabic, though it starts with a Latin street ("El Tahrir، الإسماعيلية،
+ * مصر"), "ltr" for one mostly in Latin on an Arabic page ("1 Mohammed
+ * Mahmoud"); "" when there are no letters, or as many each way: the page's.
+ */
+export declare function directionOf(text: string): 'ltr' | 'rtl' | '';

package/src/lib/address-line.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addressLine = addressLine;
+exports.directionOf = directionOf;
+/**
+ * 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;
+/** A piece's words as compared: without the tatweel and the vowel marks Arabic may carry ("الشيـخ" is "الشيخ"). */
+const words = (piece) => piece.replace(/\p{Mn}|\u0640/gu, '').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));
+/** Its pieces, cut where the provider put commas, without the marks it put in Arabic. */
+const cut = (pieces) => pieces.flatMap((p) => (typeof p === 'string' ? p.replace(MARKS, '').split(/[,،]/) : [])).map((piece) => piece.trim()).filter(Boolean);
+/** `before`: what is said already, on a line above (a suggestion's name), and not said again. */
+function addressLine(pieces, locale, before = []) {
+    const said = cut(before).map(words);
+    const kept = [];
+    for (const text of cut(pieces)) {
+        const these = words(text);
+        if (said.some((earlier) => within(earlier, these) && (earlier.length === these.length || !/\p{Nd}/u.test(text))))
+            continue;
+        said.push(these);
+        kept.push(text);
+    }
+    return kept.join(locale === 'ar' ? '، ' : ', ');
+}
+/** Letters written right to left: Arabic's and Hebrew's. */
+const RTL = /[\u0590-\u08FF\uFB1D-\uFDFF\uFE70-\uFEFF]/;
+/**
+ * The direction most of a text's letters are written in, for a box or a
+ * line that shows an address in its own words: "rtl" for one mostly in
+ * Arabic, though it starts with a Latin street ("El Tahrir، الإسماعيلية،
+ * مصر"), "ltr" for one mostly in Latin on an Arabic page ("1 Mohammed
+ * Mahmoud"); "" when there are no letters, or as many each way: the page's.
+ */
+function directionOf(text) {
+    const letters = text.match(/\p{L}/gu) ?? [];
+    const rtl = letters.filter((letter) => RTL.test(letter)).length;
+    const ltr = letters.length - rtl;
+    return rtl > ltr ? 'rtl' : ltr > rtl ? 'ltr' : '';
+}
+//# 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":";;AAwBA,kCAUC;AAYD,kCAKC;AAjDD;;;;;;;;;;GAUG;AAEH,MAAM,KAAK,GAAG,cAAc,CAAC;AAC7B,mHAAmH;AACnH,MAAM,KAAK,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACjG,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,yFAAyF;AACzF,MAAM,GAAG,GAAG,CAAC,MAAiB,EAAE,EAAE,CAAC,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,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAEzK,iGAAiG;AACjG,SAAgB,WAAW,CAAC,MAAiB,EAAE,MAAe,EAAE,SAAoB,EAAE;IACpF,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1B,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YAAE,SAAS;QAC3H,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;AAED,4DAA4D;AAC5D,MAAM,GAAG,GAAG,2CAA2C,CAAC;AAExD;;;;;;GAMG;AACH,SAAgB,WAAW,CAAC,IAAY;IACtC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;IAC5C,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IAChE,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC;IACjC,OAAO,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AACpD,CAAC"}

package/src/lib/address-line.mjs

@@ -0,0 +1,47 @@
+/**
+ * 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;
+/** A piece's words as compared: without the tatweel and the vowel marks Arabic may carry ("الشيـخ" is "الشيخ"). */
+const words = (piece) => piece.replace(/\p{Mn}|\u0640/gu, '').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));
+/** Its pieces, cut where the provider put commas, without the marks it put in Arabic. */
+const cut = (pieces) => pieces.flatMap((p) => (typeof p === 'string' ? p.replace(MARKS, '').split(/[,،]/) : [])).map((piece) => piece.trim()).filter(Boolean);
+/** `before`: what is said already, on a line above (a suggestion's name), and not said again. */
+export function addressLine(pieces, locale, before = []) {
+    const said = cut(before).map(words);
+    const kept = [];
+    for (const text of cut(pieces)) {
+        const these = words(text);
+        if (said.some((earlier) => within(earlier, these) && (earlier.length === these.length || !/\p{Nd}/u.test(text))))
+            continue;
+        said.push(these);
+        kept.push(text);
+    }
+    return kept.join(locale === 'ar' ? '، ' : ', ');
+}
+/** Letters written right to left: Arabic's and Hebrew's. */
+const RTL = /[\u0590-\u08FF\uFB1D-\uFDFF\uFE70-\uFEFF]/;
+/**
+ * The direction most of a text's letters are written in, for a box or a
+ * line that shows an address in its own words: "rtl" for one mostly in
+ * Arabic, though it starts with a Latin street ("El Tahrir، الإسماعيلية،
+ * مصر"), "ltr" for one mostly in Latin on an Arabic page ("1 Mohammed
+ * Mahmoud"); "" when there are no letters, or as many each way: the page's.
+ */
+export function directionOf(text) {
+    const letters = text.match(/\p{L}/gu) ?? [];
+    const rtl = letters.filter((letter) => RTL.test(letter)).length;
+    const ltr = letters.length - rtl;
+    return rtl > ltr ? 'rtl' : ltr > rtl ? 'ltr' : '';
+}
+//# 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,mHAAmH;AACnH,MAAM,KAAK,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACjG,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,yFAAyF;AACzF,MAAM,GAAG,GAAG,CAAC,MAAiB,EAAE,EAAE,CAAC,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,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAEzK,iGAAiG;AACjG,MAAM,UAAU,WAAW,CAAC,MAAiB,EAAE,MAAe,EAAE,SAAoB,EAAE;IACpF,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1B,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YAAE,SAAS;QAC3H,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;AAED,4DAA4D;AAC5D,MAAM,GAAG,GAAG,2CAA2C,CAAC;AAExD;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;IAC5C,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IAChE,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC;IACjC,OAAO,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AACpD,CAAC"}

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

@@ -0,0 +1,38 @@
+import type { Locale } from '@fieldia/core';
+/**
+ * What is known of the regions and cities of Egypt, Saudi Arabia, the UAE
+ * and Jordan, for reading Azure's addresses there, where each of its services
+ * names one place its own way: a region by its code ("RIY", "SH") or by a
+ * name ("Sharjah Emirate", "Ash Shāriqah", "منطقة الرياض", "مكة"), a city as
+ * a locality in another script ("Cairo" in an Arabic answer) or another
+ * spelling ("Ad Dammām", "الأسكندرية"). Each place here has one name in each
+ * language, which Fieldia writes, and every other name Azure was seen to give
+ * it (12–13 Oct 2026; each region's capital asked for in English and
+ * Arabic on 13 Oct). Loaded with the providers' address parts.
+ *
+ * A place is one of these only by its code or one of its names, the same
+ * words (without accents, vowel marks or tatweel, in lower case): never by
+ * a name that only sounds like one.
+ */
+/** A place's names: in English, in Arabic, in French and German where they differ from English. */
+export interface Known {
+    names: Partial<Record<Locale, string>> & {
+        en: string;
+        ar: string;
+    };
+    code?: string;
+}
+/**
+ * A name as two of Azure's answers write one place's: its words, without
+ * accents, tatweel, vowel marks or the direction marks Arabic carries, in
+ * lower case ("Ash Shāriqah" is "ash shariqah", "الشيـخ زايد" "الشيخ زايد").
+ */
+export declare const nameKey: (name: unknown) => string;
+/** A region (a governorate, a province, an emirate) of these countries, by Azure's code for it or by one of its names. */
+export declare function knownRegion(country: string, ...names: string[]): Known | undefined;
+/** A city of these countries, by one of its names. */
+export declare function knownCity(country: string, name: string): Known | undefined;
+/** A known place's name in a page's language: its own in French or German where it has one, its English one otherwise. */
+export declare const nameIn: (known: Known, locale: Locale) => string;
+/** Whether two names are one known city's or region's in a country ("Cairo" and "القاهرة"; "Al Jizah" and "Giza"). */
+export declare function sameKnown(country: string, one: string, other: string): boolean;

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

@@ -0,0 +1,38 @@
+import type { Locale } from '@fieldia/core';
+/**
+ * What is known of the regions and cities of Egypt, Saudi Arabia, the UAE
+ * and Jordan, for reading Azure's addresses there, where each of its services
+ * names one place its own way: a region by its code ("RIY", "SH") or by a
+ * name ("Sharjah Emirate", "Ash Shāriqah", "منطقة الرياض", "مكة"), a city as
+ * a locality in another script ("Cairo" in an Arabic answer) or another
+ * spelling ("Ad Dammām", "الأسكندرية"). Each place here has one name in each
+ * language, which Fieldia writes, and every other name Azure was seen to give
+ * it (12–13 Oct 2026; each region's capital asked for in English and
+ * Arabic on 13 Oct). Loaded with the providers' address parts.
+ *
+ * A place is one of these only by its code or one of its names, the same
+ * words (without accents, vowel marks or tatweel, in lower case): never by
+ * a name that only sounds like one.
+ */
+/** A place's names: in English, in Arabic, in French and German where they differ from English. */
+export interface Known {
+    names: Partial<Record<Locale, string>> & {
+        en: string;
+        ar: string;
+    };
+    code?: string;
+}
+/**
+ * A name as two of Azure's answers write one place's: its words, without
+ * accents, tatweel, vowel marks or the direction marks Arabic carries, in
+ * lower case ("Ash Shāriqah" is "ash shariqah", "الشيـخ زايد" "الشيخ زايد").
+ */
+export declare const nameKey: (name: unknown) => string;
+/** A region (a governorate, a province, an emirate) of these countries, by Azure's code for it or by one of its names. */
+export declare function knownRegion(country: string, ...names: string[]): Known | undefined;
+/** A city of these countries, by one of its names. */
+export declare function knownCity(country: string, name: string): Known | undefined;
+/** A known place's name in a page's language: its own in French or German where it has one, its English one otherwise. */
+export declare const nameIn: (known: Known, locale: Locale) => string;
+/** Whether two names are one known city's or region's in a country ("Cairo" and "القاهرة"; "Al Jizah" and "Giza"). */
+export declare function sameKnown(country: string, one: string, other: string): boolean;