@whiteslove/parsing-lexicon 0.2.0 → 0.2.2

package/src/geography-detection.js

@@ -1,64 +1,64 @@
-import { COUNTRIES, canonicalCountryCode } from './countries.js';
-import { CITIES } from './geography.js';
-import { aliasesOf, aliasesToRegex, normalizeForMatch } from './normalization.js';
-
-const escapeRegex = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-
-function cityInflectionRegex(aliases) {
-  const cyrillic = [...new Set(aliases.filter((alias) => /\p{Script=Cyrillic}/u.test(alias)))];
-  if (!cyrillic.length) return null;
-  const patterns = cyrillic.map((alias) => {
-    const maxSuffix = alias.replace(/[^\p{L}\p{N}]/gu, '').length > 3 ? 5 : 3;
-    return `${escapeRegex(alias)}(?:\\p{Script=Cyrillic}{0,${maxSuffix}})`;
-  });
-  return new RegExp(`(?<![\\p{L}\\p{N}])(?:${patterns.join('|')})(?![\\p{L}\\p{N}])`, 'iu');
-}
-
-const CITY_MATCHERS = CITIES.map((item) => {
-  const aliases = [item.canonical, ...aliasesOf(item)];
-  return Object.freeze({
-    item,
-    exact: aliasesToRegex(aliases),
-    inflected: cityInflectionRegex(aliases),
-  });
-});
-
-const COUNTRY_MATCHERS = COUNTRIES.map((item) => {
-  // Two-letter country codes are intentionally excluded from arbitrary prose:
-  // e.g. English "us" must not make a vacancy a US role. Exact ISO-2 values
-  // are still handled by canonicalCountryCode().
-  const aliases = [item.canonical, ...aliasesOf(item)]
-    .filter((alias) => normalizeForMatch(alias).replace(/\s/g, '').length > 2);
-  return Object.freeze({ item, re: aliasesToRegex(aliases) });
-});
-
-const US_STATE_RE = /\b[A-Z][A-Za-z.'-]+(?:\s+[A-Z][A-Za-z.'-]+){0,3}\s*,?\s+(?:AL|AK|AZ|AR|CA|CO|CT|DE|FL|GA|HI|ID|IL|IN|IA|KS|KY|LA|ME|MD|MA|MI|MN|MS|MO|MT|NE|NV|NH|NJ|NM|NY|NC|ND|OH|OK|OR|PA|RI|SC|SD|TN|TX|UT|VT|VA|WA|WV|WI|WY|DC)\b/;
-
-/** Detect an ISO-2 country from a country alias, known city alias, or US city/state location. */
-export function detectCountryCodeFromText(value) {
-  const text = String(value || '').trim();
-  if (!text) return null;
-
-  const exact = canonicalCountryCode(text);
-  if (exact) return exact;
-
-  const country = COUNTRY_MATCHERS.find(({ re }) => re.test(text))?.item;
-  if (country?.code) return country.code;
-
-  // Keep dotted U.S. and explicit "remote US" support without treating the
-  // ordinary English pronoun "us" as a geography signal.
-  if (/\bU\.S\.?\b/.test(text) || /\bremote\s+us\b/i.test(text) || US_STATE_RE.test(text)) return 'US';
-
-  return detectCityFromText(text)?.country || null;
-}
-
-/** Detect a known city in free text, including common Cyrillic case inflections. */
-export function detectCityFromText(value, country = null) {
-  const text = String(value || '');
-  if (!text) return null;
-  const code = country ? canonicalCountryCode(country) : null;
-  const match = CITY_MATCHERS.find(({ item, exact, inflected }) =>
-    (!code || item.country === code) && (exact.test(text) || Boolean(inflected?.test(text))));
-  if (!match) return null;
-  return Object.freeze({ canonical: match.item.canonical, country: match.item.country || null });
-}
+import { COUNTRIES, canonicalCountryCode } from './countries.js';
+import { CITIES } from './geography.js';
+import { aliasesOf, aliasesToRegex, normalizeForMatch } from './normalization.js';
+
+const escapeRegex = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+
+function cityInflectionRegex(aliases) {
+  const cyrillic = [...new Set(aliases.filter((alias) => /\p{Script=Cyrillic}/u.test(alias)))];
+  if (!cyrillic.length) return null;
+  const patterns = cyrillic.map((alias) => {
+    const maxSuffix = alias.replace(/[^\p{L}\p{N}]/gu, '').length > 3 ? 5 : 3;
+    return `${escapeRegex(alias)}(?:\\p{Script=Cyrillic}{0,${maxSuffix}})`;
+  });
+  return new RegExp(`(?<![\\p{L}\\p{N}])(?:${patterns.join('|')})(?![\\p{L}\\p{N}])`, 'iu');
+}
+
+const CITY_MATCHERS = CITIES.map((item) => {
+  const aliases = [item.canonical, ...aliasesOf(item)];
+  return Object.freeze({
+    item,
+    exact: aliasesToRegex(aliases),
+    inflected: cityInflectionRegex(aliases),
+  });
+});
+
+const COUNTRY_MATCHERS = COUNTRIES.map((item) => {
+  // Two-letter country codes are intentionally excluded from arbitrary prose:
+  // e.g. English "us" must not make a vacancy a US role. Exact ISO-2 values
+  // are still handled by canonicalCountryCode().
+  const aliases = [item.canonical, ...aliasesOf(item)]
+    .filter((alias) => normalizeForMatch(alias).replace(/\s/g, '').length > 2);
+  return Object.freeze({ item, re: aliasesToRegex(aliases) });
+});
+
+const US_STATE_RE = /\b[A-Z][A-Za-z.'-]+(?:\s+[A-Z][A-Za-z.'-]+){0,3}\s*,?\s+(?:AL|AK|AZ|AR|CA|CO|CT|DE|FL|GA|HI|ID|IL|IN|IA|KS|KY|LA|ME|MD|MA|MI|MN|MS|MO|MT|NE|NV|NH|NJ|NM|NY|NC|ND|OH|OK|OR|PA|RI|SC|SD|TN|TX|UT|VT|VA|WA|WV|WI|WY|DC)\b/;
+
+/** Detect an ISO-2 country from a country alias, known city alias, or US city/state location. */
+export function detectCountryCodeFromText(value) {
+  const text = String(value || '').trim();
+  if (!text) return null;
+
+  const exact = canonicalCountryCode(text);
+  if (exact) return exact;
+
+  const country = COUNTRY_MATCHERS.find(({ re }) => re.test(text))?.item;
+  if (country?.code) return country.code;
+
+  // Keep dotted U.S. and explicit "remote US" support without treating the
+  // ordinary English pronoun "us" as a geography signal.
+  if (/\bU\.S\.?\b/.test(text) || /\bremote\s+us\b/i.test(text) || US_STATE_RE.test(text)) return 'US';
+
+  return detectCityFromText(text)?.country || null;
+}
+
+/** Detect a known city in free text, including common Cyrillic case inflections. */
+export function detectCityFromText(value, country = null) {
+  const text = String(value || '');
+  if (!text) return null;
+  const code = country ? canonicalCountryCode(country) : null;
+  const match = CITY_MATCHERS.find(({ item, exact, inflected }) =>
+    (!code || item.country === code) && (exact.test(text) || Boolean(inflected?.test(text))));
+  if (!match) return null;
+  return Object.freeze({ canonical: match.item.canonical, country: match.item.country || null });
+}

