@whiteslove/parsing-lexicon 0.5.2 → 0.5.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@whiteslove/parsing-lexicon",
-  "version": "0.5.2",
+  "version": "0.5.3",
   "description": "Shared deterministic multilingual parsing lexicon for WhitesLove housing and hiring services",
   "repository": {
     "type": "git",
@@ -27,6 +27,10 @@
       "types": "./src/geography-display.d.ts",
       "import": "./src/geography-display.js"
     },
+    "./geography-zone-display": {
+      "types": "./src/geography-zone-display.d.ts",
+      "import": "./src/geography-zone-display.js"
+    },
     "./geography-detection": {
       "types": "./src/geography-detection.d.ts",
       "import": "./src/geography-detection.js"

package/src/geography-zone-display.d.ts

@@ -0,0 +1,7 @@
+import type { GeographyDisplayContext } from './geography-display.js';
+
+export function geographyZoneDisplayName(
+  value: unknown,
+  locale?: string,
+  context?: GeographyDisplayContext | null,
+): string;

package/src/geography-zone-display.js

@@ -0,0 +1,154 @@
+import { geographyDisplayName } from './geography-display.js';
+import { dictionaryFor } from './locations.js';
+import { aliasesOf, findCanonical } from './normalization.js';
+import { canonicalCountryCode } from './countries.js';
+
+const ZONE_KINDS = Object.freeze([
+  ['city', []],
+  ['district', ['districts']],
+  ['microdistrict', ['microdistricts']],
+  ['metro', ['metro']],
+  ['mahalla', ['mahallas']],
+  ['local_area', ['localAreas']],
+  ['development_area', ['developmentAreas']],
+  ['residential_complex', ['residentialComplexes']],
+  ['settlement', ['settlements']],
+  ['suburb', ['suburbs']],
+]);
+
+const CYRILLIC_RE = /\p{Script=Cyrillic}/u;
+const NON_RUSSIAN_CYRILLIC_RE = /[ІіЇїЄєҐґЎўҚқҒғҲҳӘәӨөҰұҮүҢң]/u;
+const UZBEK_LOCALITY_SUFFIX_RE = /\b(?:массиви|махалласи|даҳаси|дахаси|мавзеси)\b/iu;
+const COMPACT_ZONE_SUFFIX_RE = /\s+(?:массив|массиви|микрорайон|мкр|квартал|махалла|махалласи|даха|дахаси|даҳаси|мавзе|мавзеси|massiv|massivi|daha|dahasi|mahalla|mahallasi|mavze|mavzesi)$/iu;
+
+function compactBase(label) {
+  const compact = String(label || '').replace(COMPACT_ZONE_SUFFIX_RE, '').trim();
+  return compact || String(label || '').trim();
+}
+
+function languageKey(locale) {
+  const key = String(locale || 'en').toLowerCase().split(/[-_]/)[0];
+  return key === 'ru' || key === 'uz' ? key : 'en';
+}
+
+function dictionaryForContext(context) {
+  const country = canonicalCountryCode(context?.country);
+  const city = String(context?.city || '').trim();
+  if (!country || !city) return null;
+  return dictionaryFor(country, city);
+}
+
+function preferredFallbackAlias(entry, locale) {
+  const language = languageKey(locale);
+  const canonical = entry?.canonical || entry?.name || null;
+  if (!entry || !canonical || language === 'en') return canonical;
+
+  const aliases = aliasesOf(entry).map((value) => String(value || '').trim()).filter(Boolean);
+  if (language === 'ru') {
+    const candidates = aliases
+      .filter((alias) => CYRILLIC_RE.test(alias) && !NON_RUSSIAN_CYRILLIC_RE.test(alias))
+      .sort((a, b) => {
+        const suffixPenalty = Number(UZBEK_LOCALITY_SUFFIX_RE.test(a)) - Number(UZBEK_LOCALITY_SUFFIX_RE.test(b));
+        if (suffixPenalty) return suffixPenalty;
+        return compactBase(a).length - compactBase(b).length || a.length - b.length;
+      });
+    return candidates[0] || canonical;
+  }
+
+  return entry.labels?.uz || canonical;
+}
+
+function localizedEntryLabel(entry, locale, kind, compact = false) {
+  if (!entry) return null;
+  const canonical = entry.canonical || entry.name;
+  if (!canonical) return null;
+
+  const established = geographyDisplayName(canonical, locale, kind, null);
+  const label = established !== canonical
+    ? established
+    : preferredFallbackAlias(entry, locale);
+  return compact ? compactBase(label) : label;
+}
+
+function resolveDictionaryZone(raw, locale, context, compact = false) {
+  const dictionary = dictionaryForContext(context);
+  if (!dictionary) return null;
+
+  for (const [kind, keys] of ZONE_KINDS) {
+    for (const key of keys) {
+      const entries = dictionary[key] || [];
+      const entry = findCanonical(raw, entries, { transliteration: true });
+      if (!entry) continue;
+      return localizedEntryLabel(entry, locale, kind, compact);
+    }
+  }
+  return null;
+}
+
+function directZoneLabel(raw, locale, context) {
+  // Preserve the existing consumer precedence: stable shared presentation names
+  // win first, then the selected city dictionary fills aliases that those tables
+  // do not know. This keeps canonical geo-catalog values such as Karasu usable
+  // even when the listing lexicon canonical is Qorasuv.
+  for (const [kind] of ZONE_KINDS) {
+    const translated = geographyDisplayName(raw, locale, kind, null);
+    if (translated && translated !== raw) return compactBase(translated);
+  }
+
+  const scoped = resolveDictionaryZone(raw, locale, context, true);
+  return scoped && scoped !== raw ? scoped : null;
+}
+
+function compositeBaseLabel(rawBase, locale, context) {
+  const direct = directZoneLabel(rawBase, locale, context);
+  if (direct) return compactBase(direct);
+
+  const probes = [
+    rawBase,
+    `${rawBase} massiv`,
+    `${rawBase} massivi`,
+    `${rawBase} массив`,
+    `${rawBase} массиви`,
+    `${rawBase} daha`,
+    `${rawBase} dahasi`,
+    `${rawBase} даха`,
+    `${rawBase} дахаси`,
+    `${rawBase} даҳаси`,
+    `${rawBase} mahalla`,
+    `${rawBase} mahallasi`,
+    `${rawBase} махалла`,
+    `${rawBase} махалласи`,
+  ];
+
+  for (const probe of probes) {
+    const label = resolveDictionaryZone(probe, locale, context, true);
+    if (label) return label;
+  }
+  return null;
+}
+
+/**
+ * Resolve a visible label for a canonical or source-provided housing/map zone.
+ *
+ * This API intentionally owns multilingual alias/script/transliteration rules so
+ * UI consumers do not need to inspect location dictionaries or understand Uzbek
+ * locality suffixes. The returned value is presentation-only; callers should keep
+ * the original canonical/filter value for routing and queries.
+ */
+export function geographyZoneDisplayName(value, locale = 'en', context = null) {
+  const raw = String(value || '').trim();
+  if (!raw) return '';
+
+  const direct = directZoneLabel(raw, locale, context);
+  if (direct) return direct;
+
+  const separatorIndex = raw.indexOf('-');
+  if (separatorIndex > 0) {
+    const base = raw.slice(0, separatorIndex).trim();
+    const suffix = raw.slice(separatorIndex);
+    const label = compositeBaseLabel(base, locale, context);
+    if (label) return `${label}${suffix}`;
+  }
+
+  return raw;
+}

package/src/locations.js

@@ -14,6 +14,7 @@ import { UA_MAJOR_LOCATION_EXTENSIONS } from './ua-location-extensions-major.js'
 import { UA_REGIONAL_LOCATION_EXTENSIONS } from './ua-location-extensions-regional.js';
 import { UA_SECONDARY_LOCATION_EXTENSIONS } from './ua-secondary-cities.js';
 import { UA_METRO_LOCATION_EXTENSIONS } from './ua-location-extensions-metro.js';
+import { UA_KHARKIV_LOCATION_TRANSLATIONS } from './ua-kharkiv-location-translations.js';
 
 export const UA_EXTRA_LOCATION_DICTIONARIES = Object.freeze({
   ...RAW_UA_EXTRA_LOCATION_DICTIONARIES,
@@ -92,8 +93,6 @@ function normalizeUzSemanticLocations(country) {
   const qorasuv = (tashkent?.microdistricts || []).find(({ name }) => name === 'Qorasuv');
 
   if (tashkent && qorasuv) {
-    // Bare Qorasuv is ambiguous with numbered Qorasuv/Karasu blocks. The
-    // umbrella area therefore requires an area/massif/daha form in free text.
     const qorasuvAliases = Object.freeze([...new Set([
       ...(qorasuv.aliases || []).filter((alias) => !/^(?:qorasuv|korasuv|корасув|карасу)$/iu.test(String(alias).trim())),
       'Qorasuv dahasi',
@@ -129,10 +128,6 @@ function normalizeUzSemanticLocations(country) {
     const landmarks = samarkand.landmarks || [];
     const localAreas = samarkand.localAreas || [];
     const streets = samarkand.streets || [];
-
-    // Legacy UZ seeds contain a few Samarkand listing labels as separate
-    // canonicals or under the wrong semantic collection. Normalize them to the
-    // single physical subjects already represented by geo-catalog.
     const centralPark = landmarks.find(({ name }) => name === 'Central Park');
     const alisherPark = landmarks.find(({ name }) => name === 'Alisher Navoiy Park');
     const canonicalPark = centralPark || alisherPark;
@@ -205,8 +200,6 @@ function normalizeUzSemanticLocations(country) {
     const oldCity = localAreas.find(({ name }) => name === 'Old City');
 
     if (ichanKala && oldCity) {
-      // UNESCO identifies Itchan Kala as the historic inner-city of Khiva.
-      // Keep listing-friendly Old City forms as aliases of that one place.
       const normalizedIchanKala = semanticEntry(ichanKala, 'Ichan Kala', [
         ...(ichanKala.aliases || []),
         ...(oldCity.aliases || []),
@@ -317,9 +310,6 @@ function normalizeUaSemanticLocations(country) {
   const odesa = country?.Odesa;
   if (!odesa) return country;
 
-  // “5–16 station of Velykyi Fontan” are traditional listing/locality zones
-  // anchored to the Fontanska Road transit stops, not twelve standalone city
-  // microdistricts. Keep their parsing value but expose them as local areas.
   const fontanStationAreas = Object.freeze(
     (odesa.microdistricts || [])
       .filter(({ name }) => ODESA_FONTAN_STATION_RE.test(name))
@@ -351,6 +341,9 @@ const UZ_LOCATION_DICTIONARIES = normalizeUzSemanticLocations(mergeLocationCount
 ));
 
 const UA_SEMANTIC_LOCATION_EXTENSIONS = normalizeUaSemanticLocations(UA_MAJOR_LOCATION_EXTENSIONS);
+const UA_KHARKIV_TRANSLATION_EXTENSIONS = Object.freeze({
+  Kharkiv: UA_KHARKIV_LOCATION_TRANSLATIONS,
+});
 
 const COUNTRY_LOCATION_DICTIONARIES = Object.freeze({
   ...BASE_LOCATION_DICTIONARIES,
@@ -365,14 +358,13 @@ const COUNTRY_LOCATION_DICTIONARIES = Object.freeze({
     UA_REGIONAL_LOCATION_EXTENSIONS,
     UA_SECONDARY_LOCATION_EXTENSIONS,
     UA_METRO_LOCATION_EXTENSIONS,
+    UA_KHARKIV_TRANSLATION_EXTENSIONS,
   ),
 });
 
 /** Canonical country -> city -> location dictionary registry. */
 export const LOCATION_DICTIONARIES = COUNTRY_LOCATION_DICTIONARIES;
 
-// Compatibility exports. Legacy seeds are not canonical ownership; consumers
-// should use LOCATION_DICTIONARIES/locationCities().
 export {
   UA_REGION_ENTRIES,
   UA_SECONDARY_CITIES,

package/src/ua-kharkiv-location-translations.js

@@ -0,0 +1,91 @@
+import { locationEntries } from './location-merge.js';
+
+// Kharkiv-specific multilingual aliases that are useful in listing text and
+// benefit from explicit UA/RU coverage. Canonicals intentionally match the
+// major Ukraine location layer so mergeLocationEntries enriches one subject
+// instead of creating parallel parser entities.
+const numberedMicrodistricts = Object.freeze([
+  '455','519','520','521','522','524','531','533','536','537','601','602','603','604','605','606','607','608','614','615','616','624','625','626','627','656',
+]);
+
+const NUMBERED_EXTRA_ALIASES = Object.freeze({
+  536: Object.freeze(['Містечко Будівельників', 'Містечко будівельників', 'Городок Строителей', 'Городок строителей']),
+  537: Object.freeze(['537 м.р.', '537 м.р']),
+});
+
+const numberedMicrodistrictRow = (number) => [
+  `${number} microdistrict`,
+  `${number}-й мікрорайон`,
+  `${number} мікрорайон`,
+  `${number}-й микрорайон`,
+  `${number} микрорайон`,
+  `${number} мкр`,
+  `${number} мкр.`,
+  `${number}-й мкр`,
+  `${number}-й мкр.`,
+  `${number} м/р`,
+  `${number}-й м/р`,
+  `${number} мрн`,
+  `${number} мрн.`,
+  ...(NUMBERED_EXTRA_ALIASES[number] || []),
+];
+
+export const UA_KHARKIV_LOCATION_TRANSLATIONS = Object.freeze({
+  microdistricts: locationEntries([
+    ...numberedMicrodistricts.map(numberedMicrodistrictRow),
+    ['535A', '535 microdistrict', '535-й мікрорайон', '535 мікрорайон', '535-й микрорайон', '535 микрорайон', '535 мкр', '535 мкр.', '535-й мкр', '535-й мкр.', '535 м/р', '535 мрн', '535A мкр', '535А мкр', '535а мкр', '535A мкр.', '535А мкр.', '535а мкр.', '535A м/р', '535А м/р', '535а м/р', '535A мрн', '535А мрн', '535а мрн'],
+    ['606A', '606A мкр', '606А мкр', '606а мкр', '606A мкр.', '606А мкр.', '606а мкр.', '606A м/р', '606А м/р', '606а м/р', '606A мрн', '606А мрн', '606а мрн'],
+    ['627 microdistrict', '624A', '624А', '624а', '624A microdistrict', '624А мікрорайон', '624а мікрорайон', '624А микрорайон', '624а микрорайон', '624А мкр', '624а мкр'],
+    ['Horizont', 'Обрій', 'Обрий', 'Obrii', 'Горизонт'],
+  ]),
+  streets: locationEntries([
+    ['Hvardiitsiv-Shyronintsiv Street', 'вулиця Гвардійців-Широнінців', 'вул. Гвардійців-Широнінців', 'Гвардійців-Широнінців', 'улица Гвардейцев-Широнинцев', 'ул. Гвардейцев-Широнинцев', 'Гвардейцев-Широнинцев', 'Гвардейцев Широнинцев'],
+    ['Yuvileinyi Avenue', 'проспект Ювілейний', 'пр-т Ювілейний', 'Ювілейний проспект', 'проспект Юбилейный', 'пр-т Юбилейный', 'Юбилейный проспект', 'проспект 50-річчя ВЛКСМ', 'проспект 50-летия ВЛКСМ'],
+    ['Traktorobudivnykiv Avenue', 'проспект Тракторобудівників', 'пр-т Тракторобудівників', 'Тракторобудівників проспект', 'проспект Тракторостроителей', 'пр-т Тракторостроителей', 'Тракторостроителей проспект'],
+    ['Lva Landau Avenue', 'проспект Льва Ландау', 'пр-т Льва Ландау', 'Льва Ландау', 'Lva Landau Ave', 'проспект 50-річчя СРСР', 'проспект 50-летия СССР'],
+    ['Aerokosmichnyi Avenue', 'Аерокосмічний проспект', 'проспект Аерокосмічний', 'пр-т Аерокосмічний', 'Аэрокосмический проспект', 'проспект Аэрокосмический', 'пр-т Аэрокосмический', 'проспект Гагаріна', 'проспект Гагарина', 'Haharina Avenue', 'Gagarina Avenue'],
+    ['Amosova Street', 'вулиця Амосова', 'вул. Амосова', 'Амосова', 'улица Амосова', 'ул. Амосова', 'вулиця Корчагінців', 'Корчагінців', 'улица Корчагинцев', 'Корчагинцев'],
+    ['Valentynivska Street', 'вулиця Валентинівська', 'вул. Валентинівська', 'Валентинівська', 'улица Валентиновская', 'ул. Валентиновская', 'Валентиновская', 'вулиця Блюхера', 'вул. Блюхера', 'улица Блюхера', 'ул. Блюхера'],
+    ['Sobornosti Ukrainy Street', 'вулиця Соборності України', 'вул. Соборності України', 'Соборності України', 'улица Соборности Украины', 'ул. Соборности Украины', 'Соборности Украины', 'вулиця Дружби Народів', 'вул. Дружби Народів', 'Дружби Народів', 'улица Дружбы Народов', 'ул. Дружбы Народов', 'Дружбы Народов'],
+  ]),
+  residentialComplexes: locationEntries([
+    ['Pavlovsky Kvartal', 'Павлівський квартал', 'ЖК Павлівський квартал', 'Павловский квартал', 'ЖК Павловский квартал'],
+    ['Dim na Sumskii', 'Будинок на Сумській', 'Дім на Сумській', 'ЖК Будинок на Сумській', 'Дом на Сумской', 'ЖК Дом на Сумской'],
+    ['Myronosytska', 'Мироносицька', 'ЖК Мироносицька', 'Мироносицкая', 'ЖК Мироносицкая'],
+    ['Felicita', 'Феліціта', 'ЖК Феліціта', 'Феличита', 'ЖК Феличита'],
+    ['Rezidentsiia', 'Резиденція', 'ЖК Резиденція', 'Резиденция', 'ЖК Резиденция'],
+    ['Hydropark', 'ЖК Гідропарк', 'ЖК Гидропарк'],
+    ['Ovis', 'Овіс', 'ЖК Овіс', 'Овис', 'ЖК Овис', 'OVIS', 'ЖК OVIS'],
+    ['Flagman', 'Флагман', 'ЖК Флагман'],
+    ['Kvant', 'Квант', 'ЖК Квант'],
+    ['Crystal', 'Кристал', 'Кристалл', 'ЖК Кристал', 'ЖК Кристалл', 'ЖК Crystal'],
+    ['Sokolnyky', 'ЖК Сокільники', 'ЖК Сокольники'],
+    ['Rohatynskyi', 'Рогатинський', 'ЖК Рогатинський', 'Рогатинский', 'ЖК Рогатинский'],
+    ['Mlechnyi Shliakh', 'Млечний шлях', 'ЖК Млечний шлях', 'Млечный путь', 'ЖК Млечный путь'],
+    ['Levada', 'ЖК Левада', 'ЖК Levada', 'Levada ЖК'],
+    ['Newton 2', 'Ньютон 2', 'Ньютона 2', 'ЖК Ньютон 2', 'ЖК Ньютона 2', 'ЖК Ньютона-2', 'ЖК Newton 2'],
+    ['Saltivskyi', 'ЖК Салтівський', 'ЖК Салтовский'],
+    ['Raiduzhnyi', 'ЖК Райдужний', 'ЖК Радужный', 'ЖК Радужний', 'ЖК Райдужный', 'ЖК Радужный 1', 'ЖК Райдужний 1'],
+    ['Makiivska', 'Макіївська', 'ЖК Макіївська', 'Макеевская', 'ЖК Макеевская', 'ЖК на Макіївській', 'ЖК на Макеевской'],
+    ['River Town', 'ЖК River Town', 'Ривер Таун', 'ЖК Ривер Таун'],
+  ]),
+  landmarks: locationEntries([
+    ['Sarzhyn Yar', 'Саржин Яр', 'Саржин яр'],
+    ['Lisopark', 'Лісопарк', 'Харківський лісопарк', 'Лесопарк', 'Харьковский лесопарк'],
+    ['Machine Builders Park', 'Парк Машинобудівників', 'Парк Машиностроителей', 'парк Артема', 'парк Артёма'],
+    ['Zelenyi Hai', 'Зелений Гай', 'Зеленый Гай', 'Зелёный Гай'],
+    ['Karpivskyi Garden', 'Карпівський сад', 'Карповский сад'],
+    ['Pokrovskyi Square', 'Покровський сквер', 'Покровский сквер'],
+    ['Derzhprom', 'Держпром', 'Госпром', 'Gosprom', 'Будинок державної промисловості', 'Дом государственной промышленности'],
+    ['Pokrovskyi Monastery', 'Покровський монастир', 'Покровский монастырь'],
+    ['Kharkiv Zoo', 'Харківський зоопарк', 'Харьковский зоопарк'],
+    ['KhAI', 'ХАІ', 'ХАИ', 'Харківський авіаційний інститут', 'Харьковский авиационный институт'],
+    ['KhPI', 'ХПІ', 'ХПИ', 'Харківський політехнічний інститут', 'Харьковский политехнический институт'],
+    ['KhNURE', 'ХНУРЕ', 'ХНУРЭ', 'Харківський національний університет радіоелектроніки', 'Харьковский национальный университет радиоэлектроники'],
+    ['French Boulevard', 'Французький бульвар', 'Французский бульвар', 'ТРЦ Французький бульвар', 'ТРЦ Французский бульвар'],
+    ['Barabashovo Market', 'ринок Барабашово', 'ринок Барабашова', 'рынок Барабашово', 'Барабашово', 'Барабашова'],
+    ['Horse Market', 'Кінний ринок', 'ринок Кінний', 'Конный рынок', 'рынок Конный'],
+    ['Central Market', 'Центральний ринок', 'Центральный рынок', 'Благбаз', 'Благовіщенський базар', 'Благовещенский базар'],
+    ['Sumskyi Market', 'Сумський ринок', 'Сумской рынок', 'ТЦ Сумський ринок', 'ТЦ Сумской рынок'],
+  ]),
+});

package/src/ua-location-extensions-major.js

@@ -17,7 +17,6 @@ export const UA_MAJOR_LOCATION_EXTENSIONS = Object.freeze({
     ],
     microdistricts: [
       ['Podil','Поділ','Подол'],['Pechersk','Печерськ','Печерск'],['Lipky','Липки'],['Zvirynets','Звіринець','Зверинец'],['Chorna Hora','Чорна гора','Черная гора'],['Busove Pole','Бусово поле'],['Nova Zabudova','Нова забудова','Новое строение'],['Saperne Pole','Саперне поле','Саперное поле'],['Center','Центр','Старий Київ','Старый Киев'],['Lukianivka',"Лук'янівка",'Лукьяновка'],['Tatarka','Татарка'],['Syrets','Сирець','Сырец'],['Nyvky','Нивки'],['Shuliavka','Шулявка','КПИ','Политех'],['Solomianka',"Солом'янка",'Соломенка'],['Chokolivka','Чоколівка','Чоколовка'],['Vidradnyi','Відрадний','Отрадный'],['Karavaievi Dachi','Караваєві Дачі','Караваевы Дачи'],['Zhuliany','Жуляни','Жуляны'],['Sovky','Совки'],['Oleksandrivska Slobidka','Олександрівська Слобідка','Александровская Слободка'],['Protasiv Yar','Протасов Яр'],['Holosiiv','Голосіїв','Голосеево'],['Demiivka','Деміївка','Демеевка'],['Teremky','Теремки'],['Teremky-1','Теремки-1'],['Teremky-2','Теремки-2'],['Feofaniia','Феофанія','Феофания'],['Korchuvate','Корчувате','Корчеватое'],['Mysholovka','Мишоловка','Мышеловка'],['Vydubychi','Видубичі','Выдубичи'],['Bahrynova Hora','Багринова гора'],['Obolon','Оболонь'],['Minskyi Masyv','Мінський масив','Минский массив'],['Priorka','Пріорка','Приорка'],['Kurenivka','Куренівка','Куреневка'],['Vynohradar','Виноградар','Виноградарь'],['Vitriani Hory','Вітряні гори','Ветряные горы'],['Pushcha-Vodytsia','Пуща-Водиця','Пуща-Водица'],['Troyeshchyna','Троєщина','Троещина','Вигурівщина-Троєщина','Вигуровщина-Троещина'],['Lisovyi Masyv','Лісовий масив','Лесной массив'],['Bykivnia','Биківня','Быковня'],['Voskresenka','Воскресенка'],['Raiduzhnyi','Райдужний','Радужный'],['Mykilska Slobidka','Микільська Слобідка','Микольская Слободка'],['Rusanivka','Русанівка','Русановка'],['Berezniaky','Березняки'],['Sotsmisto','Соцмісто','Соцгород'],['Darnytsia','Дарниця','Дарница'],['Nova Darnytsia','Нова Дарниця','Новая Дарница'],['Stara Darnytsia','Стара Дарниця','Старая Дарница'],['Kharkivskyi','Харківський масив','Харьковский массив'],['Pozniaky','Позняки'],['Osokorky','Осокорки'],['Bortnychi','Бортничі','Бортничи'],['Chervonyi Khutir','Червоний Хутір','Красный Хутор'],['Rembaza','Рембаза'],['DVRZ','ДВРЗ','ДВРЗ массив'],['Sviatoshyn','Святошин','Святошино'],['Borshchahivka','Борщагівка','Борщаговка'],['Pivdenna Borshchahivka','Південна Борщагівка','Южная Борщаговка'],['Mykilska Borshchahivka','Микільська Борщагівка','Никольская Борщаговка'],['Akademmistechko','Академмістечко','Академгородок'],['Bilychi','Біличі','Беличи'],['Novobilychi','Новобіличі','Новобеличи'],
-      ['Kulynychi','Кулиничі','Кулиничи'],['524 microdistrict','524-й мікрорайон','524 микрорайон'],['North Saltivka 1','Північна Салтівка 1','Северная Салтівка 1','Северная Салтовка-1'],['North Saltivka 2','Північна Салтівка 2','Северная Салтівка 2','Северная Салтовка-2'],['North Saltivka 3','Північна Салтівка 3','Северная Салтівка 3','Северная Салтовка-3'],['North Saltivka 4','Північна Салтівка 4','Северная Салтівка 4','Северная Салтовка-4'],['North Saltivka 5','Північна Салтівка 5','Северная Салтівка 5','Северная Салтовка-5'],
     ],
     residentialComplexes: [
       ['Respublika','Respublika ЖК','Respublika Residential Complex','Respublika City','Республика','Республіка ЖК','Республика ЖК'],['French Quarter','Французький квартал','Французский квартал'],['French Quarter 2','Французький квартал 2','Французский квартал 2'],['Novopecherski Lypky','Новопечерські Липки','Новопечерские Липки'],['Taryan Towers','Taryan'],['Bulvar Fontaniv','Бульвар Фонтанів','Бульвар Фонтанов'],['Central Park'],['Greenville Park','Greenville на Печерську','Greenville на Печерске'],['Manhattan City','Manhattan'],['Chicago Central House','Chicago'],['Jack House','JackHouse'],['Skyline'],['Royal Tower'],['Signature','Signature Residence'],['Creator City','Creator','Креатор Сіті'],['UNIT.Home','Unit.Home','UNIT Home','UNIT','Юнит Хоум'],['Fayna Town','Файна Таун','Faina Town'],['Varshavskyi','Варшавський','Варшавский'],['Warszawski Plus','Варшавський Плюс','Варшавский Плюс'],['Varshavskyi 2','Варшавський 2','Варшавский 2','Варшавський Мікрорайон'],['Seven','Seven ЖК','ЖК Seven'],['RiverStone','River Stone'],['Zarichnyi','Зарічний','Заречный'],['Slavutych','Славутич'],['Slavutych 2.0'],['Great','GREAT','ЖК Great'],['Rusaniv Residence'],['Rusanivska Havan','Русанівська гавань','Русановская гавань'],['Comfort Town','Комфорт Таун'],['Nova Anhliia','Нова Англія','Новая Англия'],['ParkLand','Park Land'],['Liko-Grad','Ліко-Град','Лико-Град'],['Venice','Венеція','Венеция'],['Metropolis','Метрополіс','Метрополис'],['Kryshtalevi Dzherela','Кришталеві Джерела','Хрустальные источники'],['Lucky Land','LuckyLand'],['Dibrova Park','Діброва Парк'],['Nyvky Park','Нивки-Парк'],['White Lines','WhiteLines'],['Poetica','Поэтика'],['Greenville'],['Crystal Park'],['Crystal Park Tower'],['Smart Plaza Polytech'],['Smart Plaza Obolon'],['Obolon Residences','Obolon Residence'],['Oasis','Оазис'],['Parus','Парус'],['Podil Plaza & Residence','Podil Plaza'],['Rybalsky','Рибальський','Рыбальский','RYBALSKY'],['Dock 32','DOCK32'],['Navigator','Навигатор'],['Navigator 2','Навигатор 2'],['Ministerskyi','Міністерський','Министерский'],['Henesi House','Genesis','Henesi'],['Tetris Hall','Тетрис Холл'],
@@ -26,19 +25,19 @@ export const UA_MAJOR_LOCATION_EXTENSIONS = Object.freeze({
       ['Khreshchatyk Street','вулиця Хрещатик','улица Крещатик'],['Velyka Vasylkivska Street','Велика Васильківська','Большая Васильковская','Червоноармійська'],['Beresteiskyi Avenue','Берестейський проспект','проспект Берестейский','проспект Перемоги','проспект Победы'],['Lesi Ukrainky Boulevard','бульвар Лесі Українки','бульвар Леси Украинки'],['Saksahanskoho Street','вулиця Саксаганського','улица Саксаганского'],['Antonovycha Street','вулиця Антоновича','улица Антоновича','Горького'],['Dniprovska Naberezhna','Дніпровська набережна','Днепровская набережная'],['Mykoly Bazhana Avenue','проспект Миколи Бажана','проспект Николая Бажана'],['Hlybochytska Street','вулиця Глибочицька','улица Глубочицкая'],
     ],
     landmarks: [
-      ['Shevchenko Park','Парк Тараса Шевченка','Парк Шевченко'],['Mariinsky Park','Маріїнський парк','Мариинский парк'],['Volodymyrska Hirka','Володимирська гірка','Владимирская горка'],['Park of Eternal Glory','Парк Вічної Слави','Парк Вечной Славы','Парк Славы'],['Holosiivskyi Park','Голосіївський парк','Голосеевский парк','Парк Рильського','Парк Рыльского'],['Feofaniia Park','Феофанія','Феофания'],['Natalka Park','Парк Наталка'],['Peremoha Park','Парк Перемога','Парк Победа'],['Kyoto Park','Парк Киото','Кіото'],['Nyvky Park','Парк Нивки'],['Syretskyi Park','Сирецький парк','Сырецкий парк'],['Partisan Glory Park','Парк Партизанської слави','Парк Партизанской славы'],['Hydropark','Гідропарк','Гидропарк'],['Trukhaniv Island','Труханів острів','Труханов остров'],['Maidan Nezalezhnosti','Майдан Незалежності','Майдан Незалежности','Independence Square','Майдан','Площадь Независимости'],['Khreshchatyk','Хрещатик','Крещатик'],['Sofiiska Square','Софійська площа','Софийская площадь','Софія Київська','София Киевская'],['Mykhailivska Square','Михайлівська площа','Михайловская площадь','Михайловский Златоверхий'],['Andriyivskyy Descent','Андріївський узвіз','Андреевский спуск'],['Golden Gate','Золоті ворота','Золотые ворота'],['Kyiv-Pechersk Lavra','Києво-Печерська лавра','Киево-Печерская лавра','Kyiv Pechersk Lavra'],['Mother Ukraine','Батьківщина-Мати','Родина-Мать'],['Arch of Freedom','Арка Свободи українського народу','Арка Свободы украинского народа'],['Kontraktova Square','Контрактова площа','Контрактовая площадь'],['Poshtova Square','Поштова площа','Почтовая площадь'],['European Square','Європейська площа','Европейская площадь'],['Olimpiyskiy Stadium','НСК Олімпійський','НСК Олимпийский','Олимпийский'],['Palats Ukraina','Палац Україна','Дворец Украина'],['VDNH','ВДНХ','Експоцентр','Экспоцентр'],['Kyiv Zoo','Київський зоопарк','Киевский зоопарк'],['Gulliver','Гулливер'],['Ocean Plaza'],['Ocean Mall'],['Respublika Park'],['Dream Town','DREAM','DREAM yellow','DREAM berry'],['Blockbuster Mall'],['River Mall'],['Retroville'],['Lavina Mall'],['Caravan','Караван'],['SkyMall','Sky Mall'],['Globus','Глобус'],['TSUM Kyiv','ЦУМ Киев','ЦУМ Київ','ЦУМ'],['Bessarabskiy Market','Бессарабський ринок','Бессарабский рынок'],['Zhytnyi Market','Житній ринок','Житный рынок'],['Volodymyrskyi Market','Володимирський ринок','Владимирский рынок'],['Darnytskyi Market','Дарницький ринок','Дарницкий рынок'],['Kyiv Central Railway Station','Центральний вокзал Київ','Киевский вокзал'],
+      ['Shevchenko Park','Парк Тараса Шевченка','Парк Шевченко'],['Mariinsky Park','Маріїнський парк','Мариинский парк'],['Volodymyrska Hirka','Володимирська гірка','Владимирская горка'],['Park of Eternal Glory','Парк Вічної Слави','Парк Вечной Славы','Парк Славы'],['Holosiivskyi Park','Голосіївський парк','Голосеевский парк','Парк Рильського','Парк Рыльского'],['Feofaniia Park','Феофанія','Феофания'],['Natalka Park','Парк Наталка'],['Peremoha Park','Парк Перемога','Парк Победы'],['Kyoto Park','Парк Киото','Кіото'],['Nyvky Park','Парк Нивки'],['Syretskyi Park','Сирецький парк','Сырецкий парк'],['Partisan Glory Park','Парк Партизанської слави','Парк Партизанской славы'],['Hydropark','Гідропарк','Гидропарк'],['Trukhaniv Island','Труханів острів','Труханов остров'],['Maidan Nezalezhnosti','Майдан Незалежності','Майдан Незалежности','Independence Square','Майдан','Площадь Независимости'],['Khreshchatyk','Хрещатик','Крещатик'],['Sofiiska Square','Софійська площа','Софийская площадь','Софія Київська','София Киевская'],['Mykhailivska Square','Михайлівська площа','Михайловская площадь','Михайловский Златоверхий'],['Andriyivskyy Descent','Андріївський узвіз','Андреевский спуск'],['Golden Gate','Золоті ворота','Золотые ворота'],['Kyiv-Pechersk Lavra','Києво-Печерська лавра','Киево-Печерская лавра','Kyiv Pechersk Lavra'],['Mother Ukraine','Батьківщина-Мати','Родина-Мать'],['Arch of Freedom','Арка Свободи українського народу','Арка Свободы украинского народа'],['Kontraktova Square','Контрактова площа','Контрактовая площадь'],['Poshtova Square','Поштова площа','Почтовая площадь'],['European Square','Європейська площа','Европейская площадь'],['Olimpiyskiy Stadium','НСК Олімпійський','НСК Олимпийский','Олимпийский'],['Palats Ukraina','Палац Україна','Дворец Украина'],['VDNH','ВДНХ','Експоцентр','Экспоцентр'],['Kyiv Zoo','Київський зоопарк','Киевский зоопарк'],['Gulliver','Гулливер'],['Ocean Plaza'],['Ocean Mall'],['Respublika Park'],['Dream Town','DREAM','DREAM yellow','DREAM berry'],['Blockbuster Mall'],['River Mall'],['Retroville'],['Lavina Mall'],['Caravan','Караван'],['SkyMall','Sky Mall'],['Globus','Глобус'],['TSUM Kyiv','ЦУМ Киев','ЦУМ Київ','ЦУМ'],['Bessarabskiy Market','Бессарабський ринок','Бессарабский рынок'],['Zhytnyi Market','Житній ринок','Житный рынок'],['Volodymyrskyi Market','Володимирський ринок','Владимирский рынок'],['Darnytskyi Market','Дарницький ринок','Дарницкий рынок'],['Kyiv Central Railway Station','Центральний вокзал Київ','Киевский вокзал'],
     ],
   }),
 
   Kharkiv: city({
     streets: [
-      ['Sumska Street','вул. Сумська','вулиця Сумська','Сумська','ул. Сумская','улица Сумская','Сумская','Sumska Street','Sumska'],['Nauky Avenue','проспект Науки'],['Heroiv Kharkova Avenue','проспект Героїв Харкова','проспект Героев Харькова','Московський проспект','Московский проспект'],['Saltivske Highway','Салтівське шосе','Салтовское шоссе'],['Poltavskyi Shliakh Street','Полтавський Шлях','Полтавский Шлях'],['Klochkivska Street','вулиця Клочківська','улица Клочковская'],
+      ['Sumska Street','вул. Сумська','вулиця Сумська','Сумська','ул. Сумская','улица Сумская','Сумская','Sumska Street','Sumska'],['Nauky Avenue','проспект Науки','пр-т Науки','Nauky Ave','Prospekt Nauky'],['Heroiv Kharkova Avenue','проспект Героїв Харкова','проспект Героев Харькова','Московський проспект','Московский проспект','Heroiv Kharkova Ave','Moskovskyi Avenue','Moskovsky Prospekt'],['Saltivske Highway','Салтівське шосе','Салтовское шоссе','Салтівське ш.','Салтовское ш.'],['Poltavskyi Shliakh Street','Полтавський Шлях','Полтавский Шлях','вулиця Полтавський Шлях','улица Полтавский Шлях'],['Klochkivska Street','вулиця Клочківська','улица Клочковская','Клочківська','Клочковская','Klochkivska'],
     ],
     districts: [
       ['Shevchenkivskyi','Шевченківський','Шевченковский','Шевченківський район','Шевченковский район','Дзержинский'],['Kyivskyi','Київський','Киевский','Київський район','Киевский район'],['Saltivskyi','Салтівський','Салтовский','Салтівський район','Салтовский район','Московский'],['Nemyshlianskyi','Немишлянський','Немышлянский','Немишлянський район','Немышлянский район','Фрунзенский'],['Industrialnyi','Індустріальний','Индустриальный','Індустріальний район','Индустриальный район','Орджоникидзевский'],['Slobidskyi','Слобідський','Слободской','Слобідський район','Слободской район','Коминтерновский'],['Osnovianskyi',"Основ'янський",'Основянский','Основ’янський район','Основянский район','Червонозаводский'],['Novobavarskyi','Новобаварський','Новобаварский','Новобаварський район','Новобаварский район','Октябрьский'],['Kholodnohirskyi','Холодногірський','Холодногорский','Холодногірський район','Холодногорский район','Ленинский'],
     ],
     microdistricts: [
-      ['Saltivka','Салтівка','Салтовка'],['North Saltivka','Північна Салтівка','Северная Салтовка'],...['1','2','3','4','5'].map((n)=>[`North Saltivka-${n}`,`Северная Салтовка-${n}`]),...['520','521','522','524','531','533','602','603','604','605','606','607','608','616','625','626','627','656'].map((n)=>[`${n} microdistrict`,`${n} микрорайон`]),['535A','535А'],['Pavlove Pole','Павлове Поле','Павлово Поле'],['Oleksiivka','Олексіївка','Алексеевка','Alexeyevka','Алексеевская'],['Botanical Garden','Ботанический сад','Ботсад'],['Shatylivka','Шатилівка','Шатиловка'],['Derzhprom','Держпром','Госпром'],['Center','Центр','Нагірний','Нагорный'],['Zhuravlivka','Журавлівка','Журавлевка'],['Velyka Danylivka','Велика Данилівка','Большая Даниловка'],['Piatykhatky',"П'ятихатки",'Пятихатки'],['Pomerky','Померки'],['Sokolnyky','Сокольники'],['Karavan','Караван'],['Heroiv Pratsi','Героїв Праці','Героев Труда'],['Studentska','Студентська','Студенческая'],['Barabashovo','Барабашово','Барабашова'],['Akademika Pavlova','Академіка Павлова','Академика Павлова'],['HTZ','ХТЗ'],['Novi Budynky','Нові Будинки','Новые Дома'],['23 Serpnia','23 Серпня','23 Августа'],['Kholodna Hora','Холодна Гора','Холодная Гора'],['Pivdennyi Vokzal','Південний вокзал','Южный вокзал'],['Zaliutyne','Залютине','Залютино'],['Nova Bavariia','Нова Баварія','Новая Бавария','Баварія','Бавария'],['Moskalevka','Москалівка','Москалевка'],['Osnova','Основа'],['Odeska','Одеська','Одесская'],['Haharina','Гагарина'],['Levada','Левада'],['Sportyvna','Спортивна','Спортивная'],['Metalist','Металіст','Металлист'],['Zakhysnykiv Ukrainy','Захисників України','Защитников Украины'],['Rohan','Рогань','Роганский жилмассив'],['Horizont','Горизонт'],['Skhidnyi','Східний','Восточный'],['Industrialna','Індустріальна','Индустриальная'],['Zhykhar','Жихор'],
+      ['Saltivka','Салтівка','Салтовка','Салтівський масив','Салтовский жилмассив'],['North Saltivka','Північна Салтівка','Северная Салтовка','Северная Салтівка'],...['1','2','3','4','5'].map((n)=>[`North Saltivka-${n}`,`Північна Салтівка ${n}`,`Північна Салтівка-${n}`,`Северная Салтовка ${n}`,`Северная Салтовка-${n}`,`Северная Салтівка ${n}`,`Северная Салтівка-${n}`]),...['520','521','522','524','531','533','602','603','604','605','606','607','608','616','625','626','627','656'].map((n)=>[`${n} microdistrict`,`${n}-й мікрорайон`,`${n} мікрорайон`,`${n}-й микрорайон`,`${n} микрорайон`]),['535A','535А','535а','535A microdistrict','535А мікрорайон','535а мікрорайон','535А микрорайон','535а микрорайон','Мікрорайон 535а','Микрорайон 535а'],['Kulynychi','Кулиничі','Кулиничи'],['Pavlove Pole','Павлове Поле','Павлово Поле'],['Oleksiivka','Олексіївка','Алексеевка','Alexeyevka','Алексеевская'],['Botanical Garden','Ботанічний сад','Ботанический сад','Ботсад'],['Shatylivka','Шатилівка','Шатиловка'],['Derzhprom','Держпром','Госпром'],['Center','Центр','Нагірний','Нагорный'],['Zhuravlivka','Журавлівка','Журавлевка'],['Velyka Danylivka','Велика Данилівка','Большая Даниловка'],['Piatykhatky',"П'ятихатки",'П’ятихатки','Пятихатки'],['Pomerky','Померки'],['Sokolnyky','Сокільники','Сокольники'],['Karavan','Караван'],['Heroiv Pratsi','Героїв Праці','Героев Труда'],['Studentska','Студентська','Студенческая'],['Barabashovo','Барабашово','Барабашова'],['Akademika Pavlova','Академіка Павлова','Академика Павлова'],['HTZ','ХТЗ'],['Novi Budynky','Нові Будинки','Новые Дома'],['23 Serpnia','23 Серпня','23 Августа'],['Kholodna Hora','Холодна Гора','Холодная Гора'],['Pivdennyi Vokzal','Південний вокзал','Южный вокзал'],['Zaliutyne','Залютине','Залютино'],['Nova Bavariia','Нова Баварія','Новая Бавария','Баварія','Бавария'],['Moskalevka','Москалівка','Москалевка'],['Osnova','Основа'],['Odeska','Одеська','Одесская'],['Haharina','Гагаріна','Гагарина'],['Levada','Левада'],['Sportyvna','Спортивна','Спортивная'],['Metalist','Металіст','Металлист'],['Zakhysnykiv Ukrainy','Захисників України','Защитников Украины'],['Rohan','Рогань','Роганский жилмассив'],['Horizont','Горизонт'],['Skhidnyi','Східний','Восточный'],['Industrialna','Індустріальна','Индустриальная'],['Zhykhar','Жихор'],
     ],
     residentialComplexes: [
       ['Pavlovsky Kvartal','Павлівський квартал','Павловский квартал'],['Kliuch','ЖК Ключ'],['Dim na Sumskii','Будинок на Сумській','ЖК Дом на Сумской'],['Myronosytska','ЖК Мироносицька','ЖК Мироносицкая'],['Rezidentsiia','Резиденція','Резиденция'],['Felicita','Феліціта','Феличита'],['Nimeckyi Proekt','Німецький проект','Немецкий проект'],['Hydropark','ЖК Гідропарк','ЖК Гидропарк'],['Sokolnyky','ЖК Сокільники','ЖК Сокольники'],['Flagman','ЖК Флагман'],['Ovis','ЖК Овис'],['Oasis','ЖК Оазис'],['Mlechnyi Shliakh','ЖК Млечний шлях','ЖК Млечный путь'],['Levada','ЖК Левада'],['Levada 2','ЖК Левада 2'],['Rohatynskyi','ЖК Рогатинський','ЖК Рогатинский'],['Rohatynskyi Kvartal','ЖК Рогатинський квартал','ЖК Рогатинский квартал'],['Kvant','ЖК Квант'],['Crystal','ЖК Кристал','ЖК Кристалл'],['Vorobiovi Hory','ЖК Воробьевы горы','ЖК Воробьёвы Горы','Воробйові гори','Воробьевы горы'],['Vorobiovi Hory Family','ЖК Воробьевы Горы Family'],['Ptashka','ЖК Пташка','ЖК Птичка'],['Saltivskyi','ЖК Салтівський','ЖК Салтовский'],['Meridian','ЖК Меридіан','ЖК Меридиан'],['Raiduzhnyi','ЖК Райдужний','ЖК Радужный'],['Newton','ЖК Ньютона'],['Newton 2','ЖК Ньютона 2'],['Makiivska','ЖК Макіївська','ЖК Макеевская'],['Kazka','ЖК Казка','ЖК Сказка'],['Manhattan','ЖК Манхеттен'],['River Town','Ривер Таун'],['Mira','ЖК Миру','ЖК Мира'],
@@ -128,4 +127,4 @@ export const UA_MAJOR_LOCATION_EXTENSIONS = Object.freeze({
       ['95 Kvartal','95 квартал'],['Liberation Square','площа Визволення','площадь Освобождения'],['Heroes Park','парк Героїв','парк Героев'],['Flower Clock','Квітковий годинник','Цветочные часы'],['Mershavtsev Park','парк Мершавцева'],['Haharina Park','парк Гагаріна','парк Гагарина'],['Boat Station','човнова станція','лодочная станция'],['Metalurh Stadium','стадіон Металург','стадион Металлург'],['Kryvyi Rih Botanical Garden','Криворізький ботанічний сад','Криворожский ботанический сад'],
     ],
   }),
-});
+});

package/src/ua-location-extensions-metro.js

@@ -1,4 +1,5 @@
 import { locationEntries } from './location-merge.js';
+import { UA_KHARKIV_LOCATION_TRANSLATIONS } from './ua-kharkiv-location-translations.js';
 
 export const UA_METRO_LOCATION_EXTENSIONS = Object.freeze({
   Kyiv: Object.freeze({
@@ -18,6 +19,22 @@ export const UA_METRO_LOCATION_EXTENSIONS = Object.freeze({
     ]),
   }),
   Kharkiv: Object.freeze({
+    ...UA_KHARKIV_LOCATION_TRANSLATIONS,
+    // This extension is merged after the legacy UA seeds. Keep late verified
+    // Kharkiv quarter canonicals here so they cannot be shadowed by old seed
+    // vocabulary while the broader Kharkiv location layer is being expanded.
+    microdistricts: locationEntries([
+      ...['455','519','601','614','615','624'].map((n) => [
+        `${n} microdistrict`,
+        `${n}-й мікрорайон`, `${n} мікрорайон`, `Мікрорайон ${n}`,
+        `${n}-й микрорайон`, `${n} микрорайон`, `Микрорайон ${n}`,
+      ]),
+      ['606A',
+        '606А', '606а', '606A microdistrict',
+        '606А мікрорайон', '606а мікрорайон', 'Мікрорайон 606А', 'Мікрорайон 606а',
+        '606А микрорайон', '606а микрорайон', 'Микрорайон 606А', 'Микрорайон 606а',
+      ],
+    ]),
     metro: locationEntries([
       ['Kholodna Hora', 'Холодна гора', 'Холодная гора'],
       ['Vokzalna', 'Вокзальна', 'Вокзальная', 'Південний вокзал', 'Южный вокзал'],