@kashi-ui/persian 0.3.0 → 0.4.0

package/dist/iban.d.ts

@@ -0,0 +1,9 @@
+import type { Bank } from "./card.js";
+/** ۲۴ رقم شبا بدون IR؛ «IR12 0170…» یا «۱۲۰۱۷۰…» را می‌پذیرد */
+export declare function ibanDigits(value: string): string;
+/** اعتبارسنجی شماره شبا (IBAN ایران): IR + ۲۴ رقم با رقم‌های کنترل ISO 13616 */
+export declare function isValidIban(value: string): boolean;
+/** نام بانک از روی شبا؛ اگر شناخته نشود null */
+export declare function getBankByIban(value: string): Bank | null;
+/** IR + گروه‌های چهارتایی: IR06 0170 0000 … */
+export declare function formatIban(value: string): string;

package/dist/iban.js

@@ -0,0 +1,62 @@
+import { toEnDigits } from "./digits.js";
+// کد سه‌رقمی بانک در شبا (رقم‌های ۵ تا ۷ پس از IR). فهرست ممکن است کامل نباشد.
+const BANK_CODES = {
+    "010": { name: "بانک مرکزی", slug: "markazi" },
+    "011": { name: "بانک صنعت و معدن", slug: "bim" },
+    "012": { name: "بانک ملت", slug: "mellat" },
+    "013": { name: "بانک رفاه", slug: "refah" },
+    "014": { name: "بانک مسکن", slug: "maskan" },
+    "015": { name: "بانک سپه", slug: "sepah" },
+    "016": { name: "بانک کشاورزی", slug: "keshavarzi" },
+    "017": { name: "بانک ملی", slug: "melli" },
+    "018": { name: "بانک تجارت", slug: "tejarat" },
+    "019": { name: "بانک صادرات", slug: "saderat" },
+    "020": { name: "بانک توسعه صادرات", slug: "edbi" },
+    "021": { name: "پست بانک", slug: "postbank" },
+    "022": { name: "بانک توسعه تعاون", slug: "tosee-taavon" },
+    "053": { name: "بانک کارآفرین", slug: "karafarin" },
+    "054": { name: "بانک پارسیان", slug: "parsian" },
+    "055": { name: "بانک اقتصاد نوین", slug: "eghtesad-novin" },
+    "056": { name: "بانک سامان", slug: "saman" },
+    "057": { name: "بانک پاسارگاد", slug: "pasargad" },
+    "058": { name: "بانک سرمایه", slug: "sarmayeh" },
+    "059": { name: "بانک سینا", slug: "sina" },
+    "060": { name: "بانک قرض‌الحسنه مهر ایران", slug: "mehr-iran" },
+    "061": { name: "بانک شهر", slug: "shahr" },
+    "062": { name: "بانک آینده", slug: "ayandeh" },
+    "064": { name: "بانک گردشگری", slug: "gardeshgari" },
+    "066": { name: "بانک دی", slug: "dey" },
+    "069": { name: "بانک ایران زمین", slug: "iran-zamin" },
+    "070": { name: "بانک قرض‌الحسنه رسالت", slug: "resalat" },
+    "078": { name: "بانک خاورمیانه", slug: "khavarmianeh" },
+};
+/** ۲۴ رقم شبا بدون IR؛ «IR12 0170…» یا «۱۲۰۱۷۰…» را می‌پذیرد */
+export function ibanDigits(value) {
+    return toEnDigits(value).toUpperCase().replace(/^\s*IR/, "").replace(/\D/g, "").slice(0, 24);
+}
+/** باقیماندهٔ تقسیم یک عدد بلند (به‌صورت رشته) بر ۹۷ */
+function mod97(numeric) {
+    let r = 0;
+    for (let i = 0; i < numeric.length; i += 7)
+        r = Number(String(r) + numeric.slice(i, i + 7)) % 97;
+    return r;
+}
+/** اعتبارسنجی شماره شبا (IBAN ایران): IR + ۲۴ رقم با رقم‌های کنترل ISO 13616 */
+export function isValidIban(value) {
+    const raw = toEnDigits(value).toUpperCase().replace(/[\s-]/g, "");
+    const digits = raw.startsWith("IR") ? raw.slice(2) : raw;
+    if (!/^\d{24}$/.test(digits))
+        return false;
+    // I=18، R=27؛ دو حرف و رقم‌های کنترل به انتهای شماره منتقل می‌شوند
+    return mod97(digits.slice(2) + "1827" + digits.slice(0, 2)) === 1;
+}
+/** نام بانک از روی شبا؛ اگر شناخته نشود null */
+export function getBankByIban(value) {
+    const d = ibanDigits(value);
+    return d.length >= 5 ? (BANK_CODES[d.slice(2, 5)] ?? null) : null;
+}
+/** IR + گروه‌های چهارتایی: IR06 0170 0000 … */
+export function formatIban(value) {
+    const d = ibanDigits(value);
+    return d ? `IR${d}`.replace(/(.{4})(?=.)/g, "$1 ") : "";
+}

