RELEASE // THESMARTER/TAFQEET

thesmarter/Tafqeet

2.1✓ STABLE↓ 0 downloads0 files · 0 B

by Tayeb-Alipublished 2026-09-13

$ gh release view 2.1 --repo thesmarter/Tafqeet

Quick install

$ gh release download 2.1 --repo thesmarter/Tafqeet

View on GitHub →

FILES // 0 ASSETS

Downloads

$ NO_ATTACHED_BINARIES — grab the source archive below.

SOURCE_CODE //

↓ .tar.gz ↓ .ziphttps://api.github.com/repos/thesmarter/Tafqeet/tarball/2.1

NOTES // CHANGELOG

Release notes

🎉 What's New in v2.1

#### 💱 New: Expanded Currency Support Added 16 new currencies bringing total support to 19 currencies:

Arab Currencies / العملات العربية:

Code	Currency
`egp`	Egyptian Pound (جنيه مصري)
`syp`	Syrian Pound (جنيه سوري)
`lbp`	Lebanese Pound (جنيه لبناني)
`iqd`	Iraqi Dinar (دينار عراقي)
`jod`	Jordanian Dinar (دينار أردني)
`omr`	Omani Rial (ريال عماني)
`qar`	Qatari Rial (ريال قطري)
`aed`	UAE Dirham (درهم إماراتي)
`kwd`	Kuwaiti Dinar (دينار كويتي)
`bhd`	Bahraini Dinar (دينار بحريني)

Western Currencies / العملات الغربية:

Code	Currency
`eur`	Euro (يورو)
`gbp`	British Pound (جنيه إسترليني)
`cad`	Canadian Dollar (دولار كندي)
`aud`	Australian Dollar (دولار أسترالي)
`jpy`	Japanese Yen (ين ياباني)
`chf`	Swiss Franc (فرنك سويسري)

#### 🐛 Bug Fixes

Fixed SDG currency main name: قرش → جنيه (was incorrectly set to piastre instead of pound)
Fixed empty fractional currency handling (e.g., JPY has no sub-unit) - no longer appends empty words

#### 📖 Documentation

Updated README with comprehensive currency tables grouped by Arab and Western
Added bilingual currency tables in both English and Arabic READMEs

📋 Full Change List

Modified: src/Core/Tafqeet.php - Expanded CURRENCIES constant (3 → 19 currencies)
Modified: src/Core/Tafqeet.php - Handle empty fractional units gracefully
Modified: README.md - Updated currency tables
Modified: README-ar.md - Updated currency tables
Added: 13 new currency test cases

💡 Usage Examples

PHP

// Egyptian Pound
Tafqeet::arablic(1000.50, 'egp');
// Output: فقط ألف جنيه وخمسون قرش لاغير

// UAE Dirham
Tafqeet::arablic(500, 'aed');
// Output: فقط خمسون درهمًا لاغير

// Euro
Tafqeet::arablic(250.75, 'eur');
// Output: فقط مائة وخمسون يوروًا وسبعة وسبعون سنت لاغير

// British Pound
Tafqeet::arablic(100, 'gbp');
// Output: فقط مائة جنيه إسترلينيًا لاغير

// Japanese Yen (no fractional)
Tafqeet::arablic(1000, 'jpy');
// Output: فقط ألف ين لاغير

🔧 Technical Details

Currencies stored as associative array with: main1, main2, single, multi
Empty single/multi values are skipped in output (e.g., JPY)
All 17 PHPUnit tests passing ✅
PSR-12 compliant ✅

Full Changelog: https://github.com/thesmarter/Tafqeet/compare/v2.0...2.1

Quick install_

Downloads_

Release notes_

### 🎉 What's New in v2.1

### 📋 Full Change List

### 💡 Usage Examples

### 🔧 Technical Details