shevchenko.js

Open-source JavaScript library for declension of Ukrainian personal names

Live demoUsage Example

Live demo declension of Ukrainian family names, given names, patronymic names

Automatic grammatical gender detection by first name or patronymic name.
Grammatical CaseDeclension Result
NominativeШевченко Тарас Григорович
GenitiveШевченка Тараса Григоровича
DativeШевченку Тарасу Григоровичу
AccusativeШевченка Тараса Григоровича
AblativeШевченком Тарасом Григоровичем
LocativeШевченкові Тарасові Григоровичу
VocativeШевченку Тарасе Григоровичу

Installation

npm

npm install --save shevchenko

Node.js

const shevchenko = require("shevchenko");

Browser

<‍script type="text/javascript" src="https://unpkg.com/shevchenko"><‍/script>

Usage Example

const shevchenko = require('shevchenko');

async function main() {
  const input = {
    gender: 'masculine',
    givenName: 'Тарас',
    patronymicName: 'Григорович',
    familyName: 'Шевченко'
  };

  const output = await shevchenko.inVocative(input);

  console.log(output); // { givenName: "Тарасе", patronymicName: "Григоровичу", familyName: "Шевченку" }
}

main().catch((error) => console.error(error));