package/dist/index.d.ts

@@ -5,3 +5,9 @@ export type { JalaliDate, FormatJalaliOptions } from "./jalali.js";
 export { isValidNationalId } from "./national-id.js";
 export { isValidCardNumber, getBankByCard, formatCardNumber } from "./card.js";
 export type { Bank } from "./card.js";
+export { isValidIban, getBankByIban, formatIban, ibanDigits } from "./iban.js";
+export { normalizeMobile, isValidMobile, getMobileOperator, formatMobile } from "./mobile.js";
+export type { Operator } from "./mobile.js";
+export { numberToWords } from "./words.js";
+export { normalizePersian } from "./text.js";
+export type { NormalizeOptions } from "./text.js";

package/dist/index.js

@@ -2,3 +2,7 @@ export { toFaDigits, toEnDigits, onlyDigits, formatNumber } from "./digits.js";
 export { JALALI_MONTHS, WEEKDAYS, WEEKDAYS_SHORT, toJalali, toGregorian, isLeapJalaliYear, jalaliMonthLength, isValidJalaliDate, jalaliWeekday, formatJalali, parseJalali, toISODate, fromISODate, } from "./jalali.js";
 export { isValidNationalId } from "./national-id.js";
 export { isValidCardNumber, getBankByCard, formatCardNumber } from "./card.js";
+export { isValidIban, getBankByIban, formatIban, ibanDigits } from "./iban.js";
+export { normalizeMobile, isValidMobile, getMobileOperator, formatMobile } from "./mobile.js";
+export { numberToWords } from "./words.js";
+export { normalizePersian } from "./text.js";

package/dist/mobile.d.ts

@@ -0,0 +1,15 @@
+export interface Operator {
+    name: string;
+    slug: "mci" | "irancell" | "rightel";
+}
+/**
+ * شماره موبایل را به شکل استاندارد ۰۹xxxxxxxxx درمی‌آورد.
+ * +98912…، 0098912…، 98912… و 912… پذیرفته می‌شوند. اگر ساختار درست نباشد، ارقام همان‌طور برمی‌گردند.
+ */
+export declare function normalizeMobile(value: string): string;
+/** شماره موبایل ایران: ۱۱ رقم که با ۰۹ شروع می‌شود */
+export declare function isValidMobile(value: string): boolean;
+/** اپراتور از روی پیش‌شماره؛ اگر شناخته نشود null */
+export declare function getMobileOperator(value: string): Operator | null;
+/** ۰۹۱۲ ۳۴۵ ۶۷۸۹ */
+export declare function formatMobile(value: string): string;

package/dist/mobile.js

