{"id":25793770,"url":"https://github.com/nalgeon/iuliia-js","last_synced_at":"2025-07-20T01:34:55.709Z","repository":{"id":44754299,"uuid":"258343478","full_name":"nalgeon/iuliia-js","owner":"nalgeon","description":"Transliterate Cyrillic → Latin in every possible way","archived":false,"fork":false,"pushed_at":"2022-01-26T18:04:30.000Z","size":2346,"stargazers_count":85,"open_issues_count":0,"forks_count":7,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-07-17T08:47:36.305Z","etag":null,"topics":["javascript","transliteration"],"latest_commit_sha":null,"homepage":"https://iuliia.ru","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nalgeon.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-04-23T22:16:02.000Z","updated_at":"2025-07-04T10:31:12.000Z","dependencies_parsed_at":"2022-09-26T19:02:35.768Z","dependency_job_id":null,"html_url":"https://github.com/nalgeon/iuliia-js","commit_stats":null,"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"purl":"pkg:github/nalgeon/iuliia-js","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nalgeon%2Fiuliia-js","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nalgeon%2Fiuliia-js/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nalgeon%2Fiuliia-js/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nalgeon%2Fiuliia-js/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nalgeon","download_url":"https://codeload.github.com/nalgeon/iuliia-js/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nalgeon%2Fiuliia-js/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266053867,"owners_count":23869499,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["javascript","transliteration"],"created_at":"2025-02-27T13:38:58.040Z","updated_at":"2025-07-20T01:34:55.676Z","avatar_url":"https://github.com/nalgeon.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# `Iuliia`\n\n\u003e Transliterate Cyrillic → Latin in every possible way\n\n\u003e This is the TypeScript port of the Python [iuliia](https://github.com/nalgeon/iuliia-py) package\n\n[![NPM Version][npm-image]][npm-url]\n[![Build Status][build-image]][build-url]\n[![Code Coverage][coverage-image]][coverage-url]\n[![Code Quality][quality-image]][quality-url]\n\nTransliteration means representing Cyrillic data (mainly names and geographic locations) with Latin letters. It is used for international passports, visas, green cards, driving licenses, mail and goods delivery etc.\n\n`Iuliia` makes transliteration as easy as:\n\n```ts\n// Typescript, ES6\nimport * as iuliia from \"iuliia\";\niuliia.translate(\"Юлия Щеглова\", iuliia.WIKIPEDIA);\n'Yuliya Shcheglova'\n```\n\n```js\n// CommonJS\nconst iuliia = require(\"iuliia\");\niuliia.translate(\"Юлия Щеглова\", iuliia.WIKIPEDIA);\n'Yuliya Shcheglova'\n```\n\n## Why use `Iuliia`\n\n-   [20 transliteration schemas](https://github.com/nalgeon/iuliia) (rule sets), including all main international and Russian standards.\n-   Correctly implements not only the base mapping, but all the special rules for letter combinations and word endings.\n-   Simple API and zero third-party dependencies.\n\nFor schema details and other information, see \u003chttps://iuliia.ru/\u003e (in Russian).\n\n[Issues and limitations](https://github.com/nalgeon/iuliia/blob/master/README.md#issues-and-limitations)\n\n## Installation\n\n```sh\nnpm install iuliia\n```\n\n## Usage\n\nES2015 JavaScript:\n\n```js\nimport iuliia from \"iuliia\";\n\n// list all supported schemas\nfor (let schemaName of iuliia.Schemas.names()) {\n    console.log(schemaName);\n}\n\n// transliterate using specified schema\nlet source = \"Юлия Щеглова\";\niuliia.translate(source, iuliia.ICAO_DOC_9303);\n// \"Iuliia Shcheglova\"\n\n// or pick schema by name\nlet schema = iuliia.Schemas.get(\"wikipedia\");\niuliia.translate(source, schema);\n// \"Yuliya Shcheglova\"\n```\n\nES5 browser JavaScript:\n\n```html\n\u003cscript src=\"https://unpkg.com/iuliia@latest/dist/umd/iuliia.min.js\"\u003e\u003c/script\u003e\n\u003cscript\u003e\n    var source = \"Юлия Щеглова\";\n    var result = iuliia.translate(source, iuliia.WIKIPEDIA);\n    console.log(result);\n\u003c/script\u003e\n```\n\nSupported schemas:\n\n```\nala_lc          iuliia.ALA_LC\nala_lc_alt      iuliia.ALA_LC_ALT\nbgn_pcgn        iuliia.BGN_PCGN\nbgn_pcgn_alt    iuliia.BGN_PCGN_ALT\nbs_2979         iuliia.BS_2979\nbs_2979_alt     iuliia.BS_2979_ALT\ngost_779        iuliia.GOST_779\ngost_779_alt    iuliia.GOST_779_ALT\ngost_7034       iuliia.GOST_7034\ngost_16876      iuliia.GOST_16876\ngost_16876_alt  iuliia.GOST_16876_ALT\ngost_52290      iuliia.GOST_52290\ngost_52535      iuliia.GOST_52535\nicao_doc_9303   iuliia.ICAO_DOC_9303\niso_9_1954      iuliia.ISO_9_1954\niso_9_1968      iuliia.ISO_9_1968\niso_9_1968_alt  iuliia.ISO_9_1968_ALT\nmosmetro        iuliia.MOSMETRO\nmvd_310         iuliia.MVD_310\nmvd_310_fr      iuliia.MVD_310_FR\nmvd_782         iuliia.MVD_782\nscientific      iuliia.SCIENTIFIC\ntelegram        iuliia.TELEGRAM\nungegn_1987     iuliia.UNGEGN_1987\nwikipedia       iuliia.WIKIPEDIA\nyandex_maps     iuliia.YANDEX_MAPS\nyandex_money    iuliia.YANDEX_MONEY\n```\n\n## Development setup\n\nInstall dependencies:\n\n```sh\nnpm ci\n```\n\nGenerate schemas from the [schemas repository](https://github.com/nalgeon/iuliia):\n\n```sh\nnpm run generate\n```\n\nFormat the source code:\n\n```sh\nnpm run format\n```\n\nRun ESLint checks:\n\n\n```sh\nnpm run lint\n```\n\nRun unit tests:\n\n```sh\nnpm test\n```\n\nBuild JS:\n\n```sh\nnpm run build\n```\n\n## Contributing\n\nPull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.\n\nMake sure to add or update tests as appropriate.\n\nUse [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0-beta.4/) for commit messages.\n\n## [Changelog](CHANGELOG.md)\n\n## License\n\n[MIT](https://choosealicense.com/licenses/mit/)\n\n\u003c!-- Markdown link \u0026 img dfn's --\u003e\n\n[npm-image]: https://img.shields.io/npm/v/iuliia?style=flat-square\n[npm-url]: https://www.npmjs.com/package/iuliia\n[build-image]: https://img.shields.io/travis/nalgeon/iuliia-js?style=flat-square\n[build-url]: https://travis-ci.org/nalgeon/iuliia-js\n[coverage-image]: https://img.shields.io/coveralls/github/nalgeon/iuliia-js?style=flat-square\n[coverage-url]: https://coveralls.io/github/nalgeon/iuliia-js\n[quality-image]: https://img.shields.io/codeclimate/maintainability/nalgeon/iuliia-js?style=flat-square\n[quality-url]: https://codeclimate.com/github/nalgeon/iuliia-js\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnalgeon%2Fiuliia-js","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnalgeon%2Fiuliia-js","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnalgeon%2Fiuliia-js/lists"}