pyunislavic 0.1.0__tar.gz

pyunislavic-0.1.0/.gitignore

@@ -0,0 +1,25 @@
+# macOS
+.DS_Store
+
+# Python bytecode
+__pycache__/
+*.py[cod]
+
+# Build artifacts
+build/
+dist/
+*.egg-info/
+
+# Test and coverage artifacts
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# IDE settings
+.idea/
+.vscode/

pyunislavic-0.1.0/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Zijie ZHANG
+Copyright (c) 2021 Medžuslovjansky (Меджусловјанскы)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pyunislavic-0.1.0/PKG-INFO

@@ -0,0 +1,446 @@
+Metadata-Version: 2.4
+Name: pyunislavic
+Version: 0.1.0
+Summary: A Python implementation for transliterating and normalizing text from many Slavic languages and Interslavic into unified writing systems.
+Author: Zijie ZHANG
+License-Expression: MIT
+License-File: LICENSE
+Keywords: cyrillic,cyrillization,interslavic,latin,normalization,orthography,romanization,slavic,transliteration
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Text Processing :: Linguistic
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# PyUniSlavic
+
+A Python implementation for transliterating and normalizing text from many
+Slavic languages and Interslavic into unified writing systems.
+
+PyUniSlavic converts text written with a broad range of Latin and Cyrillic
+letters used across Slavic orthographies into a selected common Latin,
+ASCII-oriented, or Cyrillic representation. It preserves the source words,
+grammar, and meaning: it is a writing-system converter, not a machine
+translator.
+
+The package is an independent, focused Python port of part of the
+transliteration logic in
+[`@interslavic/utils`](https://github.com/medzuslovjansky/js-utils). The
+upstream algorithm was created for Interslavic transliteration. PyUniSlavic
+also uses its permissive input normalization as a practical common writing
+layer for text in multiple Slavic languages.
+
+This broader use follows from the design of
+[Interslavic orthography](https://interslavic.fun/learn/orthography/) itself.
+Its standard Latin and Cyrillic alphabets are cross-Slavic compromises rather
+than adaptations of any one national orthography, and they were designed to be
+intuitively understandable and easy to transliterate between. Its optional
+etymological letters represent shared historical phonemes whose developments
+in modern Slavic languages are largely predictable. The official orthography
+guide therefore explicitly identifies transcription from any Slavic language
+into Interslavic orthography as one possible use of this etymological layer.
+It illustrates the principle with `pęť`: one shared etymological form that
+relates several divergent national spellings of the same inherited word.
+
+The
+[upstream implementation](https://github.com/medzuslovjansky/js-utils/blob/main/src/transliterate/transliterate.ts)
+turns that cross-Slavic design into a reusable pipeline: its loose preprocessor
+maps many Latin and Cyrillic letter variants, historical characters, and
+alternative spellings into a common internal representation; the flavor stage
+then preserves or merges selected distinctions before the result is rendered
+in the requested output orthography. PyUniSlavic reuses this orthographic
+pipeline without changing the source vocabulary or grammar. In this way, a
+mechanism created for Interslavic transliteration can also provide practical
+cross-Slavic script unification and same-script normalization. This remains
+orthographic normalization rather than translation, and it does not claim
+exact language-specific phonological conversion for every Slavic language.
+
+PyUniSlavic is not an official Interslavic implementation and is not affiliated
+with or endorsed by the Interslavic project.
+
+## Features
+
+- Transliterates between common Latin and Cyrillic representations.
+- Normalizes Latin text to a shared Latin orthography.
+- Normalizes Cyrillic text to a shared Cyrillic orthography.
+- Accepts many modern, historical, and alternative Latin and Cyrillic letters
+  recognized by the upstream loose-input normalizer.
+- Provides etymological, standard, and simplified output profiles.
+- Preserves punctuation, numbers, spacing, and basic capitalization patterns.
+- Uses only the Python standard library.
+- Does not translate, lemmatize, or alter the grammar of the source language.
+
+## Installation
+
+```bash
+pip install pyunislavic
+```
+
+## Quick start
+
+```python
+from pyunislavic import transliterate
+
+result = transliterate(
+    "Меджусловјанскы језык",
+    type=1,
+    flav=2,
+)
+
+print(result)
+# Medžuslovjansky jezyk
+```
+
+The public function is:
+
+```python
+transliterate(i_source: str, type: int, flav: int = 2) -> str
+```
+
+## Supported output types
+
+| `type` | Name | Output |
+| ---: | --- | --- |
+| `1` | Latin | Common Latin orthography with diacritics |
+| `2` | ASCII-oriented | Digraph-based Latin output such as `sz`, `cz`, and `zs` |
+| `5` | Standard Cyrillic | Common Cyrillic orthography using letters such as `ј`, `љ`, and `њ` |
+
+`type=2` follows the behavior and naming of the upstream `ASCII` mode. With
+`flav=2`, some supported soft-consonant letters can remain non-ASCII, so this
+mode should be understood as ASCII-oriented rather than an unconditional
+7-bit ASCII guarantee.
+
+## Supported flavor profiles
+
+| `flav` | Name | Behavior |
+| ---: | --- | --- |
+| `2` | Etymological | Preserves the greatest number of distinctions supported by this port |
+| `3` | Standard | Merges several historical vowels and soft-consonant distinctions |
+| `4` | Slovianto | Applies additional simplification, including `ě → e` and `y → i` |
+
+Every supported output type can be combined with every supported flavor, for a
+total of nine combinations:
+
+```text
+type = 1, 2, or 5
+flav = 2, 3, or 4
+```
+
+Unsupported values raise `ValueError`.
+
+Enums are also available:
+
+```python
+from enum import IntEnum
+
+
+class TransliterationType(IntEnum):
+    LATIN = 1
+    ASCII = 2
+    STANDARD_CYRILLIC = 5
+
+
+class FlavorizationType(IntEnum):
+    ETYMOLOGICAL = 2
+    STANDARD = 3
+    SLOVIANTO = 4
+```
+
+They can be imported and passed directly to `transliterate`:
+
+```python
+from pyunislavic import (
+    FlavorizationType,
+    TransliterationType,
+    transliterate,
+)
+
+result = transliterate(
+    "Medžuslovjansky jezyk",
+    type=TransliterationType.STANDARD_CYRILLIC,
+    flav=FlavorizationType.STANDARD,
+)
+
+print(result)
+# Меджусловјанскы језык
+```
+
+## Same-script normalization
+
+The source and output scripts do not have to be different. Latin input can be
+normalized to the selected common Latin profile, and Cyrillic input can be
+normalized to the selected common Cyrillic profile.
+
+### Latin input
+
+```python
+transliterate(
+    "Nawet przy założeniu",
+    type=1,
+    flav=2,
+)
+# 'Navet przy založeniu'
+```
+
+### Cyrillic input
+
+```python
+transliterate(
+    "Улаштовуватимуть водопровідний вузол",
+    type=5,
+    flav=2,
+)
+# 'Улаштовуватимуть водопровидниј вузол'
+```
+
+These examples retain Polish and Ukrainian vocabulary and grammar. Only their
+orthographic representation is normalized.
+
+## Extended real-language examples
+
+The following examples were produced by the current implementation from text
+in several Slavic languages. Language labels use ISO 639-3 codes. They show
+orthographic conversion and normalization as implemented by the upstream-derived
+pipeline; they are not translations or claims about official national spelling.
+
+### Latin etymological output (`type=1`, `flav=2`)
+
+#### Belarusian (`bel`)
+
+```text
+INPUT
+Той жа Юры Чыж рабіў свой бізнэс па «паняцьцях», дзякуючы блізкасьці да «цела» меў прывілеі, атрымліваў вольны доступ у прыбытковыя сфэры, куды пускалі толькі абраных, напрыклад, у гандаль нафтапрадуктамі.
+
+OUTPUT
+Toj ža Jury Čiž rabiv svoj biznes pa «panjacjcjah», dźakujuči blizkaści da «cela» mev pryvilei, atrymlivav voĺny dostup u prybytkovyja sfery, kudy puskali toĺki abranyh, napryklad, u gandaĺ naftapraduktami.
+```
+
+#### Russian (`rus`)
+
+```text
+INPUT
+В боях за Дубно 14 февраля 1944 года молодой фотокорреспондент находился в боевых порядках 29-го гвардейского кавалерийского полка, оказавшегося в эпицентре сражения за город.
+
+OUTPUT
+V bojah za Dubno 14 fevralja 1944 goda molodoj fotokorrespondent nahodilśa v boevyh poŕadkah 29-go gvardejskogo kavalerijskogo polka, okazavšegośa v epicentre sraženija za gorod.
+```
+
+#### Ukrainian (`ukr`)
+
+```text
+INPUT
+"Улаштовуватимуть водопровідний вузол на водоводі діаметром 900 мм на розі вул. Зеленогірської та вул. Петра Радченка", — йдеться у повідомленні.
+
+OUTPUT
+"Ulaštovuvatimut́ vodoprovidnij vuzol na vodovodi diametrom 900 mm na rozi vul. Zelenogirśkoji ta vul. Petra Radčenka", — jdet́śa u povidomlenni.
+```
+
+#### Rusyn (`rue`)
+
+```text
+INPUT
+Ключі організовано за дихотомічною системою і представлено у вигляді основного ключа до родин і 10 ключів до родів і видів кожної родини (кротові, мідицеві, вовчкові, мишівкові, тушканові, сліпакові, мишачі, хом'якові, норицеві).
+
+OUTPUT
+Ključi organizovano za dihotomičnoju sistemoju i predstavleno u vigljadi osnovnogo ključa do rodin i 10 ključiv do rodiv i vidiv kožnoji rodini (krotovi, midicevi, vovčkovi, mišivkovi, tuškanovi, slipakovi, mišači, hom'jakovi, noricevi).
+```
+
+#### Serbian (`srp`)
+
+```text
+INPUT
+Бугари су имали 7.000 погинулих 6.000 заробљених војника и 130 топова а Грци су имали 8.700 погинулих.
+
+OUTPUT
+Bugari su imali 7.000 poginulih 6.000 zarobljenih vojnika i 130 topova a Grci su imali 8.700 poginulih.
+```
+
+### Cyrillic etymological output (`type=5`, `flav=2`)
+
+#### Slovak (`slk`)
+
+```text
+INPUT
+Pridať do obľúbenýchProdukt si uložíte medzi vami zvolené obľúbené položky a môžete si ho tak rýchlo nájsť Drevený vozík na kolieskach obsahuje 24 farebných drevených kociek v rôznych tvaroch.
+
+OUTPUT
+Придать до обльубеныхпродукт си уложите медзи вами зволене обльубене положкы а можете си хо так рыхло најсть Древены возик на колиесках обсахује 24 фаребных древеных коциек в розных тварох.
+```
+
+#### Polish (`pol`)
+
+```text
+INPUT
+Pytałem o Olsztyn, a oni wypowiadali się o mieście w samych superlatywach, twierdząc m.in., że szczególnie latem jest tu pięknie.
+
+OUTPUT
+Пыталем о Олштын, а они выповиадали сиѧ о миесьцие в самых суперлатывах, твиердзѫц м.ин., же шчеголние латем јест ту пиѧкние.
+```
+
+#### Czech (`ces`)
+
+```text
+INPUT
+Trojice slonů afrických v Zoo Dvůr Králové nad Labem na Trutnovsku si dnes pochutnala na vánoční nadílce, v níž bylo i několik vánočních stromků.
+
+OUTPUT
+Тројице слону африцкых в Зоо Двур Кралове над Лабем на Трутновску си днес похутнала на ваночни надилце, в ниж было и нѣколик ваночних стромку.
+```
+
+### Latin standard output (`type=1`, `flav=3`)
+
+#### Polish (`pol`)
+
+```text
+INPUT
+Pytałem o Olsztyn, a oni wypowiadali się o mieście w samych superlatywach, twierdząc m.in., że szczególnie latem jest tu pięknie.
+
+OUTPUT
+Pytalem o Olštyn, a oni vypoviadali sie o miescie v samyh superlatyvah, tvierdzuc m.in., že ščegolnie latem jest tu pieknie.
+```
+
+### ASCII-oriented standard output (`type=2`, `flav=3`)
+
+#### Czech (`ces`)
+
+```text
+INPUT
+Trojice slonů afrických v Zoo Dvůr Králové nad Labem na Trutnovsku si dnes pochutnala na vánoční nadílce, v níž bylo i několik vánočních stromků.
+
+OUTPUT
+Trojice slonu africkyh v Zoo Dvur Kralove nad Labem na Trutnovsku si dnes pohutnala na vanoczni nadilce, v nizs bylo i njekolik vanocznih stromku.
+```
+
+### Cyrillic standard output (`type=5`, `flav=3`)
+
+#### Belarusian (`bel`)
+
+```text
+INPUT
+Той жа Юры Чыж рабіў свой бізнэс па «паняцьцях», дзякуючы блізкасьці да «цела» меў прывілеі, атрымліваў вольны доступ у прыбытковыя сфэры, куды пускалі толькі абраных, напрыклад, у гандаль нафтапрадуктамі.
+
+OUTPUT
+Тој жа Јуры Чиж рабив свој бизнес па «пањацјцјах», дзакујучи близкасци да «цела» мев прывилеи, атрымливав волны доступ у прыбытковыја сферы, куды пускали толки абраных, напрыклад, у гандал нафтапрадуктами.
+```
+
+#### Russian (`rus`)
+
+```text
+INPUT
+В боях за Дубно 14 февраля 1944 года молодой фотокорреспондент находился в боевых порядках 29-го гвардейского кавалерийского полка, оказавшегося в эпицентре сражения за город.
+
+OUTPUT
+В бојах за Дубно 14 февраља 1944 года молодој фотокорреспондент находилса в боевых порадках 29-го гвардејского кавалеријского полка, оказавшегоса в епицентре сраженија за город.
+```
+
+#### Ukrainian (`ukr`)
+
+```text
+INPUT
+"Улаштовуватимуть водопровідний вузол на водоводі діаметром 900 мм на розі вул. Зеленогірської та вул. Петра Радченка", — йдеться у повідомленні.
+
+OUTPUT
+"Улаштовуватимут водопровидниј вузол на водоводи диаметром 900 мм на рози вул. Зеленогирскоји та вул. Петра Радченка", — јдетса у повидомленни.
+```
+
+#### Rusyn (`rue`)
+
+```text
+INPUT
+Ключі організовано за дихотомічною системою і представлено у вигляді основного ключа до родин і 10 ключів до родів і видів кожної родини (кротові, мідицеві, вовчкові, мишівкові, тушканові, сліпакові, мишачі, хом'якові, норицеві).
+
+OUTPUT
+Кључи организовано за дихотомичноју системоју и представлено у вигљади основного кључа до родин и 10 кључив до родив и видив кожноји родини (кротови, мидицеви, вовчкови, мишивкови, тушканови, слипакови, мишачи, хом'јакови, норицеви).
+```
+
+#### Slovak (`slk`)
+
+```text
+INPUT
+Pridať do obľúbenýchProdukt si uložíte medzi vami zvolené obľúbené položky a môžete si ho tak rýchlo nájsť Drevený vozík na kolieskach obsahuje 24 farebných drevených kociek v rôznych tvaroch.
+
+OUTPUT
+Придат до облубеныхпродукт си уложите медзи вами зволене облубене положкы а можете си хо так рыхло најст Древены возик на колиесках обсахује 24 фаребных древеных коциек в розных тварох.
+```
+
+## Choosing a flavor
+
+Use `flav=2` when retaining soft consonants and etymological distinctions is
+more important than minimizing the character inventory.
+
+Use `flav=3` for a more neutral and compact common orthography. For example,
+some soft-sign distinctions retained by `flav=2` are removed by `flav=3`.
+
+Use `flav=4` when maximum simplification is preferred and the additional loss
+of orthographic distinctions is acceptable.
+
+## Input processing
+
+This focused port always uses the upstream loose-input preprocessing path. It:
+
+1. normalizes input to Unicode NFC;
+2. processes continuous sequences of Unicode letters and combining marks;
+3. converts recognized Latin and Cyrillic variants to an internal common form;
+4. applies the selected flavor profile;
+5. renders the selected output type; and
+6. restores lowercase, title-style, or uppercase word casing.
+
+Punctuation, whitespace, digits, and other non-letter characters are preserved.
+
+## Scope and limitations
+
+PyUniSlavic provides a common orthographic representation, not a normative
+spelling standard for every living Slavic language.
+
+The loose-input rules were designed primarily to accept varied Interslavic
+input. Their broad character coverage is useful for other Slavic languages,
+but the normalizer is not a complete language-specific phonological analyzer.
+For example:
+
+- Polish combinations such as `rz` or `dzi` are not always interpreted as a
+  single language-specific sound.
+- Some Ukrainian distinctions, including certain uses of `і/и` and `г/ґ`, can
+  be merged by normalization.
+- Etymological and standard profiles intentionally merge different sets of
+  letters, so conversion is not guaranteed to be reversible.
+- Mixed or camel-case capitalization is reduced to lowercase, title-style, or
+  uppercase at the word level, matching the upstream behavior.
+
+Applications that require exact source-language phonology should add a
+language-specific input adapter before calling `transliterate`.
+
+## Compatibility testing
+
+The initial Python port was checked against the upstream TypeScript behavior
+for all nine supported parameter combinations. The parity suite included 144
+targeted cases and 4,500 deterministic randomized Unicode cases, with identical
+outputs for the tested inputs.
+
+## Upstream project and attribution
+
+The core transliteration and loose-normalization rules are adapted from:
+
+- [`medzuslovjansky/js-utils`](https://github.com/medzuslovjansky/js-utils)
+- [`src/transliterate/transliterate.ts`](https://github.com/medzuslovjansky/js-utils/blob/main/src/transliterate/transliterate.ts)
+- [Interslavic](https://interslavic.fun/)
+
+The upstream project describes `@interslavic/utils` as a collection of
+JavaScript utilities for the Interslavic language, including transliteration.
+
+The upstream source is distributed under the MIT License:
+
+> Copyright (c) 2021 Medžuslovjansky (Меджусловјанскы)
+
+Any distribution of this derived port must include the upstream copyright and
+MIT permission notice. See the
+[`@interslavic/utils` license](https://github.com/medzuslovjansky/js-utils/blob/main/LICENSE)
+for the complete text.
+
+## Project status
+
+PyUniSlavic currently implements only the nine combinations documented above.
+Other upstream output modes and flavor profiles are intentionally outside the
+scope of this focused port.

pyunislavic-0.1.0/README.md

@@ -0,0 +1,429 @@
+# PyUniSlavic
+
+A Python implementation for transliterating and normalizing text from many
+Slavic languages and Interslavic into unified writing systems.
+
+PyUniSlavic converts text written with a broad range of Latin and Cyrillic
+letters used across Slavic orthographies into a selected common Latin,
+ASCII-oriented, or Cyrillic representation. It preserves the source words,
+grammar, and meaning: it is a writing-system converter, not a machine
+translator.
+
+The package is an independent, focused Python port of part of the
+transliteration logic in
+[`@interslavic/utils`](https://github.com/medzuslovjansky/js-utils). The
+upstream algorithm was created for Interslavic transliteration. PyUniSlavic
+also uses its permissive input normalization as a practical common writing
+layer for text in multiple Slavic languages.
+
+This broader use follows from the design of
+[Interslavic orthography](https://interslavic.fun/learn/orthography/) itself.
+Its standard Latin and Cyrillic alphabets are cross-Slavic compromises rather
+than adaptations of any one national orthography, and they were designed to be
+intuitively understandable and easy to transliterate between. Its optional
+etymological letters represent shared historical phonemes whose developments
+in modern Slavic languages are largely predictable. The official orthography
+guide therefore explicitly identifies transcription from any Slavic language
+into Interslavic orthography as one possible use of this etymological layer.
+It illustrates the principle with `pęť`: one shared etymological form that
+relates several divergent national spellings of the same inherited word.
+
+The
+[upstream implementation](https://github.com/medzuslovjansky/js-utils/blob/main/src/transliterate/transliterate.ts)
+turns that cross-Slavic design into a reusable pipeline: its loose preprocessor
+maps many Latin and Cyrillic letter variants, historical characters, and
+alternative spellings into a common internal representation; the flavor stage
+then preserves or merges selected distinctions before the result is rendered
+in the requested output orthography. PyUniSlavic reuses this orthographic
+pipeline without changing the source vocabulary or grammar. In this way, a
+mechanism created for Interslavic transliteration can also provide practical
+cross-Slavic script unification and same-script normalization. This remains
+orthographic normalization rather than translation, and it does not claim
+exact language-specific phonological conversion for every Slavic language.
+
+PyUniSlavic is not an official Interslavic implementation and is not affiliated
+with or endorsed by the Interslavic project.
+
+## Features
+
+- Transliterates between common Latin and Cyrillic representations.
+- Normalizes Latin text to a shared Latin orthography.
+- Normalizes Cyrillic text to a shared Cyrillic orthography.
+- Accepts many modern, historical, and alternative Latin and Cyrillic letters
+  recognized by the upstream loose-input normalizer.
+- Provides etymological, standard, and simplified output profiles.
+- Preserves punctuation, numbers, spacing, and basic capitalization patterns.
+- Uses only the Python standard library.
+- Does not translate, lemmatize, or alter the grammar of the source language.
+
+## Installation
+
+```bash
+pip install pyunislavic
+```
+
+## Quick start
+
+```python
+from pyunislavic import transliterate
+
+result = transliterate(
+    "Меджусловјанскы језык",
+    type=1,
+    flav=2,
+)
+
+print(result)
+# Medžuslovjansky jezyk
+```
+
+The public function is:
+
+```python
+transliterate(i_source: str, type: int, flav: int = 2) -> str
+```
+
+## Supported output types
+
+| `type` | Name | Output |
+| ---: | --- | --- |
+| `1` | Latin | Common Latin orthography with diacritics |
+| `2` | ASCII-oriented | Digraph-based Latin output such as `sz`, `cz`, and `zs` |
+| `5` | Standard Cyrillic | Common Cyrillic orthography using letters such as `ј`, `љ`, and `њ` |
+
+`type=2` follows the behavior and naming of the upstream `ASCII` mode. With
+`flav=2`, some supported soft-consonant letters can remain non-ASCII, so this
+mode should be understood as ASCII-oriented rather than an unconditional
+7-bit ASCII guarantee.
+
+## Supported flavor profiles
+
+| `flav` | Name | Behavior |
+| ---: | --- | --- |
+| `2` | Etymological | Preserves the greatest number of distinctions supported by this port |
+| `3` | Standard | Merges several historical vowels and soft-consonant distinctions |
+| `4` | Slovianto | Applies additional simplification, including `ě → e` and `y → i` |
+
+Every supported output type can be combined with every supported flavor, for a
+total of nine combinations:
+
+```text
+type = 1, 2, or 5
+flav = 2, 3, or 4
+```
+
+Unsupported values raise `ValueError`.
+
+Enums are also available:
+
+```python
+from enum import IntEnum
+
+
+class TransliterationType(IntEnum):
+    LATIN = 1
+    ASCII = 2
+    STANDARD_CYRILLIC = 5
+
+
+class FlavorizationType(IntEnum):
+    ETYMOLOGICAL = 2
+    STANDARD = 3
+    SLOVIANTO = 4
+```
+
+They can be imported and passed directly to `transliterate`:
+
+```python
+from pyunislavic import (
+    FlavorizationType,
+    TransliterationType,
+    transliterate,
+)
+
+result = transliterate(
+    "Medžuslovjansky jezyk",
+    type=TransliterationType.STANDARD_CYRILLIC,
+    flav=FlavorizationType.STANDARD,
+)
+
+print(result)
+# Меджусловјанскы језык
+```
+
+## Same-script normalization
+
+The source and output scripts do not have to be different. Latin input can be
+normalized to the selected common Latin profile, and Cyrillic input can be
+normalized to the selected common Cyrillic profile.
+
+### Latin input
+
+```python
+transliterate(
+    "Nawet przy założeniu",
+    type=1,
+    flav=2,
+)
+# 'Navet przy založeniu'
+```
+
+### Cyrillic input
+
+```python
+transliterate(
+    "Улаштовуватимуть водопровідний вузол",
+    type=5,
+    flav=2,
+)
+# 'Улаштовуватимуть водопровидниј вузол'
+```
+
+These examples retain Polish and Ukrainian vocabulary and grammar. Only their
+orthographic representation is normalized.
+
+## Extended real-language examples
+
+The following examples were produced by the current implementation from text
+in several Slavic languages. Language labels use ISO 639-3 codes. They show
+orthographic conversion and normalization as implemented by the upstream-derived
+pipeline; they are not translations or claims about official national spelling.
+
+### Latin etymological output (`type=1`, `flav=2`)
+
+#### Belarusian (`bel`)
+
+```text
+INPUT
+Той жа Юры Чыж рабіў свой бізнэс па «паняцьцях», дзякуючы блізкасьці да «цела» меў прывілеі, атрымліваў вольны доступ у прыбытковыя сфэры, куды пускалі толькі абраных, напрыклад, у гандаль нафтапрадуктамі.
+
+OUTPUT
+Toj ža Jury Čiž rabiv svoj biznes pa «panjacjcjah», dźakujuči blizkaści da «cela» mev pryvilei, atrymlivav voĺny dostup u prybytkovyja sfery, kudy puskali toĺki abranyh, napryklad, u gandaĺ naftapraduktami.
+```
+
+#### Russian (`rus`)
+
+```text
+INPUT
+В боях за Дубно 14 февраля 1944 года молодой фотокорреспондент находился в боевых порядках 29-го гвардейского кавалерийского полка, оказавшегося в эпицентре сражения за город.
+
+OUTPUT
+V bojah za Dubno 14 fevralja 1944 goda molodoj fotokorrespondent nahodilśa v boevyh poŕadkah 29-go gvardejskogo kavalerijskogo polka, okazavšegośa v epicentre sraženija za gorod.
+```
+
+#### Ukrainian (`ukr`)
+
+```text
+INPUT
+"Улаштовуватимуть водопровідний вузол на водоводі діаметром 900 мм на розі вул. Зеленогірської та вул. Петра Радченка", — йдеться у повідомленні.
+
+OUTPUT
+"Ulaštovuvatimut́ vodoprovidnij vuzol na vodovodi diametrom 900 mm na rozi vul. Zelenogirśkoji ta vul. Petra Radčenka", — jdet́śa u povidomlenni.
+```
+
+#### Rusyn (`rue`)
+
+```text
+INPUT
+Ключі організовано за дихотомічною системою і представлено у вигляді основного ключа до родин і 10 ключів до родів і видів кожної родини (кротові, мідицеві, вовчкові, мишівкові, тушканові, сліпакові, мишачі, хом'якові, норицеві).
+
+OUTPUT
+Ključi organizovano za dihotomičnoju sistemoju i predstavleno u vigljadi osnovnogo ključa do rodin i 10 ključiv do rodiv i vidiv kožnoji rodini (krotovi, midicevi, vovčkovi, mišivkovi, tuškanovi, slipakovi, mišači, hom'jakovi, noricevi).
+```
+
+#### Serbian (`srp`)
+
+```text
+INPUT
+Бугари су имали 7.000 погинулих 6.000 заробљених војника и 130 топова а Грци су имали 8.700 погинулих.
+
+OUTPUT
+Bugari su imali 7.000 poginulih 6.000 zarobljenih vojnika i 130 topova a Grci su imali 8.700 poginulih.
+```
+
+### Cyrillic etymological output (`type=5`, `flav=2`)
+
+#### Slovak (`slk`)
+
+```text
+INPUT
+Pridať do obľúbenýchProdukt si uložíte medzi vami zvolené obľúbené položky a môžete si ho tak rýchlo nájsť Drevený vozík na kolieskach obsahuje 24 farebných drevených kociek v rôznych tvaroch.
+
+OUTPUT
+Придать до обльубеныхпродукт си уложите медзи вами зволене обльубене положкы а можете си хо так рыхло најсть Древены возик на колиесках обсахује 24 фаребных древеных коциек в розных тварох.
+```
+
+#### Polish (`pol`)
+
+```text
+INPUT
+Pytałem o Olsztyn, a oni wypowiadali się o mieście w samych superlatywach, twierdząc m.in., że szczególnie latem jest tu pięknie.
+
+OUTPUT
+Пыталем о Олштын, а они выповиадали сиѧ о миесьцие в самых суперлатывах, твиердзѫц м.ин., же шчеголние латем јест ту пиѧкние.
+```
+
+#### Czech (`ces`)
+
+```text
+INPUT
+Trojice slonů afrických v Zoo Dvůr Králové nad Labem na Trutnovsku si dnes pochutnala na vánoční nadílce, v níž bylo i několik vánočních stromků.
+
+OUTPUT
+Тројице слону африцкых в Зоо Двур Кралове над Лабем на Трутновску си днес похутнала на ваночни надилце, в ниж было и нѣколик ваночних стромку.
+```
+
+### Latin standard output (`type=1`, `flav=3`)
+
+#### Polish (`pol`)
+
+```text
+INPUT
+Pytałem o Olsztyn, a oni wypowiadali się o mieście w samych superlatywach, twierdząc m.in., że szczególnie latem jest tu pięknie.
+
+OUTPUT
+Pytalem o Olštyn, a oni vypoviadali sie o miescie v samyh superlatyvah, tvierdzuc m.in., že ščegolnie latem jest tu pieknie.
+```
+
+### ASCII-oriented standard output (`type=2`, `flav=3`)
+
+#### Czech (`ces`)
+
+```text
+INPUT
+Trojice slonů afrických v Zoo Dvůr Králové nad Labem na Trutnovsku si dnes pochutnala na vánoční nadílce, v níž bylo i několik vánočních stromků.
+
+OUTPUT
+Trojice slonu africkyh v Zoo Dvur Kralove nad Labem na Trutnovsku si dnes pohutnala na vanoczni nadilce, v nizs bylo i njekolik vanocznih stromku.
+```
+
+### Cyrillic standard output (`type=5`, `flav=3`)
+
+#### Belarusian (`bel`)
+
+```text
+INPUT
+Той жа Юры Чыж рабіў свой бізнэс па «паняцьцях», дзякуючы блізкасьці да «цела» меў прывілеі, атрымліваў вольны доступ у прыбытковыя сфэры, куды пускалі толькі абраных, напрыклад, у гандаль нафтапрадуктамі.
+
+OUTPUT
+Тој жа Јуры Чиж рабив свој бизнес па «пањацјцјах», дзакујучи близкасци да «цела» мев прывилеи, атрымливав волны доступ у прыбытковыја сферы, куды пускали толки абраных, напрыклад, у гандал нафтапрадуктами.
+```
+
+#### Russian (`rus`)
+
+```text
+INPUT
+В боях за Дубно 14 февраля 1944 года молодой фотокорреспондент находился в боевых порядках 29-го гвардейского кавалерийского полка, оказавшегося в эпицентре сражения за город.
+
+OUTPUT
+В бојах за Дубно 14 февраља 1944 года молодој фотокорреспондент находилса в боевых порадках 29-го гвардејского кавалеријского полка, оказавшегоса в епицентре сраженија за город.
+```
+
+#### Ukrainian (`ukr`)
+
+```text
+INPUT
+"Улаштовуватимуть водопровідний вузол на водоводі діаметром 900 мм на розі вул. Зеленогірської та вул. Петра Радченка", — йдеться у повідомленні.
+
+OUTPUT
+"Улаштовуватимут водопровидниј вузол на водоводи диаметром 900 мм на рози вул. Зеленогирскоји та вул. Петра Радченка", — јдетса у повидомленни.
+```
+
+#### Rusyn (`rue`)
+
+```text
+INPUT
+Ключі організовано за дихотомічною системою і представлено у вигляді основного ключа до родин і 10 ключів до родів і видів кожної родини (кротові, мідицеві, вовчкові, мишівкові, тушканові, сліпакові, мишачі, хом'якові, норицеві).
+
+OUTPUT
+Кључи организовано за дихотомичноју системоју и представлено у вигљади основного кључа до родин и 10 кључив до родив и видив кожноји родини (кротови, мидицеви, вовчкови, мишивкови, тушканови, слипакови, мишачи, хом'јакови, норицеви).
+```
+
+#### Slovak (`slk`)
+
+```text
+INPUT
+Pridať do obľúbenýchProdukt si uložíte medzi vami zvolené obľúbené položky a môžete si ho tak rýchlo nájsť Drevený vozík na kolieskach obsahuje 24 farebných drevených kociek v rôznych tvaroch.
+
+OUTPUT
+Придат до облубеныхпродукт си уложите медзи вами зволене облубене положкы а можете си хо так рыхло најст Древены возик на колиесках обсахује 24 фаребных древеных коциек в розных тварох.
+```
+
+## Choosing a flavor
+
+Use `flav=2` when retaining soft consonants and etymological distinctions is
+more important than minimizing the character inventory.
+
+Use `flav=3` for a more neutral and compact common orthography. For example,
+some soft-sign distinctions retained by `flav=2` are removed by `flav=3`.
+
+Use `flav=4` when maximum simplification is preferred and the additional loss
+of orthographic distinctions is acceptable.
+
+## Input processing
+
+This focused port always uses the upstream loose-input preprocessing path. It:
+
+1. normalizes input to Unicode NFC;
+2. processes continuous sequences of Unicode letters and combining marks;
+3. converts recognized Latin and Cyrillic variants to an internal common form;
+4. applies the selected flavor profile;
+5. renders the selected output type; and
+6. restores lowercase, title-style, or uppercase word casing.
+
+Punctuation, whitespace, digits, and other non-letter characters are preserved.
+
+## Scope and limitations
+
+PyUniSlavic provides a common orthographic representation, not a normative
+spelling standard for every living Slavic language.
+
+The loose-input rules were designed primarily to accept varied Interslavic
+input. Their broad character coverage is useful for other Slavic languages,
+but the normalizer is not a complete language-specific phonological analyzer.
+For example:
+
+- Polish combinations such as `rz` or `dzi` are not always interpreted as a
+  single language-specific sound.
+- Some Ukrainian distinctions, including certain uses of `і/и` and `г/ґ`, can
+  be merged by normalization.
+- Etymological and standard profiles intentionally merge different sets of
+  letters, so conversion is not guaranteed to be reversible.
+- Mixed or camel-case capitalization is reduced to lowercase, title-style, or
+  uppercase at the word level, matching the upstream behavior.
+
+Applications that require exact source-language phonology should add a
+language-specific input adapter before calling `transliterate`.
+
+## Compatibility testing
+
+The initial Python port was checked against the upstream TypeScript behavior
+for all nine supported parameter combinations. The parity suite included 144
+targeted cases and 4,500 deterministic randomized Unicode cases, with identical
+outputs for the tested inputs.
+
+## Upstream project and attribution
+
+The core transliteration and loose-normalization rules are adapted from:
+
+- [`medzuslovjansky/js-utils`](https://github.com/medzuslovjansky/js-utils)
+- [`src/transliterate/transliterate.ts`](https://github.com/medzuslovjansky/js-utils/blob/main/src/transliterate/transliterate.ts)
+- [Interslavic](https://interslavic.fun/)
+
+The upstream project describes `@interslavic/utils` as a collection of
+JavaScript utilities for the Interslavic language, including transliteration.
+
+The upstream source is distributed under the MIT License:
+
+> Copyright (c) 2021 Medžuslovjansky (Меджусловјанскы)
+
+Any distribution of this derived port must include the upstream copyright and
+MIT permission notice. See the
+[`@interslavic/utils` license](https://github.com/medzuslovjansky/js-utils/blob/main/LICENSE)
+for the complete text.
+
+## Project status
+
+PyUniSlavic currently implements only the nine combinations documented above.
+Other upstream output modes and flavor profiles are intentionally outside the
+scope of this focused port.

pyunislavic-0.1.0/pyproject.toml

@@ -0,0 +1,40 @@
+[build-system]
+requires = ["hatchling>=1.27"]
+build-backend = "hatchling.build"
+
+
+[project]
+name = "pyunislavic"
+version = "0.1.0"
+description = "A Python implementation for transliterating and normalizing text from many Slavic languages and Interslavic into unified writing systems."
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+    { name = "Zijie ZHANG" }
+]
+keywords = [
+    "slavic",
+    "interslavic",
+    "transliteration",
+    "cyrillic",
+    "latin",
+    "orthography",
+    "normalization",
+    "romanization",
+    "cyrillization",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Typing :: Typed",
+    "Topic :: Text Processing :: Linguistic",
+]
+dependencies = []
+
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/pyunislavic"]

pyunislavic-0.1.0/src/pyunislavic/__init__.py

@@ -0,0 +1,11 @@
+from .transliterate import (
+    FlavorizationType,
+    TransliterationType,
+    transliterate,
+)
+
+__all__ = [
+    "FlavorizationType",
+    "TransliterationType",
+    "transliterate",
+]

pyunislavic-0.1.0/src/pyunislavic/transliterate.py

@@ -0,0 +1,376 @@
+"""Faithful Python subset of ``transliterate.ts``.
+
+Supported combinations:
+
+* type=1 (Latin), flav=2/3/4
+* type=2 (ASCII), flav=2/3/4
+* type=5 (Standard Cyrillic), flav=2/3/4
+
+Only the original loose-input preprocessing path is included.
+"""
+
+from __future__ import annotations
+
+from enum import IntEnum
+import re
+import unicodedata
+
+
+class TransliterationType(IntEnum):
+    LATIN = 1
+    ASCII = 2
+    STANDARD_CYRILLIC = 5
+
+
+class FlavorizationType(IntEnum):
+    ETYMOLOGICAL = 2
+    STANDARD = 3
+    SLOVIANTO = 4
+
+
+_SUPPORTED_TYPES = frozenset(TransliterationType)
+_SUPPORTED_FLAVORS = frozenset(FlavorizationType)
+_VOWELS = frozenset("aeiouyąęųåėȯèòěê")
+
+
+def transliterate(i_source: str, type: int, flav: int = 2) -> str:
+    """Transliterate text using one of the nine supported combinations.
+
+    Args:
+        i_source: Input text.
+        type: 1 for Latin, 2 for ASCII, or 5 for Standard Cyrillic.
+        flav: 2 for etymological, 3 for standard, or 4 for Slovianto.
+
+    The function always uses the loose preprocessing mode from the TypeScript
+    implementation. Non-letter characters are preserved unchanged.
+    """
+    if not isinstance(i_source, str):
+        raise TypeError("i_source must be a string")
+    if type not in _SUPPORTED_TYPES:
+        raise ValueError("type must be one of: 1 (Latin), 2 (ASCII), 5 (Standard Cyrillic)")
+    if flav not in _SUPPORTED_FLAVORS:
+        raise ValueError("flav must be one of: 2 (Etymological), 3 (Standard), 4 (Slovianto)")
+
+    source = unicodedata.normalize("NFC", i_source)
+    result: list[str] = []
+    word: list[str] = []
+
+    def flush_word() -> None:
+        if not word:
+            return
+        original_word = "".join(word)
+        marked_original = f"%{original_word}%"
+        internal_word = _nmsify_loose(marked_original.lower())
+        result.append(
+            _transliterate_word(
+                internal_word,
+                marked_original,
+                int(type),
+                int(flav),
+            )
+        )
+        word.clear()
+
+    for char in source:
+        if unicodedata.category(char)[:1] in {"L", "M"}:
+            word.append(char)
+        else:
+            flush_word()
+            result.append(char)
+    flush_word()
+
+    return "".join(result)
+
+
+def _transliterate_word(
+    i_w: str,
+    original_word: str,
+    type: int,
+    flav: int,
+) -> str:
+    # 'ŕ' remains between two consonants; otherwise it is represented by 'ř'.
+    i_w = i_w.replace("ŕ", "ř")
+    a_pos = i_w.find("ř")
+    if (
+        a_pos > 1
+        and i_w[a_pos - 1] != "%"
+        and i_w[a_pos - 1] not in _VOWELS
+        and i_w[a_pos + 1] not in _VOWELS
+    ):
+        i_w = i_w[:a_pos] + "ŕ" + i_w[a_pos + 1 :]
+
+    # Protect rj/jr, then classify the first remaining consonantal 'r'.
+    i_w = i_w.replace("rj", "Rj")
+    i_w = i_w.replace("jr", "jR")
+    r_pos = i_w.find("r")
+    if (
+        r_pos > 1
+        and i_w[r_pos - 1] != "%"
+        and i_w[r_pos - 1] not in _VOWELS
+        and i_w[r_pos + 1] not in _VOWELS
+    ):
+        i_w = i_w[:r_pos] + "ṙ" + i_w[r_pos + 1 :]
+        i_w = re.sub(r"([šžčc])ṙ", r"\g<1>ŕ", i_w)
+    i_w = i_w.replace("R", "r")
+
+    i_w = i_w.replace("x", "ks")
+    i_w = re.sub(r"([ńľřťďśź])j", r"\g<1>ıj", i_w)
+    i_w = re.sub(r"([dsz])j", r"\g<1>#j", i_w)
+    i_w = i_w.replace("%obj", "ob#j")
+    i_w = i_w.replace("%neobj", "neob#j")
+    i_w = i_w.replace("%vj", "v#j")
+
+    # Flavor 2 is the shared base for flavors 2, 3, and 4.
+    i_w = i_w.replace("ê", "ě")
+    i_w = i_w.replace("ŭ", "v")
+    i_w = re.sub(r"[ṱḓ]", "", i_w)
+    i_w = re.sub(r"[’`]", "#%", i_w)
+    i_w = re.sub(r"([čšžj])ě", r"\g<1>e", i_w)
+
+    # Flavors 3 and 4 share the standard simplifications.
+    if flav in (3, 4):
+        i_w = re.sub(r"[ęė]", "e", i_w)
+        i_w = i_w.replace("å", "a")
+        i_w = i_w.replace("ȯ", "o")
+        i_w = i_w.replace("ų", "u")
+        i_w = i_w.replace("ć", "č")
+        i_w = i_w.replace("đ", "dž")
+        i_w = i_w.replace("ř", "r")
+        i_w = i_w.replace("ľ", "l")
+        i_w = i_w.replace("ń", "n")
+        i_w = i_w.replace("ť", "t")
+        i_w = i_w.replace("ď", "d")
+        i_w = i_w.replace("ś", "s")
+        i_w = i_w.replace("ź", "z")
+
+    if flav == 4:
+        i_w = i_w.replace("ě", "e")
+        i_w = i_w.replace("y", "i")
+
+    if type == 1:
+        if flav == 2:
+            i_w = i_w.replace("ṙ", "r")
+            i_w = i_w.replace("ř", "ŕ")
+            i_w = i_w.replace("ľ", "ĺ")
+            i_w = i_w.replace("ť", "t́")
+            i_w = i_w.replace("ď", "d́")
+            i_w = re.sub(r"([čšžj])ŕ", r"\g<1>r", i_w)
+        elif flav in (3, 4):
+            i_w = re.sub(r"[ṙŕ]", "r", i_w)
+            i_w = i_w.replace("ȯ", "ă")
+
+    elif type == 2:
+        i_w = re.sub(r"[ṙŕ]", "r", i_w)
+        i_w = i_w.replace("š", "sz")
+        i_w = re.sub(r"[ćč]", "cz", i_w)
+        i_w = i_w.replace("ž", "zs")
+        i_w = i_w.replace("đ", "dzs")
+        i_w = i_w.replace("ě", "je")
+        i_w = i_w.replace("å", "a")
+        i_w = re.sub(r"[ęė]", "e", i_w)
+        i_w = i_w.replace("ȯ", "o")
+        i_w = i_w.replace("ų", "u")
+
+    elif type == 5:
+        i_w = i_w.replace("lj", "љ")
+        i_w = i_w.replace("nj", "њ")
+        i_w = i_w.replace("a", "а")
+        i_w = i_w.replace("å", "ӑ")
+        i_w = i_w.replace("b", "б")
+        i_w = i_w.replace("c", "ц")
+        i_w = i_w.replace("ć", "ћ")
+        i_w = i_w.replace("č", "ч")
+        i_w = re.sub(r"[dḓ]", "д", i_w)
+        i_w = i_w.replace("ď", "дь")
+        i_w = i_w.replace("đ", "ђ")
+        i_w = i_w.replace("e", "е")
+        i_w = i_w.replace("ę", "ѧ")
+        i_w = i_w.replace("ě", "є")
+        i_w = i_w.replace("f", "ф")
+        i_w = i_w.replace("g", "г")
+        i_w = i_w.replace("h", "х")
+        i_w = i_w.replace("i", "и")
+        i_w = i_w.replace("j", "ј")
+        i_w = i_w.replace("k", "к")
+        i_w = i_w.replace("l", "л")
+        i_w = i_w.replace("ľ", "ль")
+        i_w = i_w.replace("m", "м")
+        i_w = i_w.replace("n", "н")
+        i_w = i_w.replace("ń", "нь")
+        i_w = i_w.replace("o", "о")
+        i_w = i_w.replace("ȯ", "ъ")
+        i_w = i_w.replace("p", "п")
+        i_w = i_w.replace("r", "р")
+        i_w = i_w.replace("ř", "рь")
+        i_w = i_w.replace("s", "с")
+        i_w = i_w.replace("ś", "сь")
+        i_w = i_w.replace("š", "ш")
+        i_w = re.sub(r"[tṱ]", "т", i_w)
+        i_w = i_w.replace("ť", "ть")
+        i_w = i_w.replace("u", "у")
+        i_w = i_w.replace("ų", "ѫ")
+        i_w = i_w.replace("ŭ", "ў")
+        i_w = i_w.replace("v", "в")
+        i_w = i_w.replace("y", "ы")
+        i_w = i_w.replace("z", "з")
+        i_w = i_w.replace("ź", "зь")
+        i_w = i_w.replace("ž", "ж")
+        i_w = i_w.replace("’", "ъ")
+        i_w = i_w.replace("`", "’")
+
+        i_w = re.sub(r"[ṙŕ]", "р", i_w)
+        i_w = i_w.replace("ė", "е")
+        if flav == 2:
+            i_w = i_w.replace("є", "ѣ")
+
+    i_w = i_w.replace("jj", "j")
+    i_w = re.sub(r"[#ı%]", "", i_w)
+    original_word = original_word.replace("%", "")
+
+    i_w_first = i_w[:1]
+    i_w_rest = i_w[1:]
+    if original_word[0] == original_word[0].lower():
+        return i_w.lower()
+    if len(original_word) > 1 and original_word[1] == original_word[1].lower():
+        return i_w_first.upper() + i_w_rest.lower()
+    return i_w.upper()
+
+
+def _nmsify_loose(i_w: str) -> str:
+    # Iotated vowels and soft-sign sequences.
+    i_w = re.sub(r"[яꙗ]", "#a", i_w)
+    i_w = i_w.replace("ьа", "#a")
+    i_w = i_w.replace("ѥ", "#e")
+    i_w = i_w.replace("ье", "#e")
+    i_w = i_w.replace("ї", "#i")
+    i_w = i_w.replace("ьи", "#i")
+    i_w = i_w.replace("ё", "#o")
+    i_w = i_w.replace("ьо", "#o")
+    i_w = i_w.replace("ю", "#u")
+    i_w = i_w.replace("ьу", "#u")
+    i_w = i_w.replace("ѩ", "#ę")
+    i_w = i_w.replace("ьѧ", "#ę")
+    i_w = i_w.replace("ѭ", "#ų")
+    i_w = i_w.replace("ьѫ", "#ų")
+    i_w = i_w.replace("нь", "ń")
+    i_w = i_w.replace("н#", "nj")
+    i_w = i_w.replace("њ", "nj")
+    i_w = i_w.replace("ль", "ĺ")
+    i_w = i_w.replace("л#", "lj")
+    i_w = i_w.replace("љ", "lj")
+    i_w = i_w.replace("рь", "ŕ")
+    i_w = i_w.replace("р#", "ŕ")
+    i_w = i_w.replace("ть", "ť")
+    i_w = i_w.replace("т#", "ť")
+    i_w = i_w.replace("дь", "ď")
+    i_w = i_w.replace("д#", "ď")
+    i_w = i_w.replace("сь", "ś")
+    i_w = i_w.replace("с#", "ś")
+    i_w = i_w.replace("зь", "ź")
+    i_w = i_w.replace("з#", "ź")
+    i_w = i_w.replace("ь%", "%")
+    i_w = re.sub(r"[ђѓ]", "đ", i_w)
+    i_w = re.sub(r"[ћќ]", "ć", i_w)
+    i_w = i_w.replace("ѕ", "dz")
+    i_w = i_w.replace("џ", "dž")
+
+    # Cyrillic to the internal Latin representation.
+    i_w = i_w.replace("а", "a")
+    i_w = i_w.replace("б", "b")
+    i_w = i_w.replace("в", "v")
+    i_w = re.sub(r"[гґ]", "g", i_w)
+    i_w = i_w.replace("д", "d")
+    i_w = re.sub(r"[еэ]", "e", i_w)
+    i_w = re.sub(r"[єѣ]", "ě", i_w)
+    i_w = i_w.replace("ж", "ž")
+    i_w = re.sub(r"[зꙁꙀ]", "z", i_w)
+    i_w = re.sub(r"[иіѵѷ]", "i", i_w)
+    i_w = re.sub(r"[йјь#]", "j", i_w)
+    i_w = i_w.replace("к", "k")
+    i_w = i_w.replace("л", "l")
+    i_w = i_w.replace("м", "m")
+    i_w = i_w.replace("н", "n")
+    i_w = re.sub(r"[оѡ]", "o", i_w)
+    i_w = i_w.replace("п", "p")
+    i_w = i_w.replace("р", "r")
+    i_w = i_w.replace("с", "s")
+    i_w = re.sub(r"[тѳ]", "t", i_w)
+    i_w = re.sub(r"[уȣѹ]", "u", i_w)
+    i_w = i_w.replace("ф", "f")
+    i_w = i_w.replace("х", "h")
+    i_w = i_w.replace("ц", "c")
+    i_w = i_w.replace("ч", "č")
+    i_w = i_w.replace("ш", "š")
+    i_w = i_w.replace("щ", "šč")
+    i_w = re.sub(r"[ыꙑ]", "y", i_w)
+    i_w = i_w.replace("ъ", "ȯ")
+    i_w = i_w.replace("ў", "ŭ")
+    i_w = i_w.replace("ѧ", "ę")
+    i_w = i_w.replace("ѫ", "ų")
+    i_w = i_w.replace("ѱ", "ps")
+    i_w = i_w.replace("ѯ", "ks")
+    i_w = i_w.replace("ӑ", "å")
+
+    i_w = i_w.replace("⁙", ".")
+
+    # Boundaries that protect morphology from later j/s transformations.
+    i_w = i_w.replace("zsk", "z#sk")
+    i_w = i_w.replace("zst", "z#st")
+    i_w = i_w.replace("%izs", "%iz#s")
+    i_w = i_w.replace("%bezs", "%bez#s")
+    i_w = i_w.replace("%obezs", "%obez#s")
+    i_w = i_w.replace("%razs", "%raz#s")
+    i_w = i_w.replace("%råzs", "%råz#s")
+    i_w = i_w.replace("%szadu%", "%s#zadu%")
+    i_w = i_w.replace("%vozs", "%voz#s")
+    i_w = i_w.replace("%vȯzs", "%vȯz#s")
+    i_w = i_w.replace("konjug", "kon#jug")
+    i_w = i_w.replace("konjun", "kon#jun")
+    i_w = i_w.replace("injek", "in#jek")
+
+    i_w = re.sub(r"s[xz]", "š", i_w)
+    i_w = re.sub(r"c[xz]", "č", i_w)
+    i_w = re.sub(r"z[xs]", "ž", i_w)
+    i_w = i_w.replace("ż", "ž")
+    i_w = i_w.replace("ye", "ě")
+
+    i_w = i_w.replace("qu", "kv")
+    i_w = i_w.replace("ŀ", "ȯl")
+    i_w = re.sub(r"[ăq`]", "’", i_w)
+    i_w = i_w.replace("ch", "h")
+    i_w = i_w.replace("w", "v")
+    i_w = i_w.replace("x", "ks")
+
+    i_w = re.sub(r"[áàâā]", "a", i_w)
+    i_w = re.sub(r"[íìîīĭı]", "i", i_w)
+    i_w = re.sub(r"[úûůū]", "u", i_w)
+    i_w = re.sub(r"[ąǫũ]", "ų", i_w)
+    i_w = i_w.replace("ù", "ŭ")
+    i_w = re.sub(r"[éē]", "e", i_w)
+    i_w = re.sub(r"[ĕëè]", "ė", i_w)
+    i_w = re.sub(r"[œóô]", "o", i_w)
+    i_w = re.sub(r"[ŏöò]", "ȯ", i_w)
+    i_w = i_w.replace("ý", "y")
+    i_w = i_w.replace("ł", "l")
+    i_w = i_w.replace("ç", "c")
+    i_w = i_w.replace("ʒ", "z")
+    i_w = i_w.replace("ĵ", "j")
+    i_w = re.sub(r"[ĺļlj]", "ľ", i_w)
+    i_w = re.sub(r"[ňñņnj]", "ń", i_w)
+    i_w = i_w.replace("ř", "ŕ")
+    i_w = i_w.replace("t́", "ť")
+    i_w = i_w.replace("d́", "ď")
+
+    i_w = re.sub(r"([jćđšžč])y", r"\g<1>i", i_w)
+    return i_w.replace("jj", "j")
+
+
+__all__ = [
+    "FlavorizationType",
+    "TransliterationType",
+    "transliterate",
+]
+
+
+
+