@naandalist/honocoroko

A TypeScript library for transliterating text between Latin and Javanese script (Aksara Jawa/Hanacaraka).

Note: This library changes writing systems (Latin ↔ Javanese script), not languages. It’s transliteration, not translation.

Features

✅ Universal Module Support - Works with both ESM (import) and CommonJS (require)
✅ Full support for basic Javanese consonants (Aksara Nglegena)
✅ Vowels and vowel marks (Sandhangan)
✅ Special consonants (Aksara Murda)
✅ Javanese numerals (0-9)
✅ Javanese punctuation
✅ Phonetic approximations for Latin letters not in Javanese (f, v, z, q, x)
✅ TypeScript support with full type definitions
✅ Zero dependencies - lightweight and secure

Installation

npm install @naandalist/honocoroko

Usage

Import Methods

ESM (Modern) - Recommended

import {
  toHonocoroko,
  fromHonocoroko,
  transliterate,
} from "@naandalist/honocoroko";

CommonJS (Legacy)

const {
  toHonocoroko,
  fromHonocoroko,
  transliterate,
} = require("@naandalist/honocoroko");

Basic Examples

// Convert Latin text to Javanese script
const javanese = toHonocoroko("hanacaraka");
console.log(javanese); // ꦲꦤꦕꦫꦏ

// Convert Javanese script back to Latin
const latin = fromHonocoroko("ꦲꦤꦕꦫꦏ");
console.log(latin); // hanacaraka

// Using the generic transliterate function
const result1 = transliterate("hanacaraka", "toHonocoroko");
const result2 = transliterate("ꦲꦤꦕꦫꦏ", "fromHonocoroko");

TypeScript Projects

import {
  toHonocoroko,
  fromHonocoroko,
  TransliterationDirection,
  TransliterationOptions,
} from "@naandalist/honocoroko";

const javanese: string = toHonocoroko("hanacaraka");
const latin: string = fromHonocoroko("ꦲꦤꦕꦫꦏ");

// With options - opt-in to convert special characters
const options: TransliterationOptions = { convertSpecialChars: true };
const result: string = toHonocoroko("sapa iki?", options);

API

`toHonocoroko(text: string, options?: TransliterationOptions): string`

Converts Latin text to Javanese script.

const javanese = toHonocoroko("hanacaraka");
// Returns: ꦲꦤꦕꦫꦏ

`fromHonocoroko(text: string, options?: TransliterationOptions): string`

Converts Javanese script back to Latin text.

const latin = fromHonocoroko("ꦲꦤꦕꦫꦏ");
// Returns: hanacaraka

`transliterate(text: string, direction: 'toHonocoroko' | 'fromHonocoroko', options?: TransliterationOptions): string`

Generic function that can transliterate in either direction.

const result1 = transliterate("hanacaraka", "toHonocoroko");
const result2 = transliterate("ꦲꦤꦕꦫꦏ", "fromHonocoroko");

Supported Characters

Basic Consonants

ha (ꦲ), na (ꦤ), ca (ꦕ), ra (ꦫ), ka (ꦏ)
da (ꦢ), ta (ꦠ), sa (ꦱ), wa (ꦮ), la (ꦭ)
pa (ꦥ), dha (ꦝ), ja (ꦗ), ya (ꦪ), nya (ꦚ)
ma (ꦩ), ga (ꦒ), ba (ꦧ), tha (ꦛ), nga (ꦔ)

Numbers

0-9 → ꧐-꧙

Punctuation

Comma (,) → ꧈
Period (.) → ꧉
Colon (:) → ꧇

Phonetic Approximations

f → ꦥ꦳ (pa + cecak telu)
v → ꦮ꦳ (wa + cecak telu)
z → ꦗ꦳ (ja + cecak telu)
q → ꦏ (ka)
x → ꦏ꧀ꦱ (ks)

Font Support

This package includes the HanacarakaFont.ttf in the /fonts directory for proper display of Javanese script.

Credits

This library is inspired by the transliterasijawa project.

License

For more details, please visit the GitHub repository.