package/src/geography-display.d.ts

@@ -1,13 +1,13 @@
-export type GeographyDisplayKind = 'country' | 'region' | 'city' | 'district' | 'metro' | 'any';
-
-export const GEOGRAPHY_DISPLAY_NAMES: Readonly<Record<string, Readonly<{
-  country: Readonly<Record<string, string>>;
-  city: Readonly<Record<string, string>>;
-  region?: Readonly<Record<string, string>>;
-  district: Readonly<Record<string, string>>;
-  metro: Readonly<Record<string, string>>;
-  metroAlias: Readonly<Record<string, string>>;
-}>>>;
-
-export function geographyDisplayName(value: unknown, locale?: string, kind?: GeographyDisplayKind): string;
-export function geographyMetroLabelWithAlias(value: unknown, locale?: string): string;
+export type GeographyDisplayKind = 'country' | 'region' | 'city' | 'district' | 'metro' | 'any';
+
+export const GEOGRAPHY_DISPLAY_NAMES: Readonly<Record<string, Readonly<{
+  country: Readonly<Record<string, string>>;
+  city: Readonly<Record<string, string>>;
+  region?: Readonly<Record<string, string>>;
+  district: Readonly<Record<string, string>>;
+  metro: Readonly<Record<string, string>>;
+  metroAlias: Readonly<Record<string, string>>;
+}>>>;
+
+export function geographyDisplayName(value: unknown, locale?: string, kind?: GeographyDisplayKind): string;
+export function geographyMetroLabelWithAlias(value: unknown, locale?: string): string;

