@fieldia/map 0.19.0 → 0.20.0

package/README.md

@@ -252,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 |
@@ -267,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.19.0",
+  "version": "0.20.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.19.0",
-    "@fieldia/viewer": "0.19.0",
-    "@fieldia/widgets": "0.19.0",
+    "@fieldia/core": "0.20.0",
+    "@fieldia/viewer": "0.20.0",
+    "@fieldia/widgets": "0.20.0",
     "leaflet": "^1.9.4",
     "tslib": "^2.8.1"
   },

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

@@ -9,6 +9,15 @@ import { type MapLabels } from './labels.mjs';
 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;
@@ -16,6 +25,9 @@ export interface AddressLabels {
     settingCountry: string;
     anywhere: string;
 }
-export declare const ADDRESS_LABELS: Record<Locale, AddressLabels>;
+/** 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 & AddressLabels;
+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

@@ -9,6 +9,15 @@ import { type MapLabels } from './labels';
 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;
@@ -16,6 +25,9 @@ export interface AddressLabels {
     settingCountry: string;
     anywhere: string;
 }
-export declare const ADDRESS_LABELS: Record<Locale, AddressLabels>;
+/** 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 & AddressLabels;
+export declare function addressLabels(locale: Locale | undefined, own?: Partial<MapLabels & AddressLabels>): MapLabels & Omit<AddressLabels, SaidAfterAPick> & Partial<AddressLabels>;
+export {};

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

@@ -1 +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"}
+{"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.map

@@ -1 +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"}
+{"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

@@ -1,2 +1,11 @@
 import type { Locale } from '@fieldia/core';
-export declare function addressLine(pieces: unknown[], locale?: Locale): string;
+/** `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

@@ -1,2 +1,11 @@
 import type { Locale } from '@fieldia/core';
-export declare function addressLine(pieces: unknown[], locale?: Locale): string;
+/** `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

@@ -1,6 +1,7 @@
 "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
@@ -13,22 +14,38 @@ exports.addressLine = addressLine;
  * named after its city, stays: it was said first.
  */
 const MARKS = /[‎‏؜‪-‮⁦-⁩]/g;
-const words = (piece) => piece.toLowerCase().split(/\s+/);
+/** 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));
-function addressLine(pieces, locale) {
-    const said = [];
+/** 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 piece of pieces.flatMap((p) => (typeof p === 'string' ? p.replace(MARKS, '').split(/[,،]/) : []))) {
-        const text = piece.trim();
-        if (!text)
-            continue;
+    for (const text of cut(pieces)) {
         const these = words(text);
-        if (said.some((before) => within(before, these) && (before.length === these.length || !/\p{Nd}/u.test(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

@@ -1 +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"}
+{"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

@@ -10,22 +10,38 @@
  * named after its city, stays: it was said first.
  */
 const MARKS = /[‎‏؜‪-‮⁦-⁩]/g;
-const words = (piece) => piece.toLowerCase().split(/\s+/);
+/** 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));
-export function addressLine(pieces, locale) {
-    const said = [];
+/** 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 piece of pieces.flatMap((p) => (typeof p === 'string' ? p.replace(MARKS, '').split(/[,،]/) : []))) {
-        const text = piece.trim();
-        if (!text)
-            continue;
+    for (const text of cut(pieces)) {
         const these = words(text);
-        if (said.some((before) => within(before, these) && (before.length === these.length || !/\p{Nd}/u.test(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

@@ -1 +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"}
+{"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;