Arabicfmt Mcp

import {  formatCurrency,      // correct symbol + precision for every Arab currency  formatCurrencyRange, // "1,000.00 – 5,000.00 ر.س"  formatCurrencyToParts, // typed parts — font-scope just the new Unicode sign  transitionStatus,    // "none" | "announced" | "encoded" for any date  signFontFaceCSS,     // the scoped @font-face the new signs need  formatCompact,       // 1,200,000 → "1.2M" / "١٫٢ مليون"  arabicToWords,       // 1234 → "ألف ومئتان وأربعة وثلاثون"  spellCurrency,       // تفقيط: 1234.5 SAR → "...ريالاً وخمسون هللةً"  arabicOrdinal,       // 25 → "الخامس والعشرون"  formatDuration,      // 7_500_000ms → "ساعتان وخمس دقائق"  formatFileSize,      // 1536 → "1.5 كيلوبايت"  formatRelativeTime,  // "منذ ٣ أيام"  formatList,          // ["أحمد","علي"] → "أحمد وعلي"  parseCurrency,       // "١٬٢٣٤٫٥٠ ر.س" → 1234.5  arabicPlural,        // full 6-form Arabic plural selection  sortArabic,          // Arabic-locale collation  slugify,             // "مدينة جدة" → "mdynh-jdh" (URL slugs)  isValidIBAN,         // ISO 7064 mod-97 IBAN checksum  isValidSaudiId,      // Saudi national ID / Iqama check digit  isolateForeign,      // fix broken RTL sentences  normalizeForSearch,  // search-key normalization  detectLocale,        // auto-detect from browser / Node environment} from "arabicfmt";
import { formatHijri, toHijri } from "arabicfmt/umalqura"; // deterministic Hijri calendar
// CurrencyformatCurrency(1.2,   { currency: "KWD" });                      // "1.200 د.ك"formatCurrency(1234,  { locale: "ar-SA", numerals: "arab" });    // "١٬٢٣٤٫٠٠ ر.س"formatCurrency(-500,  { currency: "SAR", accounting: true });    // "(500.00 ر.س)"formatCurrencyRange(1000, 5000, { currency: "SAR" });            // "1,000.00 – 5,000.00 ر.س"formatCompact(1_500_000, { locale: "ar", numerals: "arab" });    // "١٫٥ مليون"
// The Unicode currency-sign transition, as datatransitionStatus("AED");                          // "encoded" (Unicode 18.0)transitionStatus("AED", new Date("2026-01-01"));  // "announced"transitionStatus("KWD");                          // "none" — Kuwait has no signsignFontFaceCSS({ src: "/fonts/signs.woff2" });   // @font-face … unicode-range: U+20C1…U+20C4
// Number to Arabic wordsarabicToWords(1234);                     // "ألف ومئتان وأربعة وثلاثون"arabicToWords(1_000_000);               // "مليون"arabicToWords(5, { gender: "female" }); // "خمس"
// Spell money for invoices & cheques (التفقيط)spellCurrency(1234.5, { currency: "SAR" });// "ألف ومئتان وأربعة وثلاثون ريالاً وخمسون هللةً"spellCurrency(100, { currency: "SAR", suffix: true }); // "مئة ريال فقط لا غير"
// Ordinals — gender-awarearabicOrdinal(1);                        // "الأول"arabicOrdinal(25);                       // "الخامس والعشرون"arabicOrdinal(1, { gender: "female" });  // "الأولى"
// Duration & file sizeformatDuration(7_500_000);               // "ساعتان وخمس دقائق"formatFileSize(1536);                    // "1.5 كيلوبايت"
// ListsformatList(["أحمد", "محمد", "علي"]);                    // "أحمد ومحمد وعلي"formatList(["تفاح", "موز"], { type: "disjunction" });   // "تفاح أو موز"
// Hijri dates (deterministic — same output on Node, Chrome, Safari, Hermes)formatHijri(new Date("2025-09-23"));                            // "1 ربيع الآخر 1447 هـ"formatHijri(new Date("2025-09-23"), { numerals: "arab" });     // "١ ربيع الآخر ١٤٤٧ هـ"toHijri(new Date("2025-09-23"));                               // { year: 1447, month: 4, day: 1 }
// Relative timeformatRelativeTime(new Date(Date.now() - 3 * 86400_000));      // "منذ 3 أيام"
// Parse formatted strings back to numbersparseCurrency("١٬٢٣٤٫٥٠ ر.س");   // 1234.5parseCurrency("(500.00 SAR)");    // -500
// RTLisolateForeign("اتصل على +1 (555) 234-5678 الآن"); // phone stays intact in RTL
// Locale auto-detectiondetectLocale(); // "ar-SA" in a Saudi browser, "ar-EG" in Node with LANG=ar_EG

import { formatCurrency, resolveCurrencySymbol, getCurrencyInfo } from "arabicfmt/currency";
formatCurrency(1234.5, { currency: "SAR" });// → "1,234.50 ر.س"   (auto: safe text symbol, renders everywhere today)
formatCurrency(1234.5, { currency: "SAR", symbolMode: "new" });// → "1,234.50 ⃁"     (U+20C1 — use with a webfont; see webfont guide below)
formatCurrency(1234.5, { currency: "SAR", symbolMode: "code" });// → "1,234.50 SAR"   (ISO code — for accounting tables)

formatCurrency(1.2, { currency: "KWD" });  // "1.200 د.ك"  ← 3 decimalsformatCurrency(1.2, { currency: "BHD" });  // "1.200 د.ب"  ← 3 decimalsformatCurrency(1.2, { currency: "IQD" });  // "1.200 ع.د"  ← 3 decimals (ISO 4217, not CLDR's 0)formatCurrency(500, { currency: "KMF" });  // "500 ف.ج.ق"  ← 0 decimalsformatCurrency(500, { currency: "SAR" });  // "500.00 ر.س" ← 2 decimals

// Resolve from locale region — no need to know the currency codeformatCurrency(99.9,  { locale: "ar-BH" });                  // "99.900 د.ب"formatCurrency(1234,  { locale: "ar-AE", numerals: "arab", symbolMode: "text" }); // "١٬٢٣٤٫٠٠ د.إ"  (auto → U+20C3 sign)
// Accounting notation (negatives in parentheses)formatCurrency(-1234.5, { currency: "SAR", accounting: true }); // "(1,234.50 ر.س)"
// Hide/overrideformatCurrency(100, { currency: "SAR", showSymbol: false, fractionDigits: 0 }); // "100"
// Currency metadatagetCurrencyInfo("SAR");// {//   code: "SAR", digits: 2,//   symbols: { auto: "ر.س", text: "ر.س", code: "SAR", new: "⃁" },//   unicode: { codepoint: "U+20C1", unicodeVersion: "17.0", live: true, autoDefault: false },//   displayName: "ريال سعودي"// }

import { formatCurrencyRange } from "arabicfmt/currency";
formatCurrencyRange(1000, 5000, { currency: "SAR" })// "1,000.00 – 5,000.00 ر.س"     ← one symbol, the way ranges are actually set
formatCurrencyRange(1000, 5000, { currency: "SAR", symbolEach: true })// "1,000.00 ر.س – 5,000.00 ر.س"
formatCurrencyRange(1.2, 2, { currency: "KWD" })// "1.200 – 2.000 د.ك"           ← both ends share the currency's precision
formatCurrencyRange(1000, 5000, { currency: "SAR", numerals: "arab" })// "١٬٠٠٠٫٠٠ – ٥٬٠٠٠٫٠٠ ر.س"
formatCurrencyRange(50, 50, { currency: "AED" })   // "50.00 ⃃"  — collapsesformatCurrencyRange(500, 100, { currency: "SAR" }) // throws: reversed range

import { formatCurrencyToParts } from "arabicfmt/currency";
formatCurrencyToParts(1234.5, { currency: "SAR", symbolMode: "new" });// [ { type: "integer",  value: "1" },//   { type: "group",    value: "," },//   { type: "integer",  value: "234" },//   { type: "decimal",  value: "." },//   { type: "fraction", value: "50" },//   { type: "literal",  value: " " },//   { type: "currency", value: "⃁", symbolMode: "new",//     codepoint: "U+20C1", needsFont: true } ]

import { signFontFaceCSS } from "arabicfmt/currency";
signFontFaceCSS({ src: "/fonts/currency-signs.woff2" });// @font-face {//   font-family: "Arabicfmt Signs";//   src: url("/fonts/currency-signs.woff2") format("woff2");//   font-display: swap;//   unicode-range: U+20C1, U+20C2, U+20C3, U+20C4;// }
// Saudi riyal only, into a family name you already use:signFontFaceCSS({ src: "/fonts/riyal.woff2", family: "Riyal", currencies: ["SAR"] });// unicode-range: U+20C1;

import {  formatNumber, formatCompact, formatPercent,  toArabicDigits, toExtendedArabicDigits, toLatinDigits,  parseNumber, parseCurrency,  arabicToWords,  formatRelativeTime,} from "arabicfmt/number";
// StandardformatNumber(1_234_567.89, { locale: "en" });              // "1,234,567.89"formatNumber(1234.5,       { numerals: "arab" });           // "١٬٢٣٤٫٥"
// Compact / short notation — dashboards and data cardsformatCompact(1_500_000);                                   // "1.5M"formatCompact(1_500_000, { locale: "ar" });                 // "1.5 مليون"formatCompact(1_500_000, { locale: "ar", numerals: "arab" }); // "١٫٥ مليون"
// PercentformatPercent(0.853, { locale: "en" });                    // "85.3%"
// Three numeral systems: latn (default), arab, arabextformatNumber(1234.5, { numerals: "arab" });                // "١٬٢٣٤٫٥"  Eastern ArabicformatNumber(1234.5, { numerals: "arabext" });             // "۱٬۲۳۴٫۵"  Persian/Urdu
// TransliterationtoArabicDigits("Order #2026");                             // "Order #٢٠٢٦"toExtendedArabicDigits("2026");                            // "۲۰۲۶"toLatinDigits("٢٠٢٦");                                     // "2026"  (handles Persian ۰–۹ too)
// Parsing — round-trip supportparseNumber("١٬٢٣٤٫٥٦");         // 1234.56  (Eastern Arabic digits + separators)parseNumber("1,234.56");          // 1234.56  (Western)parseCurrency("١٬٢٣٤٫٥٠ ر.س");  // 1234.5parseCurrency("(500.00 SAR)");   // -500      (accounting notation)
// Relative timeformatRelativeTime(new Date(Date.now() - 3 * 86400_000));            // "منذ 3 أيام"formatRelativeTime(new Date(Date.now() + 3600_000), new Date(), { locale: "en" }); // "in 1 hour"

import { arabicToWords } from "arabicfmt";
// BasicarabicToWords(0)       // "صفر"arabicToWords(1)       // "واحد"arabicToWords(2)       // "اثنان"arabicToWords(11)      // "أحد عشر"arabicToWords(25)      // "خمسة وعشرون"arabicToWords(100)     // "مئة"arabicToWords(350)     // "ثلاثمئة وخمسون"
// ThousandsarabicToWords(1000)    // "ألف"arabicToWords(2000)    // "ألفان"arabicToWords(5000)    // "خمسة آلاف"arabicToWords(11000)   // "أحد عشر ألفاً"arabicToWords(100000)  // "مئة ألف"
// Millions / billionsarabicToWords(1_000_000)    // "مليون"arabicToWords(2_000_000)    // "مليونان"arabicToWords(5_000_000)    // "خمسة ملايين"arabicToWords(1_000_000_000)// "مليار"
// Large compositearabicToWords(1_234_567)// "مليون ومئتان وأربعة وثلاثون ألفاً وخمسمئة وسبعة وستون"
// Gender agreement — feminine noun (ليرة، روبية…)arabicToWords(3, { gender: "female" })  // "ثلاث"arabicToWords(5, { gender: "female" })  // "خمس"
// NegativearabicToWords(-42)  // "سالب اثنان وأربعون"
// Decimals — opt in (default truncates, stays backward compatible)arabicToWords(3.14, { fraction: "digits" })  // "ثلاثة فاصلة واحد أربعة"arabicToWords(3.14, { fraction: "number" })  // "ثلاثة فاصلة أربعة عشر"
// Common fractions (denominators 2–10)import { arabicFraction } from "arabicfmt";arabicFraction(1, 2)  // "نصف"arabicFraction(3, 4)  // "ثلاثة أرباع"arabicFraction(2, 3)  // "ثلثان"

import { spellCurrency } from "arabicfmt";
spellCurrency(1234.5, { currency: "SAR" })// "ألف ومئتان وأربعة وثلاثون ريالاً وخمسون هللةً"
// Unit agreement is automatic (العدد والمعدود)spellCurrency(1,   { currency: "SAR" })   // "ريال واحد"      (singular)spellCurrency(2,   { currency: "SAR" })   // "ريالان"         (dual)spellCurrency(3,   { currency: "SAR" })   // "ثلاثة ريالات"   (plural, 3–10)spellCurrency(11,  { currency: "SAR" })   // "أحد عشر ريالاً" (accusative, 11–99)spellCurrency(100, { currency: "SAR" })   // "مئة ريال"       (genitive singular)
// Minor-unit precision comes from CLDR — KWD = 1000 fils, SAR = 100 halalasspellCurrency(1.5, { currency: "KWD" })   // "دينار واحد وخمسمئة فلس"spellCurrency(0.75, { currency: "SAR" })  // "خمس وسبعون هللةً"
// Cheque-ready ending and locale-derived currencyspellCurrency(100, { currency: "SAR", suffix: true }) // "مئة ريال فقط لا غير"spellCurrency(-5,  { locale: "ar-AE" })               // "سالب خمسة دراهم"

import { arabicOrdinal } from "arabicfmt";
arabicOrdinal(1)    // "الأول"arabicOrdinal(2)    // "الثاني"arabicOrdinal(10)   // "العاشر"arabicOrdinal(11)   // "الحادي عشر"arabicOrdinal(25)   // "الخامس والعشرون"
// Gender agreementarabicOrdinal(1, { gender: "female" })   // "الأولى"arabicOrdinal(25, { gender: "female" })  // "الخامسة والعشرون"
// Indefinite (drop the article ال)arabicOrdinal(3, { definite: false })    // "ثالث"arabicOrdinal(25, { definite: false })   // "خامس وعشرون"

import { formatDuration } from "arabicfmt";
formatDuration(7_500_000)                  // "ساعتان وخمس دقائق"  (2h 5m)formatDuration(90, { input: "s" })         // "دقيقة واحدة وثلاثون ثانيةً"formatDuration(3_600_000, { largest: 1 })  // "ساعة واحدة"formatDuration(2 * 86_400_000)             // "يومان"formatDuration(500)                        // "أقل من ثانية"
// Restrict the units consideredformatDuration(125 * 60_000, { units: ["minute"], largest: 1 })// "مئة وخمس وعشرون دقيقةً"

import { formatFileSize } from "arabicfmt";
formatFileSize(0)                          // "0 بايت"formatFileSize(1536)                       // "1.5 كيلوبايت"formatFileSize(5 * 1024 * 1024)            // "5 ميجابايت"formatFileSize(1_500_000, { base: 1000 })  // "1.5 ميجابايت"  (decimal/SI)formatFileSize(2048, { numerals: "arab" }) // "٢ كيلوبايت"formatFileSize(2048, { unitStyle: "latin" })// "2 KB"

import { arabicPluralForm, arabicPlural } from "arabicfmt";
// Get the CLDR form namearabicPluralForm(0)    // "zero"arabicPluralForm(1)    // "one"arabicPluralForm(2)    // "two"arabicPluralForm(5)    // "few"   (3–10)arabicPluralForm(15)   // "many"  (11–99)arabicPluralForm(100)  // "other"
// Select the right stringconst forms = {  zero:  "لا كتب",  one:   "كتاب واحد",  two:   "كتابان",  few:   "كتب",       // 3–10  many:  "كتاباً",    // 11–99  other: "كتاب",};
arabicPlural(0,   forms)  // "لا كتب"arabicPlural(1,   forms)  // "كتاب واحد"arabicPlural(2,   forms)  // "كتابان"arabicPlural(5,   forms)  // "كتب"arabicPlural(25,  forms)  // "كتاباً"arabicPlural(100, forms)  // "كتاب"

import { toHijri, fromHijri, formatHijri, umalquraToGregorian } from "arabicfmt/umalqura";
// ConverttoHijri(new Date("2025-09-23"))        // { year: 1447, month: 4, day: 1 }umalquraToGregorian(1447, 9, 1)        // JavaScript Date — first day of Ramadan 1447
// Format — ArabicformatHijri(new Date("2025-09-23"))// "1 ربيع الآخر 1447 هـ"
formatHijri(new Date("2025-09-23"), { numerals: "arab" })// "١ ربيع الآخر ١٤٤٧ هـ"
// Format — EnglishformatHijri(new Date("2025-09-23"), { locale: "en" })// "1 Rabi al-Thani 1447 AH"
// Format — ISO-style numericformatHijri(new Date("2025-09-23"), {  locale: "en", month: "2-digit", day: "2-digit", order: "ymd", era: false,})// "1447/04/01"

import {  HIJRI_MONTHS_AR,     // Arabic Hijri month names  HIJRI_MONTHS_EN,     // English Hijri month names  GREGORIAN_MONTHS_AR, // Arabic Gregorian month names (يناير، فبراير…)  GREGORIAN_MONTHS_EN,  ARABIC_WEEKDAYS_AR,  // Arabic weekday names (الأحد، الاثنين…)  ARABIC_WEEKDAYS_EN,} from "arabicfmt/date";
HIJRI_MONTHS_AR[8]        // "رمضان"  (index 0 = Muharram)GREGORIAN_MONTHS_AR[0]    // "يناير"  (index 0 = January)ARABIC_WEEKDAYS_AR[5]     // "الجمعة" (index 0 = Sunday)

import { detectDirection, isolate, isolateForeign, stripBidi } from "arabicfmt/bidi";
// Before fix: "+1 (555) 234-5678" flips the area code in RTL context// After fix:  the phone number is wrapped in Unicode isolates — sentence intactisolateForeign("اتصل على +1 (555) 234-5678 الآن");
detectDirection("مرحبا");   // "rtl"detectDirection("Hello");   // "ltr"
isolate("9:41 AM");         // FSI … PDI isolate around a mixed runstripBidi(dirtyStr);        // remove every Unicode bidi control character

import {  stripTashkeel,  normalizeArabic,  normalizeForSearch,  sortArabic,  compareArabic,} from "arabicfmt/text";
stripTashkeel("مُحَمَّد")        // "محمد"normalizeArabic("الأحمد")        // "الاحمد"  (alef variants unified)
// Robust search — these two strings produce the same key:normalizeForSearch("مُؤسَّسة") === normalizeForSearch("موسسه")  // true
// Arabic-locale collationsortArabic(["ياسر", "أحمد", "بسام"])   // ["أحمد", "بسام", "ياسر"]["ج", "أ", "ب"].sort(compareArabic)    // ["أ", "ب", "ج"]

import { formatList } from "arabicfmt";
formatList(["أحمد", "محمد", "علي"])                      // "أحمد ومحمد وعلي"formatList(["تفاح", "موز", "برتقال"], { type: "disjunction" }) // "تفاح أو موز أو برتقال"formatList([1, 2, 3], { numerals: "arab" })              // "١ و٢ و٣"

import { transliterate, slugify } from "arabicfmt";
transliterate("مُحَمَّد")    // "muhammad"   (vowelled)transliterate("محمد")        // "mhmd"       (bare → consonant-only)transliterate("الرياض")      // "alryad"transliterate("غرفة ٢٠١")    // "ghrfh 201"  (digits converted)
slugify("مدينة جدة")                      // "mdynh-jdh"slugify("الرياض 2026")                    // "alryad-2026"slugify("Hello العالم", { separator: "_" }) // "hello_alalm"slugify("Hello World", { lowercase: false }) // "Hello-World"

import { isValidIBAN, formatIBAN, isValidSaudiId, saudiIdType } from "arabicfmt";
isValidIBAN("SA03 8000 0000 6080 1016 7519")  // trueisValidIBAN("SA03 8000 0000 6080 1016 7510")  // false (bad checksum)formatIBAN("SA0380000000608010167519")        // "SA03 8000 0000 6080 1016 7519"
isValidSaudiId("1012345672")                  // truesaudiIdType("1012345672")                     // "citizen"saudiIdType("2100000005")                     // "resident"  (Iqama)

import { formatCurrency } from "arabicfmt";
// composableexport function useArabicCurrency(currency: string) {  return (amount: number) =>    formatCurrency(amount, { currency, numerals: "arab" });}

import { formatCurrency, detectLocale } from "arabicfmt";import { formatHijri } from "arabicfmt/umalqura";
app.get("/invoice/:id", (req, res) => {  const locale = req.headers["accept-language"]?.split(",")[0] ?? "ar-SA";  const total  = formatCurrency(order.total, { locale });  const date   = formatHijri(order.date, { locale: "ar" });  res.json({ total, date });});

import { detectLocale } from "arabicfmt";
// Browser: reads navigator.language// Node.js: reads LANG / LANGUAGE / LC_ALL / LC_MESSAGES env vars// Fallback: "ar"
const locale = detectLocale(); // "ar-SA", "ar-EG", "en-US", …formatCurrency(1234, { locale });

import { formatCurrency, spellCurrency } from "arabicfmt/currency";import { formatNumber, arabicToWords, formatDuration, formatFileSize } from "arabicfmt/number";import { formatHijri, toHijri }  from "arabicfmt/date";       // tabular core (tiny)import { formatHijri, toHijri }  from "arabicfmt/umalqura";   // accurate, opt-inimport { isolateForeign }        from "arabicfmt/bidi";import { normalizeForSearch, arabicPlural, slugify } from "arabicfmt/text";import { isValidIBAN, isValidSaudiId }      from "arabicfmt/validate";

import {  transitionStatus,  listCurrencyTransitions,  getCurrencyTransition,} from "arabicfmt/currency";
transitionStatus("SAR")                          // "encoded"transitionStatus("SAR", new Date("2025-03-01"))  // "announced" — SAMA had it, Unicode didn'ttransitionStatus("AED", new Date("2026-01-01"))  // "announced"transitionStatus("KWD")                          // "none" — no sign exists
listCurrencyTransitions({ unicodeVersion: "18.0" }).map((t) => t.code);// ["MVR", "AED", "OMR"]
getCurrencyTransition("OMR");// {//   code: "OMR", sign: "⃄", codepoint: "U+20C4", name: "OMANI RIAL SIGN",//   unicodeVersion: "18.0", unicodeReleased: "2026-09-16",//   announced: "2025-11-19", authority: "Central Bank of Oman (CBO)",//   autoDefault: true, textSymbol: "ر.ع.",// }