GeezGet ግዕዝ

Convert numbers to authentic Geʽez numerals (፩, ፪, ፫...) and Amharic words with this lightweight TypeScript library. Perfect for Ethiopian/Eritrean applications, historical projects, and cultural preservation.

✨ Features

• Accurate Conversion to Geʽez numeral symbols (1 → ፩, 100 → ፩፻, 10,000 → ፩፼)

• Amharic Word Output (1 → "አንድ", 100 → "አንድ መቶ")

• Range Generation - Get sequences of converted numbers

• TypeScript Native - Full type definitions included

• Zero Dependencies - Lightweight and fast

• Bidirectional Support - Numbers ↔ Geʽez symbols ↔ Amharic words

📦 Installation

npm

npm  install  geezget

yarn

yarn  add  geezget

🚀 Quick Start

Generate Number Ranges

typescript

import  {  GeezNumberService  }  from  'geezget';

const  result  =  GeezNumberService.generateRange(10,  15);

console.log(result);

/*

[

{ number: 10, symbol: '፲', name: 'አስር' },

{ number: 11, symbol: '፲፩', name: 'አስር አንድ' },

{ number: 12, symbol: '፲፪', name: 'አስር ሁለት' },

...

]

*/

Convert Single Numbers

typescript

import  {  GeezNumberService  }  from  'geezget';



//  To  Geʽez  numeral

console.log(GeezNumberService.toGeezSymbol(10000)); //  "፩፼"  or  '፼'  if  your  implementation  simplifies  10000



//  To  Amharic  words

console.log(GeezNumberService.toAmharicName(10000)); //  "አንድ እልፍ"

📚 Complete API Reference

GeezNumberService.toGeezSymbol(number: number): string

Converts numbers to Geʽez numerals.

Example:

typescript

  

GeezNumberService.toGeezSymbol(100); //  '፩፻'  or  '፻'  if  your  implementation  simplifies  100

GeezNumberService.toGeezSymbol(123); //  "፩፻፳፫"

  

GeezNumberService.toAmharicName(number:  number): string

  

Converts  numbers  to  Amharic  words.

Example:

typescript

GeezNumberService.toAmharicName(100); //  "አንድ መቶ"

GeezNumberService.toAmharicName(2023); //  "ሁለት ሺ ሃያ ሦስት"



GeezNumberService.generateRange(from:  number,  to:  number): GeezNumber[]

Generates a range of converted numbers.

Type Definition:

typescript

interface  GeezNumber  {

number:  number; //  Original  number (1-10000)

symbol:  string; //  Geʽez  numeral (፩, ፪...)

name:  string; //  Amharic  word  form

}

🌍 Cultural Context

The Geʽez numbering system is one of the world's oldest numeral systems still in use today. Key features:

10,000 (፼) is the highest single unit

Multiplicative system (100 = ፩ × ፻)

Used in Ethiopian Orthodox churches, historical documents, and calendar systems

Limitations

Does not support fractions/decimal numbers

Negative numbers return empty strings