@@ -0,0 +1,38 @@
+import { onlyDigits } from "./digits.js";
+const MCI = { name: "همراه اول", slug: "mci" };
+const IRANCELL = { name: "ایرانسل", slug: "irancell" };
+const RIGHTEL = { name: "رایتل", slug: "rightel" };
+// پیش‌شماره‌ها پس از ۰۹؛ فهرست اپراتورهای اصلی، ممکن است کامل نباشد
+const PREFIXES = {
+    ...Object.fromEntries(["10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "90", "91", "92", "93", "94"].map((p) => [p, MCI])),
+    ...Object.fromEntries(["01", "02", "03", "04", "05", "30", "33", "35", "36", "37", "38", "39", "41"].map((p) => [p, IRANCELL])),
+    ...Object.fromEntries(["20", "21", "22"].map((p) => [p, RIGHTEL])),
+};
+/**
+ * شماره موبایل را به شکل استاندارد ۰۹xxxxxxxxx درمی‌آورد.
+ * +98912…، 0098912…، 98912… و 912… پذیرفته می‌شوند. اگر ساختار درست نباشد، ارقام همان‌طور برمی‌گردند.
+ */
+export function normalizeMobile(value) {
+    let d = onlyDigits(value);
+    if (d.startsWith("0098"))
+        d = "0" + d.slice(4);
+    else if (d.startsWith("98") && d.length === 12)
+        d = "0" + d.slice(2);
+    else if (d.startsWith("9") && d.length === 10)
+        d = "0" + d;
+    return d;
+}
+/** شماره موبایل ایران: ۱۱ رقم که با ۰۹ شروع می‌شود */
+export function isValidMobile(value) {
+    return /^09\d{9}$/.test(normalizeMobile(value));
+}
+/** اپراتور از روی پیش‌شماره؛ اگر شناخته نشود null */
+export function getMobileOperator(value) {
+    const d = normalizeMobile(value);
+    return d.length >= 4 && d.startsWith("09") ? (PREFIXES[d.slice(2, 4)] ?? null) : null;
+}
+/** ۰۹۱۲ ۳۴۵ ۶۷۸۹ */
+export function formatMobile(value) {
+    const d = normalizeMobile(value).slice(0, 11);
+    return [d.slice(0, 4), d.slice(4, 7), d.slice(7, 11)].filter(Boolean).join(" ");
+}

package/dist/text.d.ts

@@ -0,0 +1,10 @@
+export interface NormalizeOptions {
+    /** خط ارقام خروجی؛ undefined یعنی بدون تغییر */
+    digits?: "fa" | "latin";
+}
+/**
+ * یکدست‌سازی متن فارسی برای ذخیره و جستجو:
+ * «ي» و «ى» عربی ← «ی»، «ك» ← «ک»، «ة» ← «ه»، حذف اعراب و کشیده (ـ)،
+ * و جمع کردن فاصله‌ها و نیم‌فاصله‌های تکراری.
+ */
+export declare function normalizePersian(text: string, { digits }?: NormalizeOptions): string;

package/dist/text.js

@@ -0,0 +1,23 @@
+import { toEnDigits, toFaDigits } from "./digits.js";
+/**
+ * یکدست‌سازی متن فارسی برای ذخیره و جستجو:
+ * «ي» و «ى» عربی ← «ی»، «ك» ← «ک»، «ة» ← «ه»، حذف اعراب و کشیده (ـ)،
+ * و جمع کردن فاصله‌ها و نیم‌فاصله‌های تکراری.
+ */
+export function normalizePersian(text, { digits } = {}) {
+    let out = text
+        .replace(/[يى]/g, "ی")
+        .replace(/ك/g, "ک")
+        .replace(/ة/g, "ه")
+        .replace(/[ً-ٰٟ]/g, "") // اعراب
+        .replace(/ـ/g, "") // کشیده
+        .replace(/‌{2,}/g, "‌")
+        .replace(/ *‌ */g, "‌")
+        .replace(/[ \t]{2,}/g, " ")
+        .trim();
+    if (digits === "fa")
+        out = toFaDigits(toEnDigits(out));
+    if (digits === "latin")
+        out = toEnDigits(out);
+    return out;
+}

package/dist/words.d.ts

@@ -0,0 +1,5 @@
+/**
+ * عدد به حروف فارسی: 1250000 → «یک میلیون و دویست و پنجاه هزار».
+ * برای اعداد صحیح تا ۹۹۹ تریلیون. «هزار» بدون «یک» خوانده می‌شود (۱۰۰۰ → هزار).
+ */
+export declare function numberToWords(value: number | bigint): string;

package/dist/words.js

@@ -0,0 +1,44 @@
+const ONES = ["", "یک", "دو", "سه", "چهار", "پنج", "شش", "هفت", "هشت", "نه"];
+const TEENS = ["ده", "یازده", "دوازده", "سیزده", "چهارده", "پانزده", "شانزده", "هفده", "هجده", "نوزده"];
+const TENS = ["", "", "بیست", "سی", "چهل", "پنجاه", "شصت", "هفتاد", "هشتاد", "نود"];
+const HUNDREDS = ["", "صد", "دویست", "سیصد", "چهارصد", "پانصد", "ششصد", "هفتصد", "هشتصد", "نهصد"];
+const SCALES = ["", "هزار", "میلیون", "میلیارد", "تریلیون"];
+function under1000(n) {
+    const parts = [];
+    const h = Math.floor(n / 100);
+    const rest = n % 100;
+    if (h)
+        parts.push(HUNDREDS[h]);
+    if (rest >= 10 && rest < 20)
+        parts.push(TEENS[rest - 10]);
+    else {
+        if (rest >= 20)
+            parts.push(TENS[Math.floor(rest / 10)]);
+        if (rest % 10)
+            parts.push(ONES[rest % 10]);
+    }
+    return parts.join(" و ");
+}
+/**
+ * عدد به حروف فارسی: 1250000 → «یک میلیون و دویست و پنجاه هزار».
+ * برای اعداد صحیح تا ۹۹۹ تریلیون. «هزار» بدون «یک» خوانده می‌شود (۱۰۰۰ → هزار).
+ */
+export function numberToWords(value) {
+    let n = typeof value === "bigint" ? value : BigInt(Math.trunc(value));
+    if (n === 0n)
+        return "صفر";
+    const negative = n < 0n;
+    if (negative)
+        n = -n;
+    if (n >= 10n ** 15n)
+        throw new RangeError("عدد بزرگ‌تر از حد پشتیبانی‌شده است");
+    const groups = [];
+    for (let i = 0; n > 0n; i++, n /= 1000n) {
+        const g = Number(n % 1000n);
+        if (!g)
+            continue;
+        const words = i === 1 && g === 1 ? "" : under1000(g);
+        groups.unshift([words, SCALES[i]].filter(Boolean).join(" "));
+    }
+    return (negative ? "منفی " : "") + groups.join(" و ");
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kashi-ui/persian",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "ابزارهای فارسی کاشی: تاریخ شمسی، اعتبارسنجی کد ملی و شماره کارت، ارقام فارسی",
   "type": "module",
   "main": "./dist/index.js",