@fieldia/map 0.19.0 → 0.19.1

package/src/lib/address-names.js

@@ -0,0 +1,240 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nameIn = exports.nameKey = void 0;
+exports.knownRegion = knownRegion;
+exports.knownCity = knownCity;
+exports.sameKnown = sameKnown;
+/**
+ * One place a line: its code (Azure's, where it gives one), its English
+ * and Arabic names, then its other names, comma-separated; `fr=`/`de=` give
+ * its French or German name.
+ */
+const REGIONS = {
+    EG: `
+|Cairo|القاهرة|Al Qahirah, Al Qāhirah, al-Qahirah, Cairo Governorate, محافظة القاهرة, fr=Le Caire, de=Kairo
+|Giza|الجيزة|Al Jizah, Al Jīzah, al-Jeezah, Giza Governorate, محافظة الجيزة, fr=Gizeh, de=Gizeh, Gise
+|Alexandria|الإسكندرية|Al Iskandariyah, Alexandria Governorate, الاسكندرية, الأسكندرية, محافظة الإسكندرية, fr=Alexandrie
+|Qalyubia|القليوبية|Al Qalyubiyah, Qalyubiyah, Kalyubia
+|Beheira|البحيرة|Al Buhayrah, Buhayrah
+|Ismailia|الإسماعيلية|Al Isma'iliyah, Al Ismailiyah, الاسماعيلية
+|Sharqia|الشرقية|Ash Sharqiyah, Ash Sharqīyah, Sharkia, Al Sharqia
+|Dakahlia|الدقهلية|Ad Daqahliyah, Daqahliyah
+|Gharbia|الغربية|Al Gharbiyah
+|Monufia|المنوفية|Al Minufiyah, Menofia
+|Kafr El Sheikh|كفر الشيخ|Kafr ash Shaykh
+|Damietta|دمياط|Dumyat, Dumyāţ, Domiat
+|Port Said|بورسعيد|Bur Sa'id, Būr Sa‘īd, Bour Sa'eed, بور سعيد
+|Suez|السويس|As Suways
+|Faiyum|الفيوم|Al Fayyum, Fayoum
+|Beni Suef|بني سويف|Bani Suwayf
+|Minya|المنيا|Al Minya
+|Asyut|أسيوط|Assiut, اسيوط
+|Sohag|سوهاج|Suhaj
+|Qena|قنا|Qina
+|Luxor|الأقصر|Al Uqsur, الاقصر
+|Aswan|أسوان|اسوان
+|Red Sea|البحر الأحمر|Al Bahr al Ahmar
+|New Valley|الوادي الجديد|Al Wadi al Jadid
+|Matrouh|مطروح|Matruh
+|North Sinai|شمال سيناء|Shamal Sina'
+|South Sinai|جنوب سيناء|Janub Sina'`,
+    SA: `
+RIY|Riyadh|الرياض|Ar Riyad, Ar Riyāḑ, Riyadh Region, Riyadh Province, منطقة الرياض, fr=Riyad, de=Riad
+MAK|Makkah|مكة المكرمة|Mecca, Makkah Region, Makkah Province, Makkah Al Mukarramah, مكة, منطقة مكة المكرمة, fr=La Mecque, de=Mekka
+MAD|Madinah|المدينة المنورة|Medina, Al Madinah, Al Madinah Al Munawwarah, المدينة, منطقة المدينة المنورة, fr=Médine, de=Medina
+EAS|Eastern Province|المنطقة الشرقية|Eastern, Eastern Region, Ash Sharqiyah, الشرقية
+QAS|Al Qassim|القصيم|Al Qasim, Qassim, منطقة القصيم
+ASI|Asir|عسير|'Asir, ‘Asir, منطقة عسير
+TAB|Tabuk|تبوك|منطقة تبوك
+HAI|Hail|حائل|Ha'il, Ḩā'il, منطقة حائل
+JAZ|Jazan|جازان|Jizan, Gizan, جيزان, منطقة جازان
+|Najran|نجران|منطقة نجران
+|Al Bahah|الباحة|Al Baha, منطقة الباحة
+JOF|Al Jawf|الجوف|منطقة الجوف
+|Northern Borders|الحدود الشمالية|Northern Frontier, Al Hudud ash Shamaliyah, منطقة الحدود الشمالية`,
+    AE: `
+AZ|Abu Dhabi|أبوظبي|Abu Dhabi Emirate, Abu Zabi, أبو ظبي, إمارة أبوظبي, إمارة أبو ظبي, fr=Abou Dabi
+DU|Dubai|دبي|Dubai Emirate, إمارة دبي, fr=Dubaï
+SH|Sharjah|الشارقة|Sharjah Emirate, Ash Shariqah, Ash Shāriqah, إمارة الشارقة, fr=Charjah, de=Schardscha
+AJ|Ajman|عجمان|Ajman Emirate, 'Ajman, إمارة عجمان
+UQ|Umm Al Quwain|أم القيوين|Umm al Qaywayn, Umm Al-Quwain, Umm Al Quwain Emirate, Umm al-Quwain Emirate, ام القيوين
+RK|Ras Al Khaimah|رأس الخيمة|Ra's al Khaymah, Ras al-Khaimah, Ras Al Khaimah Emirate, Ras al-Khaimah Emirate, راس الخيمة
+FU|Fujairah|الفجيرة|Al Fujayrah, Fujairah Emirate`,
+    JO: `
+|Amman|عمان|Amman Governorate, Capital Governorate, Al Asimah, عمّان, محافظة العاصمة, العاصمة
+|Irbid|إربد|اربد
+|Zarqa|الزرقاء|Az Zarqa
+|Balqa|البلقاء|Al Balqa
+|Madaba|مادبا
+|Karak|الكرك|Al Karak
+|Tafilah|الطفيلة|At Tafilah
+|Ma'an|معان|Maan
+|Aqaba|العقبة|Al Aqabah
+|Mafraq|المفرق|Al Mafraq
+|Jerash|جرش|Jarash, محافظة جرش
+|Ajloun|عجلون|Ajlun`,
+};
+const CITIES = {
+    EG: `
+|Cairo|القاهرة|Al Qahirah, Al Qāhirah, fr=Le Caire, de=Kairo
+|Giza|الجيزة|Al Jizah, Al Jīzah, fr=Gizeh, de=Gizeh
+|Alexandria|الإسكندرية|Al Iskandariyah, الاسكندرية, الأسكندرية, fr=Alexandrie
+|New Cairo|القاهرة الجديدة|New Cairo City, Al Qahirah al Jadidah, مدينة القاهرة الجديدة
+|6th of October|6 أكتوبر|6 October, 6th October, 6th of October City, Sixth of October, أكتوبر 6, السادس من أكتوبر, مدينة 6 أكتوبر, مدينة السادس من أكتوبر
+|Sheikh Zayed|الشيخ زايد|El Sheikh Zaid, El Sheikh Zayed, Sheikh Zayed City, Sheikh Zaid, مدينة الشيخ زايد
+|Helwan|حلوان
+|Shubra El Kheima|شبرا الخيمة|Shubra al Khaymah, Shubrā al Khaymah
+|Port Said|بورسعيد|Bur Sa'id, بور سعيد
+|Suez|السويس|As Suways
+|Ismailia|الإسماعيلية|El Ismailia, Al Isma'iliyah, الاسماعيلية
+|Mansoura|المنصورة|El Mansoura, Al Mansurah
+|Tanta|طنطا
+|Zagazig|الزقازيق|El Zaqaziq, Az Zaqaziq
+|Damietta|دمياط|Dumyat
+|Banha|بنها|Benha
+|Damanhur|دمنهور|Damanhour
+|Shibin El Kom|شبين الكوم|Shibin al Kawm, Shebin El Kom
+|Kafr El Sheikh|كفر الشيخ|Kafr ash Shaykh
+|Faiyum|الفيوم|El Faiyum, Al Fayyum, Fayoum
+|Beni Suef|بني سويف|Bani Suwayf
+|Minya|المنيا|El Minya, El Menia, Al Minya
+|Asyut|أسيوط|Assiut, اسيوط
+|Sohag|سوهاج|Sawhaj, Suhaj
+|Qena|قنا|Qina
+|Luxor|الأقصر|Al Uqsur, الاقصر
+|Aswan|أسوان|اسوان
+|Hurghada|الغردقة|Al Ghardaqah
+|Kharga|الخارجة|El Kharga, Al Kharijah
+|Marsa Matruh|مرسى مطروح|Marsa Matrouh
+|Arish|العريش|El Arish, Al Arish
+|El Tor|الطور|At Tur, مدينة الطور, مدينه الطور
+|Sharm El Sheikh|شرم الشيخ|Sharm ash Shaykh`,
+    SA: `
+|Riyadh|الرياض|Ar Riyad, fr=Riyad, de=Riad
+|Jeddah|جدة|Jiddah, Jedda, جده, fr=Djeddah, de=Dschidda
+|Makkah|مكة المكرمة|Mecca, Makkah Al Mukarramah, مكة, fr=La Mecque, de=Mekka
+|Madinah|المدينة المنورة|Medina, Al Madinah, Al Madinah Al Munawwarah, المدينة, fr=Médine
+|Dammam|الدمام|Ad Dammam, Ad Dammām
+|Al Khobar|الخبر|Al Khubar, Khobar
+|Dhahran|الظهران|Az Zahran
+|Taif|الطائف|At Taif, At Ta’if, Ta'if
+|Abha|أبها
+|Khamis Mushait|خميس مشيط
+|Tabuk|تبوك
+|Buraydah|بريدة|Al Buraydah, Buraidah
+|Hail|حائل|Ha'il
+|Al Kharj|الخرج
+|Al Hofuf|الهفوف|Al Hufuf, Hofuf
+|Jubail|الجبيل|Al Jubayl, Al Jubail
+|Yanbu|ينبع
+|Najran|نجران
+|Jazan|جازان|Jizan, جيزان
+|Al Bahah|الباحة|Al Baha
+|Sakaka|سكاكا|Sakakah
+|Arar|عرعر|Arar & Wardat Nuaman, عرعر ورده نعمان`,
+    AE: `
+|Dubai|دبي|fr=Dubaï
+|Abu Dhabi|أبوظبي|أبو ظبي, Abu Zabi, fr=Abou Dabi
+|Sharjah|الشارقة|Sharjah City, مدينة الشارقة, Ash Shariqah, fr=Charjah, de=Schardscha
+|Al Ain|العين|Al Ayn
+|Ajman|عجمان|'Ajman
+|Ras Al Khaimah|رأس الخيمة|Ra's al Khaymah, راس الخيمة
+|Fujairah|الفجيرة|Al Fujayrah
+|Umm Al Quwain|أم القيوين|Umm al Qaywayn, ام القيوين
+|Khor Fakkan|خورفكان|Khawr Fakkan, خور فكان
+|Kalba|كلباء`,
+    JO: `
+|Amman|عمان|عمّان
+|Zarqa|الزرقاء|Az Zarqa, Zerka
+|Irbid|إربد|اربد
+|Aqaba|العقبة|Al Aqabah
+|Salt|السلط|As Salt, Al Salt
+|Tafilah|الطفيلة|At Tafila, At Tafilah
+|Ma'an|معان|Maan
+|Ajloun|عجلون|Ajlun
+|Madaba|مادبا
+|Jerash|جرش
+|Mafraq|المفرق|Al Mafraq
+|Karak|الكرك|Al Karak`,
+};
+/**
+ * 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", "الشيـخ زايد" "الشيخ زايد").
+ */
+const nameKey = (name) => (typeof name === 'string' ? name : '')
+    .replace(/[‎‏؜‪-‮⁦-⁩]/g, '')
+    .normalize('NFD')
+    .replace(/[\p{M}ـ]/gu, '')
+    .toLowerCase()
+    .replace(/\s+/g, ' ')
+    .trim();
+exports.nameKey = nameKey;
+const tables = new Map();
+function table(of, country) {
+    const id = `${of === REGIONS ? 'r' : 'c'}${country}`;
+    if (!tables.has(id) && of[country]) {
+        const places = [];
+        const byName = new Map();
+        const byCode = new Map();
+        for (const line of of[country].trim().split('\n')) {
+            const [code, en, ar, others = ''] = line.split('|');
+            const names = { en, ar };
+            const all = [en, ar];
+            for (const other of others.split(',').map((one) => one.trim()).filter(Boolean)) {
+                const [, locale, name] = other.match(/^(fr|de)=(.*)$/) ?? [];
+                if (locale)
+                    names[locale] = name;
+                all.push(name ?? other);
+            }
+            const known = { names, ...(code ? { code } : {}) };
+            places.push(known);
+            if (code)
+                byCode.set(code, known);
+            for (const name of all) {
+                const of = byName.get((0, exports.nameKey)(name)) ?? [];
+                if (!of.includes(known))
+                    byName.set((0, exports.nameKey)(name), [...of, known]);
+            }
+        }
+        tables.set(id, { places, byName, byCode });
+    }
+    return tables.get(id);
+}
+/** A region (a governorate, a province, an emirate) of these countries, by Azure's code for it or by one of its names. */
+function knownRegion(country, ...names) {
+    const regions = table(REGIONS, country);
+    if (!regions)
+        return undefined;
+    for (const name of names)
+        if (/^[A-Z]{2,3}$/.test(name) && regions.byCode.has(name))
+            return regions.byCode.get(name);
+    for (const name of names) {
+        const found = regions.byName.get((0, exports.nameKey)(name));
+        if (found?.length === 1)
+            return found[0];
+    }
+    return undefined;
+}
+/** A city of these countries, by one of its names. */
+function knownCity(country, name) {
+    const found = table(CITIES, country)?.byName.get((0, exports.nameKey)(name));
+    return found?.length === 1 ? found[0] : 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. */
+const nameIn = (known, locale) => known.names[locale] ?? known.names.en;
+exports.nameIn = nameIn;
+/** Whether two names are one known city's or region's in a country ("Cairo" and "القاهرة"; "Al Jizah" and "Giza"). */
+function sameKnown(country, one, other) {
+    const [a, b] = [(0, exports.nameKey)(one), (0, exports.nameKey)(other)];
+    if (!a || !b)
+        return false;
+    if (a === b)
+        return true;
+    return [REGIONS, CITIES].some((of) => {
+        const byName = table(of, country)?.byName;
+        const mine = byName?.get(a) ?? [];
+        return mine.length > 0 && (byName?.get(b) ?? []).some((known) => mine.includes(known));
+    });
+}
+//# sourceMappingURL=address-names.js.map

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

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

package/src/lib/address-names.mjs

@@ -0,0 +1,232 @@
+/**
+ * One place a line: its code (Azure's, where it gives one), its English
+ * and Arabic names, then its other names, comma-separated; `fr=`/`de=` give
+ * its French or German name.
+ */
+const REGIONS = {
+    EG: `
+|Cairo|القاهرة|Al Qahirah, Al Qāhirah, al-Qahirah, Cairo Governorate, محافظة القاهرة, fr=Le Caire, de=Kairo
+|Giza|الجيزة|Al Jizah, Al Jīzah, al-Jeezah, Giza Governorate, محافظة الجيزة, fr=Gizeh, de=Gizeh, Gise
+|Alexandria|الإسكندرية|Al Iskandariyah, Alexandria Governorate, الاسكندرية, الأسكندرية, محافظة الإسكندرية, fr=Alexandrie
+|Qalyubia|القليوبية|Al Qalyubiyah, Qalyubiyah, Kalyubia
+|Beheira|البحيرة|Al Buhayrah, Buhayrah
+|Ismailia|الإسماعيلية|Al Isma'iliyah, Al Ismailiyah, الاسماعيلية
+|Sharqia|الشرقية|Ash Sharqiyah, Ash Sharqīyah, Sharkia, Al Sharqia
+|Dakahlia|الدقهلية|Ad Daqahliyah, Daqahliyah
+|Gharbia|الغربية|Al Gharbiyah
+|Monufia|المنوفية|Al Minufiyah, Menofia
+|Kafr El Sheikh|كفر الشيخ|Kafr ash Shaykh
+|Damietta|دمياط|Dumyat, Dumyāţ, Domiat
+|Port Said|بورسعيد|Bur Sa'id, Būr Sa‘īd, Bour Sa'eed, بور سعيد
+|Suez|السويس|As Suways
+|Faiyum|الفيوم|Al Fayyum, Fayoum
+|Beni Suef|بني سويف|Bani Suwayf
+|Minya|المنيا|Al Minya
+|Asyut|أسيوط|Assiut, اسيوط
+|Sohag|سوهاج|Suhaj
+|Qena|قنا|Qina
+|Luxor|الأقصر|Al Uqsur, الاقصر
+|Aswan|أسوان|اسوان
+|Red Sea|البحر الأحمر|Al Bahr al Ahmar
+|New Valley|الوادي الجديد|Al Wadi al Jadid
+|Matrouh|مطروح|Matruh
+|North Sinai|شمال سيناء|Shamal Sina'
+|South Sinai|جنوب سيناء|Janub Sina'`,
+    SA: `
+RIY|Riyadh|الرياض|Ar Riyad, Ar Riyāḑ, Riyadh Region, Riyadh Province, منطقة الرياض, fr=Riyad, de=Riad
+MAK|Makkah|مكة المكرمة|Mecca, Makkah Region, Makkah Province, Makkah Al Mukarramah, مكة, منطقة مكة المكرمة, fr=La Mecque, de=Mekka
+MAD|Madinah|المدينة المنورة|Medina, Al Madinah, Al Madinah Al Munawwarah, المدينة, منطقة المدينة المنورة, fr=Médine, de=Medina
+EAS|Eastern Province|المنطقة الشرقية|Eastern, Eastern Region, Ash Sharqiyah, الشرقية
+QAS|Al Qassim|القصيم|Al Qasim, Qassim, منطقة القصيم
+ASI|Asir|عسير|'Asir, ‘Asir, منطقة عسير
+TAB|Tabuk|تبوك|منطقة تبوك
+HAI|Hail|حائل|Ha'il, Ḩā'il, منطقة حائل
+JAZ|Jazan|جازان|Jizan, Gizan, جيزان, منطقة جازان
+|Najran|نجران|منطقة نجران
+|Al Bahah|الباحة|Al Baha, منطقة الباحة
+JOF|Al Jawf|الجوف|منطقة الجوف
+|Northern Borders|الحدود الشمالية|Northern Frontier, Al Hudud ash Shamaliyah, منطقة الحدود الشمالية`,
+    AE: `
+AZ|Abu Dhabi|أبوظبي|Abu Dhabi Emirate, Abu Zabi, أبو ظبي, إمارة أبوظبي, إمارة أبو ظبي, fr=Abou Dabi
+DU|Dubai|دبي|Dubai Emirate, إمارة دبي, fr=Dubaï
+SH|Sharjah|الشارقة|Sharjah Emirate, Ash Shariqah, Ash Shāriqah, إمارة الشارقة, fr=Charjah, de=Schardscha
+AJ|Ajman|عجمان|Ajman Emirate, 'Ajman, إمارة عجمان
+UQ|Umm Al Quwain|أم القيوين|Umm al Qaywayn, Umm Al-Quwain, Umm Al Quwain Emirate, Umm al-Quwain Emirate, ام القيوين
+RK|Ras Al Khaimah|رأس الخيمة|Ra's al Khaymah, Ras al-Khaimah, Ras Al Khaimah Emirate, Ras al-Khaimah Emirate, راس الخيمة
+FU|Fujairah|الفجيرة|Al Fujayrah, Fujairah Emirate`,
+    JO: `
+|Amman|عمان|Amman Governorate, Capital Governorate, Al Asimah, عمّان, محافظة العاصمة, العاصمة
+|Irbid|إربد|اربد
+|Zarqa|الزرقاء|Az Zarqa
+|Balqa|البلقاء|Al Balqa
+|Madaba|مادبا
+|Karak|الكرك|Al Karak
+|Tafilah|الطفيلة|At Tafilah
+|Ma'an|معان|Maan
+|Aqaba|العقبة|Al Aqabah
+|Mafraq|المفرق|Al Mafraq
+|Jerash|جرش|Jarash, محافظة جرش
+|Ajloun|عجلون|Ajlun`,
+};
+const CITIES = {
+    EG: `
+|Cairo|القاهرة|Al Qahirah, Al Qāhirah, fr=Le Caire, de=Kairo
+|Giza|الجيزة|Al Jizah, Al Jīzah, fr=Gizeh, de=Gizeh
+|Alexandria|الإسكندرية|Al Iskandariyah, الاسكندرية, الأسكندرية, fr=Alexandrie
+|New Cairo|القاهرة الجديدة|New Cairo City, Al Qahirah al Jadidah, مدينة القاهرة الجديدة
+|6th of October|6 أكتوبر|6 October, 6th October, 6th of October City, Sixth of October, أكتوبر 6, السادس من أكتوبر, مدينة 6 أكتوبر, مدينة السادس من أكتوبر
+|Sheikh Zayed|الشيخ زايد|El Sheikh Zaid, El Sheikh Zayed, Sheikh Zayed City, Sheikh Zaid, مدينة الشيخ زايد
+|Helwan|حلوان
+|Shubra El Kheima|شبرا الخيمة|Shubra al Khaymah, Shubrā al Khaymah
+|Port Said|بورسعيد|Bur Sa'id, بور سعيد
+|Suez|السويس|As Suways
+|Ismailia|الإسماعيلية|El Ismailia, Al Isma'iliyah, الاسماعيلية
+|Mansoura|المنصورة|El Mansoura, Al Mansurah
+|Tanta|طنطا
+|Zagazig|الزقازيق|El Zaqaziq, Az Zaqaziq
+|Damietta|دمياط|Dumyat
+|Banha|بنها|Benha
+|Damanhur|دمنهور|Damanhour
+|Shibin El Kom|شبين الكوم|Shibin al Kawm, Shebin El Kom
+|Kafr El Sheikh|كفر الشيخ|Kafr ash Shaykh
+|Faiyum|الفيوم|El Faiyum, Al Fayyum, Fayoum
+|Beni Suef|بني سويف|Bani Suwayf
+|Minya|المنيا|El Minya, El Menia, Al Minya
+|Asyut|أسيوط|Assiut, اسيوط
+|Sohag|سوهاج|Sawhaj, Suhaj
+|Qena|قنا|Qina
+|Luxor|الأقصر|Al Uqsur, الاقصر
+|Aswan|أسوان|اسوان
+|Hurghada|الغردقة|Al Ghardaqah
+|Kharga|الخارجة|El Kharga, Al Kharijah
+|Marsa Matruh|مرسى مطروح|Marsa Matrouh
+|Arish|العريش|El Arish, Al Arish
+|El Tor|الطور|At Tur, مدينة الطور, مدينه الطور
+|Sharm El Sheikh|شرم الشيخ|Sharm ash Shaykh`,
+    SA: `
+|Riyadh|الرياض|Ar Riyad, fr=Riyad, de=Riad
+|Jeddah|جدة|Jiddah, Jedda, جده, fr=Djeddah, de=Dschidda
+|Makkah|مكة المكرمة|Mecca, Makkah Al Mukarramah, مكة, fr=La Mecque, de=Mekka
+|Madinah|المدينة المنورة|Medina, Al Madinah, Al Madinah Al Munawwarah, المدينة, fr=Médine
+|Dammam|الدمام|Ad Dammam, Ad Dammām
+|Al Khobar|الخبر|Al Khubar, Khobar
+|Dhahran|الظهران|Az Zahran
+|Taif|الطائف|At Taif, At Ta’if, Ta'if
+|Abha|أبها
+|Khamis Mushait|خميس مشيط
+|Tabuk|تبوك
+|Buraydah|بريدة|Al Buraydah, Buraidah
+|Hail|حائل|Ha'il
+|Al Kharj|الخرج
+|Al Hofuf|الهفوف|Al Hufuf, Hofuf
+|Jubail|الجبيل|Al Jubayl, Al Jubail
+|Yanbu|ينبع
+|Najran|نجران
+|Jazan|جازان|Jizan, جيزان
+|Al Bahah|الباحة|Al Baha
+|Sakaka|سكاكا|Sakakah
+|Arar|عرعر|Arar & Wardat Nuaman, عرعر ورده نعمان`,
+    AE: `
+|Dubai|دبي|fr=Dubaï
+|Abu Dhabi|أبوظبي|أبو ظبي, Abu Zabi, fr=Abou Dabi
+|Sharjah|الشارقة|Sharjah City, مدينة الشارقة, Ash Shariqah, fr=Charjah, de=Schardscha
+|Al Ain|العين|Al Ayn
+|Ajman|عجمان|'Ajman
+|Ras Al Khaimah|رأس الخيمة|Ra's al Khaymah, راس الخيمة
+|Fujairah|الفجيرة|Al Fujayrah
+|Umm Al Quwain|أم القيوين|Umm al Qaywayn, ام القيوين
+|Khor Fakkan|خورفكان|Khawr Fakkan, خور فكان
+|Kalba|كلباء`,
+    JO: `
+|Amman|عمان|عمّان
+|Zarqa|الزرقاء|Az Zarqa, Zerka
+|Irbid|إربد|اربد
+|Aqaba|العقبة|Al Aqabah
+|Salt|السلط|As Salt, Al Salt
+|Tafilah|الطفيلة|At Tafila, At Tafilah
+|Ma'an|معان|Maan
+|Ajloun|عجلون|Ajlun
+|Madaba|مادبا
+|Jerash|جرش
+|Mafraq|المفرق|Al Mafraq
+|Karak|الكرك|Al Karak`,
+};
+/**
+ * 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 const nameKey = (name) => (typeof name === 'string' ? name : '')
+    .replace(/[‎‏؜‪-‮⁦-⁩]/g, '')
+    .normalize('NFD')
+    .replace(/[\p{M}ـ]/gu, '')
+    .toLowerCase()
+    .replace(/\s+/g, ' ')
+    .trim();
+const tables = new Map();
+function table(of, country) {
+    const id = `${of === REGIONS ? 'r' : 'c'}${country}`;
+    if (!tables.has(id) && of[country]) {
+        const places = [];
+        const byName = new Map();
+        const byCode = new Map();
+        for (const line of of[country].trim().split('\n')) {
+            const [code, en, ar, others = ''] = line.split('|');
+            const names = { en, ar };
+            const all = [en, ar];
+            for (const other of others.split(',').map((one) => one.trim()).filter(Boolean)) {
+                const [, locale, name] = other.match(/^(fr|de)=(.*)$/) ?? [];
+                if (locale)
+                    names[locale] = name;
+                all.push(name ?? other);
+            }
+            const known = { names, ...(code ? { code } : {}) };
+            places.push(known);
+            if (code)
+                byCode.set(code, known);
+            for (const name of all) {
+                const of = byName.get(nameKey(name)) ?? [];
+                if (!of.includes(known))
+                    byName.set(nameKey(name), [...of, known]);
+            }
+        }
+        tables.set(id, { places, byName, byCode });
+    }
+    return tables.get(id);
+}
+/** A region (a governorate, a province, an emirate) of these countries, by Azure's code for it or by one of its names. */
+export function knownRegion(country, ...names) {
+    const regions = table(REGIONS, country);
+    if (!regions)
+        return undefined;
+    for (const name of names)
+        if (/^[A-Z]{2,3}$/.test(name) && regions.byCode.has(name))
+            return regions.byCode.get(name);
+    for (const name of names) {
+        const found = regions.byName.get(nameKey(name));
+        if (found?.length === 1)
+            return found[0];
+    }
+    return undefined;
+}
+/** A city of these countries, by one of its names. */
+export function knownCity(country, name) {
+    const found = table(CITIES, country)?.byName.get(nameKey(name));
+    return found?.length === 1 ? found[0] : 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 const nameIn = (known, locale) => known.names[locale] ?? known.names.en;
+/** Whether two names are one known city's or region's in a country ("Cairo" and "القاهرة"; "Al Jizah" and "Giza"). */
+export function sameKnown(country, one, other) {
+    const [a, b] = [nameKey(one), nameKey(other)];
+    if (!a || !b)
+        return false;
+    if (a === b)
+        return true;
+    return [REGIONS, CITIES].some((of) => {
+        const byName = table(of, country)?.byName;
+        const mine = byName?.get(a) ?? [];
+        return mine.length > 0 && (byName?.get(b) ?? []).some((known) => mine.includes(known));
+    });
+}
+//# sourceMappingURL=address-names.mjs.map

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

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

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

@@ -1,9 +1,16 @@
+import type { Locale } from '@fieldia/core';
+import type { PlaceFound, SearchRequest } from './providers.mjs';
 /**
- * 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`).
+ * How each provider's addresses read, loaded with the first search that
+ * needs it (an address field's; any of Azure's or Google's), never with a
+ * page: 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 or a governorate, the postcode, and the country as its ISO
+ * code, "EG"); Azure's and Google's places on two lines, in the page's
+ * language; and where a suggestion picked is, for those whose suggestions
+ * carry no place. Each provider names the parts its own way: what each
+ * answered in Egypt, Saudi Arabia, the UAE and Jordan on 12 Oct 2026 is
+ * read here.
  */
 export interface AddressParts {
     street?: string;
@@ -16,13 +23,124 @@ export interface AddressParts {
 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. */
+/** Mapbox's `context`: its address's own line (number and street, in its country's order), 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[];
+/**
+ * The countries a provider can be asked to keep to: ISO codes, each once,
+ * "UK" read as "GB" (as every provider's parts name it). A code no one
+ * knows ("XX", "EGY") is left out and said once: Azure and Google refuse a
+ * whole search for one.
+ */
+export declare function knownCountries(countries: string[] | undefined): string[];
+/** The countries Google is asked to keep to (`includedRegionCodes`): 15 at most, as it refuses a whole search for more; with more, none, said once. */
+export declare function googleRegions(countries: string[] | undefined): string[];
+/** What one of Azure's places is, by its type: a street (an address, a road), an area (a town, a district, a governorate), or a place with a name of its own (a station, a park, a mall). */
+type Level = 'street' | 'area' | 'named';
+type LatLngAt = {
+    lat: number;
+    lng: number;
+};
+/** A place of Azure's, with what locating it takes: its address as Azure gave it, its level, its street line or its area's own name, and where the search looked. */
+export interface AzurePlace extends PlaceFound {
+    country: string;
+    azure: {
+        address: unknown;
+        level: Level;
+        street: string;
+        area?: string;
+        type?: string;
+        near?: LatLngAt;
+    };
+}
+/** Azure's places on two lines: the street, or the place's own name (a quarter's, a town's), then where it is; their parts when asked. */
+export declare function azurePlaces(found: unknown, locale: Locale, typed?: string, withParts?: boolean, near?: LatLngAt): AzurePlace[];
+/** A point named by Azure: its first address, in order. */
+export declare function azureNamed(found: unknown, locale: Locale): string;
+type Ask = (params: Record<string, string | number | undefined>) => Promise<unknown>;
+/**
+ * Azure's suggestions: nearest the place the page gives first, or the whole
+ * world's by prominence when it gives none; kept to the countries the page
+ * names by Azure itself (`countryRegion`), one request for each (a tenth of
+ * a Search transaction each; a list of them answers nothing), taken in
+ * turn, five in all. For an address field (`addresses`), no postcodes alone,
+ * and the addresses and areas first, the places with names of their own
+ * (a station, a park) after them, as Azure's types say. A row that reads as
+ * one before it is left out, as one that says less of the same place than
+ * another is. The word for a district typed before its name ("حي الروضة")
+ * is left out of the words asked, as Azure names its districts without it
+ * (with it, Azure lists other towns' streets and districts named with the
+ * word, and none of Riyadh's Al Rawdah); the words are asked as typed only
+ * when that finds nothing.
+ */
+export declare function azureSearch(autocomplete: Ask, request: SearchRequest): Promise<AzurePlace[]>;
+/**
+ * Where a suggestion of Azure's is (its suggestions carry no place), asked
+ * of its geocoding, the hits in the suggestion's own country and admin
+ * districts kept (`fits`; "Al Rawdah" in Riyadh's governorate, never in
+ * Al Wasiah's).
+ *
+ * A street, by its own address in Azure's structured form: its street line
+ * (never with a house number Azure made up), its own district for its
+ * locality where it names one below its town (its neighbourhood, the
+ * district its line names, "Kamel El Shenawy, Garden City"), then its
+ * locality, its admin districts, postcode and country; then by its two
+ * lines (`query`). Of each answer's streets, the one that names its
+ * district; else one in the district's own box as Azure has it (a little
+ * beyond it, as its point is a stretch's middle), asked for once; never a
+ * street of the name in another district (Azure's first "Kamel El Shenawy"
+ * is New Cairo's, 25 km from Garden City's), nor, for a street named by its
+ * number alone ("10 41 Street | Abu Tina"), one that does not say it is in
+ * its district where Azure knows none. Found nowhere so, its district
+ * (`precise: false`), else its town.
+ *
+ * An area by its own name (its neighbourhood, the place its line names, its
+ * locality; a governorate named for its town as the town: "Sohag", whose
+ * division's middle is 57 km from the city), never by its postcode (one of
+ * a town's many: Azure gives Tanta's 31111 for Tanta), or by its two lines
+ * where its neighbourhood is not its locality; a place with a name of its
+ * own by its two lines. Of places of one kind and name (Abu Dhabi's Al
+ * Bateen and Al Ain's), the one nearest where the search looked; found
+ * nowhere, the town it is in (`precise: false`).
+ *
+ * It is precise when the hit is the place itself (`isItself`), a street's
+ * in its own district: where Azure knows no box for the district, a street
+ * it marks `Ambiguous` (several of the words) is only near, as one of a
+ * number is unless it says it is in its district. Otherwise only near it.
+ * Never a place anywhere else: none is found then.
+ * A suggestion that names no region ("البرشاء 2", which Azure lists beside
+ * the same in Dubai) takes its city and region from the place found.
+ */
+export declare function azureLocate(geocode: Ask, place: AzurePlace, locale: Locale): Promise<{
+    precise?: false | undefined;
+    parts?: {
+        city?: string;
+        region?: string;
+        street?: string;
+        postcode?: string;
+        country?: string;
+    } | undefined;
+    address: string;
+    lat: number;
+    lng: number;
+}>;
+/**
+ * Google's `addressComponents`, each by its type: the country by its short
+ * code. Its number where Google's own line (`formatted`) puts it: before the
+ * street in Egypt and Saudi Arabia ("7524 King Fahd Rd"), after it in Jordan
+ * and Germany ("Rainbow St. 15"). Its city its locality; Egypt's streets have
+ * none, and their district stands for it ("Qasr El Nil", "Maadi"), by its
+ * name alone in Arabic too ("الدقي", not "قسم الدقي", its police district's).
+ */
+export declare const googleParts: (components: unknown, formatted?: unknown) => AddressParts | undefined;
+/**
+ * Google's suggestions: each one's name, and where it is; for an address
+ * field, the addresses first (their types say "geocode"), the shops and
+ * buildings after them. Each is located when picked, through `details`
+ * (Place Details), which ends its session (`end`), as picking it does.
+ */
+export declare function googlePlaces(answer: unknown, { locale, addresses, parts }: SearchRequest, details: (placeId: string) => Promise<unknown>, end: () => void): PlaceFound[];
+export {};