package/src/geography-display.js

@@ -1,113 +1,113 @@
-import { COUNTRIES } from './countries.js';
-import { CITIES, REGIONS } from './geography.js';
-
-// Centralized presentation names for canonical geography values.
-// Consumers must not maintain their own country/city/district/metro display dictionaries.
-
-export const GEOGRAPHY_DISPLAY_NAMES = Object.freeze({
-  ru: Object.freeze({
-    country: Object.freeze({ UZ: 'Узбекистан', KZ: 'Казахстан', UA: 'Украина', RO: 'Румыния', KG: 'Кыргызстан' }),
-    city: Object.freeze({
-      Tashkent: 'Ташкент', Samarkand: 'Самарканд', Bukhara: 'Бухара', Namangan: 'Наманган',
-      Andijan: 'Андижан', Fergana: 'Фергана', Nukus: 'Нукус', Navoi: 'Навои', Navoiy: 'Навои', Jizzakh: 'Джизак',
-      Termez: 'Термез', Qarshi: 'Карши', Urgench: 'Ургенч', Gulistan: 'Гулистан', Chirchiq: 'Чирчик',
-      'Tashkent Region': 'Ташкентская область', Karakalpakstan: 'Каракалпакстан', Kashkadarya: 'Кашкадарья',
-      Surkhandarya: 'Сурхандарья', Syrdarya: 'Сырдарья', Khorezm: 'Хорезм',
-      Almaty: 'Алматы', Astana: 'Астана', Shymkent: 'Шымкент', Karaganda: 'Караганда',
-      Aktobe: 'Актобе', Atyrau: 'Атырау', Oral: 'Уральск', Taraz: 'Тараз', Pavlodar: 'Павлодар',
-      Semey: 'Семей', Kostanay: 'Костанай', Kyzylorda: 'Кызылорда', Aktau: 'Актау', Oskemen: 'Усть-Каменогорск',
-      Kyiv: 'Киев', Lviv: 'Львов', Odesa: 'Одесса', Kharkiv: 'Харьков', Dnipro: 'Днепр',
-      Vinnytsia: 'Винница', 'Ivano-Frankivsk': 'Ивано-Франковск', Lutsk: 'Луцк', Chernivtsi: 'Черновцы',
-      Zaporizhzhia: 'Запорожье', Poltava: 'Полтава', Rivne: 'Ровно', Ternopil: 'Тернополь',
-      Uzhhorod: 'Ужгород', Khmelnytskyi: 'Хмельницкий', Zhytomyr: 'Житомир', Cherkasy: 'Черкассы',
-      Chernihiv: 'Чернигов', Sumy: 'Сумы', Mykolaiv: 'Николаев', Kropyvnytskyi: 'Кропивницкий',
-      Kherson: 'Херсон', 'Kryvyi Rih': 'Кривой Рог', Kremenchuk: 'Кременчуг', 'Bila Tserkva': 'Белая Церковь',
-      Kamianske: 'Каменское', Vyshneve: 'Вишневое', Boryspil: 'Борисполь', Vyshhorod: 'Вышгород',
-      Oleksandriia: 'Александрия', Pavlohrad: 'Павлоград', Nikopol: 'Никополь', Drohobych: 'Дрогобыч',
-      Stryi: 'Стрый', Kolomyia: 'Коломыя', Kalush: 'Калуш', 'Kamianets-Podilskyi': 'Каменец-Подольский',
-      Izmail: 'Измаил',
-      Bucharest: 'Бухарест', 'Cluj-Napoca': 'Клуж-Напока', Timisoara: 'Тимишоара', Iasi: 'Яссы',
-      Brasov: 'Брашов', Constanta: 'Констанца', Oradea: 'Орадя', Sibiu: 'Сибиу',
-    }),
-    district: Object.freeze({
-      Chilanzar: 'Чиланзар', Yunusabad: 'Юнусабад', 'Mirzo Ulugbek': 'Мирзо-Улугбек',
-      Yakkasaray: 'Яккасарай', Shaykhantahur: 'Шайхантахур', Yashnobod: 'Яшнабад', Sergeli: 'Сергели',
-      Uchtepa: 'Учтепа', Mirobod: 'Мирабад', Bektemir: 'Бектемир', Olmazor: 'Алмазар',
-      Almaly: 'Алмалинский', Bostandyk: 'Бостандыкский', Medeu: 'Медеуский', Auezov: 'Ауэзовский',
-      Turksib: 'Турксибский', Nauryzbay: 'Наурызбайский', Alatau: 'Алатауский', Zhetysu: 'Жетысуский',
-      Podil: 'Подол', Pechersk: 'Печерск', Pecherskyi: 'Печерский', Obolon: 'Оболонь',
-      Shevchenkivskyi: 'Шевченковский', Solomianskyi: 'Соломенский', Darnytskyi: 'Дарницкий',
-      Holosiivskyi: 'Голосеевский', Dniprovskyi: 'Днепровский', Sviatoshynskyi: 'Святошинский',
-      Desnianskyi: 'Деснянский', Prymorskyi: 'Приморский', Frankivskyi: 'Франковский',
-      Tsentralnyi: 'Центральный', 'Tsentralno-Miskyi': 'Центрально-Городской', Tsentr: 'Центр',
-      Prospekt: 'Проспект', Ruska: 'Русская', Hraviton: 'Гравитон', Komarova: 'Комарова', Roscha: 'Роща',
-      Sadgora: 'Садгора', Avtovokzal: 'Автовокзал', Pipera: 'Пипера', Militari: 'Милитари',
-      'Drumul Taberei': 'Друмул Таберей', Titan: 'Титан', Berceni: 'Берчень', Floreasca: 'Флоряска',
-      Dorobanti: 'Доробанць', Cotroceni: 'Котрочень',
-    }),
-    metro: Object.freeze({
-      'Buyuk Ipak Yoli': 'Буюк Ипак Йули', Pushkin: 'Пушкин', 'Hamid Olimjon': 'Хамид Алимджан',
-      'Amir Temur Xiyoboni': 'Амир Темур Хиёбони', 'Mustaqillik Maydoni': 'Мустакиллик майдони',
-      Paxtakor: 'Пахтакор', 'Xalqlar Dostligi': 'Халклар Дустлиги', 'Milliy Bog': 'Миллий Бог', Novza: 'Новза',
-      'Mirzo Ulugbek': 'Мирзо Улугбек', Chilonzor: 'Чиланзар', Olmazor: 'Алмазар', Choshtepa: 'Чаштепа',
-      Ozgarish: 'Узгариш', Sergeli: 'Сергели', Yangihayot: 'Янгихаёт', Chinor: 'Чинар', Beruniy: 'Беруни',
-      Tinchlik: 'Тинчлик', Chorsu: 'Чорсу', 'Gafur Gulom': 'Гафур Гулям', 'Alisher Navoi': 'Алишер Навои',
-      Ozbekiston: 'Узбекистан', Kosmonavtlar: 'Космонавтлар', Oybek: 'Ойбек', Toshkent: 'Ташкент',
-      Mashinasozlar: 'Машинасозлар', Dostlik: 'Дустлик', Turkiston: 'Туркистон', Yunusobod: 'Юнусабад',
-      Shahriston: 'Шахристан', Bodomzor: 'Бадамзар', Minor: 'Минор', 'Abdulla Qodiriy': 'Абдулла Кадыри',
-      'Yunus Rajabiy': 'Юнус Раджаби', 'Ming Orik': 'Мингурик', Texnopark: 'Технопарк', Yashnobod: 'Яшнабад',
-      Tuzel: 'Тузель', Olmos: 'Алмас', Rohat: 'Рохат', Yangiobod: 'Янгиабад', Qoyliq: 'Куйлюк', Matonat: 'Матонат',
-      Qiyot: 'Кият', Tolariq: 'Толарык', Xonobod: 'Хонабад', Quruvchilar: 'Курувчилар', Turon: 'Туран', Qipchoq: 'Кипчак',
-    }),
-    metroAlias: Object.freeze({
-      'Buyuk Ipak Yoli': 'Максим Горький', Novza: 'Хамза',
-      'Amir Temur Xiyoboni': 'Сквер Октябрьской Революции', 'Mustaqillik Maydoni': 'Площадь Ленина',
-      'Milliy Bog': 'Национальный парк', Yunusobod: 'Фахрийлар чойхонаси',
-      'Xalqlar Dostligi': 'Дружба народов', Ozbekiston: 'Узбекистан', Mashinasozlar: 'Машиностроителей',
-      Dostlik: 'Дружба', Tinchlik: 'Мир',
-    }),
-  }),
-});
-
-function languageKey(locale) {
-  return String(locale || 'en').toLowerCase().split(/[-_]/)[0];
-}
-
-function preferredEntityLabel(entry, locale) {
-  if (!entry) return null;
-  const key = languageKey(locale);
-  const aliases = entry.aliases?.[key] || entry.aliases?.all || entry.aliases?.en || [];
-  return aliases[0] || entry.canonical || null;
-}
-
-function canonicalEntityLabel(catalog, value, locale) {
-  const entry = catalog.find((item) => item.canonical === value);
-  return preferredEntityLabel(entry, locale);
-}
-
-export function geographyDisplayName(value, locale = 'en', kind = 'any') {
-  const text = String(value || '').trim();
-  if (!text) return '';
-  const language = languageKey(locale);
-  const tables = GEOGRAPHY_DISPLAY_NAMES[language];
-  if (kind === 'country') {
-    const code = text.toUpperCase();
-    const explicit = tables?.country?.[code];
-    if (explicit) return explicit;
-    return preferredEntityLabel(COUNTRIES.find((item) => item.code === code || item.canonical === text), locale) || text;
-  }
-  if (kind === 'city') return tables?.city?.[text] || canonicalEntityLabel(CITIES, text, locale) || text;
-  if (kind === 'region') return tables?.region?.[text] || canonicalEntityLabel(REGIONS, text, locale) || text;
-  if (kind === 'district') return tables?.district?.[text] || text;
-  if (kind === 'metro') return tables?.metro?.[text] || text;
-  return tables?.country?.[text.toUpperCase()] || tables?.city?.[text] || tables?.region?.[text] || tables?.district?.[text] || tables?.metro?.[text] || canonicalEntityLabel(CITIES, text, locale) || canonicalEntityLabel(REGIONS, text, locale) || preferredEntityLabel(COUNTRIES.find((item) => item.code === text.toUpperCase() || item.canonical === text), locale) || text;
-}
-
-export function geographyMetroLabelWithAlias(value, locale = 'en') {
-  const text = String(value || '').trim();
-  if (!text) return '';
-  const label = geographyDisplayName(text, locale, 'metro');
-  const tables = GEOGRAPHY_DISPLAY_NAMES[languageKey(locale)];
-  const alias = tables?.metroAlias?.[text];
-  return alias && alias !== label ? `${label} (${alias})` : label;
-}
+import { COUNTRIES } from './countries.js';
+import { CITIES, REGIONS } from './geography.js';
+
+// Centralized presentation names for canonical geography values.
+// Consumers must not maintain their own country/city/district/metro display dictionaries.
+
+export const GEOGRAPHY_DISPLAY_NAMES = Object.freeze({
+  ru: Object.freeze({
+    country: Object.freeze({ UZ: 'Узбекистан', KZ: 'Казахстан', UA: 'Украина', RO: 'Румыния', KG: 'Кыргызстан' }),
+    city: Object.freeze({
+      Tashkent: 'Ташкент', Samarkand: 'Самарканд', Bukhara: 'Бухара', Namangan: 'Наманган',
+      Andijan: 'Андижан', Fergana: 'Фергана', Nukus: 'Нукус', Navoi: 'Навои', Navoiy: 'Навои', Jizzakh: 'Джизак',
+      Termez: 'Термез', Qarshi: 'Карши', Urgench: 'Ургенч', Gulistan: 'Гулистан', Chirchiq: 'Чирчик',
+      'Tashkent Region': 'Ташкентская область', Karakalpakstan: 'Каракалпакстан', Kashkadarya: 'Кашкадарья',
+      Surkhandarya: 'Сурхандарья', Syrdarya: 'Сырдарья', Khorezm: 'Хорезм',
+      Almaty: 'Алматы', Astana: 'Астана', Shymkent: 'Шымкент', Karaganda: 'Караганда',
+      Aktobe: 'Актобе', Atyrau: 'Атырау', Oral: 'Уральск', Taraz: 'Тараз', Pavlodar: 'Павлодар',
+      Semey: 'Семей', Kostanay: 'Костанай', Kyzylorda: 'Кызылорда', Aktau: 'Актау', Oskemen: 'Усть-Каменогорск',
+      Kyiv: 'Киев', Lviv: 'Львов', Odesa: 'Одесса', Kharkiv: 'Харьков', Dnipro: 'Днепр',
+      Vinnytsia: 'Винница', 'Ivano-Frankivsk': 'Ивано-Франковск', Lutsk: 'Луцк', Chernivtsi: 'Черновцы',
+      Zaporizhzhia: 'Запорожье', Poltava: 'Полтава', Rivne: 'Ровно', Ternopil: 'Тернополь',
+      Uzhhorod: 'Ужгород', Khmelnytskyi: 'Хмельницкий', Zhytomyr: 'Житомир', Cherkasy: 'Черкассы',
+      Chernihiv: 'Чернигов', Sumy: 'Сумы', Mykolaiv: 'Николаев', Kropyvnytskyi: 'Кропивницкий',
+      Kherson: 'Херсон', 'Kryvyi Rih': 'Кривой Рог', Kremenchuk: 'Кременчуг', 'Bila Tserkva': 'Белая Церковь',
+      Kamianske: 'Каменское', Vyshneve: 'Вишневое', Boryspil: 'Борисполь', Vyshhorod: 'Вышгород',
+      Oleksandriia: 'Александрия', Pavlohrad: 'Павлоград', Nikopol: 'Никополь', Drohobych: 'Дрогобыч',
+      Stryi: 'Стрый', Kolomyia: 'Коломыя', Kalush: 'Калуш', 'Kamianets-Podilskyi': 'Каменец-Подольский',
+      Izmail: 'Измаил',
+      Bucharest: 'Бухарест', 'Cluj-Napoca': 'Клуж-Напока', Timisoara: 'Тимишоара', Iasi: 'Яссы',
+      Brasov: 'Брашов', Constanta: 'Констанца', Oradea: 'Орадя', Sibiu: 'Сибиу',
+    }),
+    district: Object.freeze({
+      Chilanzar: 'Чиланзар', Yunusabad: 'Юнусабад', 'Mirzo Ulugbek': 'Мирзо-Улугбек',
+      Yakkasaray: 'Яккасарай', Shaykhantahur: 'Шайхантахур', Yashnobod: 'Яшнабад', Sergeli: 'Сергели',
+      Uchtepa: 'Учтепа', Mirobod: 'Мирабад', Bektemir: 'Бектемир', Olmazor: 'Алмазар',
+      Almaly: 'Алмалинский', Bostandyk: 'Бостандыкский', Medeu: 'Медеуский', Auezov: 'Ауэзовский',
+      Turksib: 'Турксибский', Nauryzbay: 'Наурызбайский', Alatau: 'Алатауский', Zhetysu: 'Жетысуский',
+      Podil: 'Подол', Pechersk: 'Печерск', Pecherskyi: 'Печерский', Obolon: 'Оболонь',
+      Shevchenkivskyi: 'Шевченковский', Solomianskyi: 'Соломенский', Darnytskyi: 'Дарницкий',
+      Holosiivskyi: 'Голосеевский', Dniprovskyi: 'Днепровский', Sviatoshynskyi: 'Святошинский',
+      Desnianskyi: 'Деснянский', Prymorskyi: 'Приморский', Frankivskyi: 'Франковский',
+      Tsentralnyi: 'Центральный', 'Tsentralno-Miskyi': 'Центрально-Городской', Tsentr: 'Центр',
+      Prospekt: 'Проспект', Ruska: 'Русская', Hraviton: 'Гравитон', Komarova: 'Комарова', Roscha: 'Роща',
+      Sadgora: 'Садгора', Avtovokzal: 'Автовокзал', Pipera: 'Пипера', Militari: 'Милитари',
+      'Drumul Taberei': 'Друмул Таберей', Titan: 'Титан', Berceni: 'Берчень', Floreasca: 'Флоряска',
+      Dorobanti: 'Доробанць', Cotroceni: 'Котрочень',
+    }),
+    metro: Object.freeze({
+      'Buyuk Ipak Yoli': 'Буюк Ипак Йули', Pushkin: 'Пушкин', 'Hamid Olimjon': 'Хамид Алимджан',
+      'Amir Temur Xiyoboni': 'Амир Темур Хиёбони', 'Mustaqillik Maydoni': 'Мустакиллик майдони',
+      Paxtakor: 'Пахтакор', 'Xalqlar Dostligi': 'Халклар Дустлиги', 'Milliy Bog': 'Миллий Бог', Novza: 'Новза',
+      'Mirzo Ulugbek': 'Мирзо Улугбек', Chilonzor: 'Чиланзар', Olmazor: 'Алмазар', Choshtepa: 'Чаштепа',
+      Ozgarish: 'Узгариш', Sergeli: 'Сергели', Yangihayot: 'Янгихаёт', Chinor: 'Чинар', Beruniy: 'Беруни',
+      Tinchlik: 'Тинчлик', Chorsu: 'Чорсу', 'Gafur Gulom': 'Гафур Гулям', 'Alisher Navoi': 'Алишер Навои',
+      Ozbekiston: 'Узбекистан', Kosmonavtlar: 'Космонавтлар', Oybek: 'Ойбек', Toshkent: 'Ташкент',
+      Mashinasozlar: 'Машинасозлар', Dostlik: 'Дустлик', Turkiston: 'Туркистон', Yunusobod: 'Юнусабад',
+      Shahriston: 'Шахристан', Bodomzor: 'Бадамзар', Minor: 'Минор', 'Abdulla Qodiriy': 'Абдулла Кадыри',
+      'Yunus Rajabiy': 'Юнус Раджаби', 'Ming Orik': 'Мингурик', Texnopark: 'Технопарк', Yashnobod: 'Яшнабад',
+      Tuzel: 'Тузель', Olmos: 'Алмас', Rohat: 'Рохат', Yangiobod: 'Янгиабад', Qoyliq: 'Куйлюк', Matonat: 'Матонат',
+      Qiyot: 'Кият', Tolariq: 'Толарык', Xonobod: 'Хонабад', Quruvchilar: 'Курувчилар', Turon: 'Туран', Qipchoq: 'Кипчак',
+    }),
+    metroAlias: Object.freeze({
+      'Buyuk Ipak Yoli': 'Максим Горький', Novza: 'Хамза',
+      'Amir Temur Xiyoboni': 'Сквер Октябрьской Революции', 'Mustaqillik Maydoni': 'Площадь Ленина',
+      'Milliy Bog': 'Национальный парк', Yunusobod: 'Фахрийлар чойхонаси',
+      'Xalqlar Dostligi': 'Дружба народов', Ozbekiston: 'Узбекистан', Mashinasozlar: 'Машиностроителей',
+      Dostlik: 'Дружба', Tinchlik: 'Мир',
+    }),
+  }),
+});
+
+function languageKey(locale) {
+  return String(locale || 'en').toLowerCase().split(/[-_]/)[0];
+}
+
+function preferredEntityLabel(entry, locale) {
+  if (!entry) return null;
+  const key = languageKey(locale);
+  const aliases = entry.aliases?.[key] || entry.aliases?.all || entry.aliases?.en || [];
+  return aliases[0] || entry.canonical || null;
+}
+
+function canonicalEntityLabel(catalog, value, locale) {
+  const entry = catalog.find((item) => item.canonical === value);
+  return preferredEntityLabel(entry, locale);
+}
+
+export function geographyDisplayName(value, locale = 'en', kind = 'any') {
+  const text = String(value || '').trim();
+  if (!text) return '';
+  const language = languageKey(locale);
+  const tables = GEOGRAPHY_DISPLAY_NAMES[language];
+  if (kind === 'country') {
+    const code = text.toUpperCase();
+    const explicit = tables?.country?.[code];
+    if (explicit) return explicit;
+    return preferredEntityLabel(COUNTRIES.find((item) => item.code === code || item.canonical === text), locale) || text;
+  }
+  if (kind === 'city') return tables?.city?.[text] || canonicalEntityLabel(CITIES, text, locale) || text;
+  if (kind === 'region') return tables?.region?.[text] || canonicalEntityLabel(REGIONS, text, locale) || text;
+  if (kind === 'district') return tables?.district?.[text] || text;
+  if (kind === 'metro') return tables?.metro?.[text] || text;
+  return tables?.country?.[text.toUpperCase()] || tables?.city?.[text] || tables?.region?.[text] || tables?.district?.[text] || tables?.metro?.[text] || canonicalEntityLabel(CITIES, text, locale) || canonicalEntityLabel(REGIONS, text, locale) || preferredEntityLabel(COUNTRIES.find((item) => item.code === text.toUpperCase() || item.canonical === text), locale) || text;
+}
+
+export function geographyMetroLabelWithAlias(value, locale = 'en') {
+  const text = String(value || '').trim();
+  if (!text) return '';
+  const label = geographyDisplayName(text, locale, 'metro');
+  const tables = GEOGRAPHY_DISPLAY_NAMES[languageKey(locale)];
+  const alias = tables?.metroAlias?.[text];
+  return alias && alias !== label ? `${label} (${alias})` : label;
+}