base11172

Encode any data into Korean Hangul syllables using base-11172.

11,172 Unicode Hangul syllables (가 ~ 힣, U+AC00 ~ U+D7A3) to represent arbitrary binary data. Each character carries ~13.45 bits of information, producing output ~30% the length of the original hex string.

Install

npm install base11172
# or
bun add base11172

Usage

Hex string

import { encode, decode } from "base11172";

const kor = encode("7a538344c200b87ed788809520bc82c4");
// "갂꾦댎핦쫋쮉릴콰쇁셿"

const hex = decode(kor);
// "7a538344c200b87ed788809520bc82c4"

Text (UTF-8)

import { encodeText, decodeText } from "base11172";

const kor = encodeText("Hello World!");
// "걲뱗솦홥쳤닿쉧"

const text = decodeText(kor);
// "Hello World!"

Buffer

import { encode, decodeToBuffer, encodeText } from "base11172";

// Buffer -> Hangul
const kor = encode(Buffer.from([0x00, 0xff, 0x42]));

// Hangul -> Buffer
const buf = decodeToBuffer(kor);

// Buffer via encodeText
const kor2 = encodeText(Buffer.from("hello"));

Number

import { encode, decode } from "base11172";

const kor = encode(255);    // encode(0xff)
const hex = decode(kor);    // "ff"

Array

import { encodeArray, decodeArray } from "base11172";

const encoded = encodeArray(["ff", "00", 256]);
const decoded = decodeArray(encoded);

API

Function	Input	Output	Description
encode	string | Buffer | number	string	Hex/Buffer/number to Hangul
decode	string	string	Hangul to hex string
encodeText	string | Buffer	string	UTF-8 text/Buffer to Hangul
decodeText	string	string	Hangul to UTF-8 text
decodeToBuffer	string	Buffer	Hangul to Buffer
encodeArray	(string | Buffer | number)[]	string[]	Batch encode
decodeArray	string[]	string[]	Batch decode

Compression ratio

Input	Hex length	Hangul length	Ratio
8 bytes	16 chars	5 chars	31.3%
32 bytes (SHA-256)	64 chars	20 chars	31.3%
64 bytes	128 chars	39 chars	30.5%

How it works

1. Input is converted to a hex string
2. A "1" prefix is prepended to preserve leading zeros
3. The resulting number is converted to base-11172 using BigInt
4. Each digit is mapped to a Hangul syllable (U+AC00 + digit)
5. Decoding reverses the process

License

MIT