@dakkiin/eida 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './useFormatDate';
+export * from './useNumbersToWords';
+export * from './useCurrency';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,qBAAqB,CAAA;AACnC,cAAc,eAAe,CAAA"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from './useFormatDate';
+export * from './useNumbersToWords';
+export * from './useCurrency';

package/dist/useCurrency.d.ts

@@ -0,0 +1,98 @@
+/**
+
+ * @packageDocumentation useCurrency
+ * @module useCurrency
+ * @description Currency conversion utilities
+ */
+export type CurrencyCode = string;
+/** ISO currency code or any consistent string identifier (e.g. "IQD", "USD"). */
+export interface ConvertCurrencyDirectOptions {
+    amount: number;
+    /** Currency the `amount` is expressed in */
+    from: CurrencyCode;
+    /** Desired output currency */
+    to: CurrencyCode;
+    /**
+     * **Units of `to` per one unit of `from`** — multiplied by `amount`.
+     *
+     * @example 1 USD = 1480 IQD → converting USD→IQD: `directRate: 1480`.
+     */
+    directRate: number;
+}
+export interface ConvertCurrencyViaBaseOptions {
+    amount: number;
+    from: CurrencyCode;
+    to: CurrencyCode;
+    /** Reference currency the `quotes` map is expressed against */
+    baseCurrency: CurrencyCode;
+    /**
+     * For each currency `c` (≠ base when converting), **`quotes[c]`** = how many units
+     * of **`c`** equal **one unit of `baseCurrency`**.
+     *
+     * @example Base USD, 1 USD = 1480 IQD → `quotes.IQD === 1480`.
+     */
+    quotes: Partial<Record<CurrencyCode, number>>;
+}
+export type ConvertCurrencyOptions = ConvertCurrencyDirectOptions | ConvertCurrencyViaBaseOptions;
+export declare const useCurrency: () => {
+    convertCurrency: typeof convertCurrency;
+    convertCurrencyWithDirectRate: typeof convertCurrencyWithDirectRate;
+    convertCurrencyViaBase: typeof convertCurrencyViaBase;
+    roundMoney: typeof roundMoney;
+};
+/** Case-insensitive (trimmed) comparison of currency codes */
+/**
+ *
+ * @param a 'usd'
+ * @param b 'USD'
+ * @returns true
+ */
+export declare function sameCurrency(a: CurrencyCode, b: CurrencyCode): boolean;
+/**
+ * Convert using one cross-rate: **`amount * directRate`** when `from` ≠ `to`.
+ *
+ * **`directRate` = units of `to` per 1 unit of `from`**.
+ */
+export declare function convertCurrencyWithDirectRate(amount: number, from: CurrencyCode, to: CurrencyCode, directRate: number): number;
+/**
+ * Convert using quotes vs a base currency.
+ *
+ * **`quotes[c]`** = units of **`c`** per **1 × `baseCurrency`**.
+ * @example
+ * 100 USD → IQD with base USD:
+ * convertCurrencyViaBase(100, 'USD', 'IQD', 'USD', { IQD: 1480 })
+ * inBase = 100, out = 100 * 1480
+ *
+ * @example
+ * 1480 IQD → USD
+ * convertCurrencyViaBase(1480, 'IQD', 'USD', 'USD', { IQD: 1480 })
+ * inBase = 1480 / 1480 = 1
+ */
+export declare function convertCurrencyViaBase(amount: number, from: CurrencyCode, to: CurrencyCode, baseCurrency: CurrencyCode, quotes: Partial<Record<CurrencyCode, number>>): number;
+/**
+     * **Usage from USD to IQD.
+     *
+     * @example
+     * convertCurrency({
+     * amount: 100,
+     * from: 'USD',
+     * to: 'IQD',
+     * directRate: 1480,
+     * }) => 148000
+     */
+/**
+     * **1 USD = 1480 IQD → 1 IQD = 1/1480 USD
+     *
+     * @example
+     * convertCurrency({
+     * amount: 100,
+     * from: 'USD',
+     * to: 'IQD',
+     * directRate: 1 / 1480,
+     * }) => 1
+     */
+/** Either **`directRate`** or **`baseCurrency` + **`quotes`** (not both shapes required on one union property set). */
+export declare function convertCurrency(options: ConvertCurrencyOptions): number;
+/** Round after conversion (fraction digits ≥ 0). */
+export declare function roundMoney(value: number, fractionDigits?: number): number;
+//# sourceMappingURL=useCurrency.d.ts.map

package/dist/useCurrency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCurrency.d.ts","sourceRoot":"","sources":["../src/useCurrency.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAA;AAEjC,iFAAiF;AAEjF,MAAM,WAAW,4BAA4B;IACzC,MAAM,EAAE,MAAM,CAAA;IACd,4CAA4C;IAC5C,IAAI,EAAE,YAAY,CAAA;IAClB,8BAA8B;IAC9B,EAAE,EAAE,YAAY,CAAA;IAChB;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,6BAA6B;IAC1C,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,YAAY,CAAA;IAClB,EAAE,EAAE,YAAY,CAAA;IAChB,+DAA+D;IAC/D,YAAY,EAAE,YAAY,CAAA;IAC1B;;;;;OAKG;IACH,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAA;CAChD;AAED,MAAM,MAAM,sBAAsB,GAAG,4BAA4B,GAAG,6BAA6B,CAAA;AAEjG,eAAO,MAAM,WAAW;;;;;CAOvB,CAAA;AAWD,8DAA8D;AAC9D;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,OAAO,CAEtE;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CACzC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,YAAY,EAClB,EAAE,EAAE,YAAY,EAChB,UAAU,EAAE,MAAM,GACnB,MAAM,CAUR;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CAClC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,YAAY,EAClB,EAAE,EAAE,YAAY,EAChB,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,GAC9C,MAAM,CA8BR;AAED;;;;;;;;;;OAUO;AAGP;;;;;;;;;;OAUO;AAEP,uHAAuH;AACvH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM,CAYvE;AAED,oDAAoD;AACpD,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,SAAI,GAAG,MAAM,CAMpE"}

package/dist/useCurrency.js

@@ -0,0 +1,119 @@
+/**
+
+ * @packageDocumentation useCurrency
+ * @module useCurrency
+ * @description Currency conversion utilities
+ */
+export const useCurrency = () => {
+    return {
+        convertCurrency,
+        convertCurrencyWithDirectRate,
+        convertCurrencyViaBase,
+        roundMoney,
+    };
+};
+function assertPositiveMultiplier(name, value) {
+    if (!Number.isFinite(value) || value <= 0)
+        throw new RangeError(`${name} must be a finite number greater than zero`);
+}
+function normalizeCode(code) {
+    return String(code).trim().toUpperCase();
+}
+/** Case-insensitive (trimmed) comparison of currency codes */
+/**
+ *
+ * @param a 'usd'
+ * @param b 'USD'
+ * @returns true
+ */
+export function sameCurrency(a, b) {
+    return normalizeCode(a) === normalizeCode(b);
+}
+/**
+ * Convert using one cross-rate: **`amount * directRate`** when `from` ≠ `to`.
+ *
+ * **`directRate` = units of `to` per 1 unit of `from`**.
+ */
+export function convertCurrencyWithDirectRate(amount, from, to, directRate) {
+    if (!Number.isFinite(amount))
+        return Number.NaN;
+    if (sameCurrency(from, to))
+        return amount;
+    assertPositiveMultiplier('directRate', directRate);
+    return amount * directRate;
+}
+/**
+ * Convert using quotes vs a base currency.
+ *
+ * **`quotes[c]`** = units of **`c`** per **1 × `baseCurrency`**.
+ * @example
+ * 100 USD → IQD with base USD:
+ * convertCurrencyViaBase(100, 'USD', 'IQD', 'USD', { IQD: 1480 })
+ * inBase = 100, out = 100 * 1480
+ *
+ * @example
+ * 1480 IQD → USD
+ * convertCurrencyViaBase(1480, 'IQD', 'USD', 'USD', { IQD: 1480 })
+ * inBase = 1480 / 1480 = 1
+ */
+export function convertCurrencyViaBase(amount, from, to, baseCurrency, quotes) {
+    if (!Number.isFinite(amount))
+        return Number.NaN;
+    const fromN = normalizeCode(from);
+    const toN = normalizeCode(to);
+    const baseN = normalizeCode(baseCurrency);
+    if (fromN === toN)
+        return amount;
+    const quoteOf = (code) => {
+        const v = quotes[normalizeCode(code)] ?? quotes[code];
+        if (v === undefined || v === null || !Number.isFinite(v) || v <= 0)
+            throw new RangeError(`Missing or invalid quote for "${code}" (units per 1 ${baseCurrency})`);
+        return v;
+    };
+    let inBase;
+    if (fromN === baseN)
+        inBase = amount;
+    else
+        inBase = amount / quoteOf(from);
+    if (toN === baseN)
+        return inBase;
+    return inBase * quoteOf(to);
+}
+/**
+     * **Usage from USD to IQD.
+     *
+     * @example
+     * convertCurrency({
+     * amount: 100,
+     * from: 'USD',
+     * to: 'IQD',
+     * directRate: 1480,
+     * }) => 148000
+     */
+/**
+     * **1 USD = 1480 IQD → 1 IQD = 1/1480 USD
+     *
+     * @example
+     * convertCurrency({
+     * amount: 100,
+     * from: 'USD',
+     * to: 'IQD',
+     * directRate: 1 / 1480,
+     * }) => 1
+     */
+/** Either **`directRate`** or **`baseCurrency` + **`quotes`** (not both shapes required on one union property set). */
+export function convertCurrency(options) {
+    const { amount, from, to } = options;
+    if ('directRate' in options && options.directRate !== undefined)
+        return convertCurrencyWithDirectRate(amount, from, to, options.directRate);
+    if ('baseCurrency' in options && options.baseCurrency !== undefined && 'quotes' in options && options.quotes !== undefined)
+        return convertCurrencyViaBase(amount, from, to, options.baseCurrency, options.quotes);
+    throw new TypeError('convertCurrency: provide either { directRate } or { baseCurrency, quotes }');
+}
+/** Round after conversion (fraction digits ≥ 0). */
+export function roundMoney(value, fractionDigits = 2) {
+    if (!Number.isFinite(value))
+        return Number.NaN;
+    const factor = 10 ** fractionDigits;
+    return Math.round(value * factor) / factor;
+}

package/dist/useFormatDate.d.ts

@@ -0,0 +1,7 @@
+export declare const useFormatDate: () => {
+    toDDMMYY: (date: string | Date | null | undefined) => string;
+    toDDMMYYYY: (date: string | Date | null | undefined) => string;
+    toDateTime: (date: string | Date | null | undefined) => string;
+    toDateTime12h: (date: string | Date | null | undefined) => string;
+};
+//# sourceMappingURL=useFormatDate.d.ts.map

package/dist/useFormatDate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormatDate.d.ts","sourceRoot":"","sources":["../src/useFormatDate.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa;qBAOE,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,KAAG,MAAM;uBAgBvC,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,KAAG,MAAM;uBAgBzC,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,KAAG,MAAM;0BActC,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,KAAG,MAAM;CAsBzE,CAAC"}

package/dist/useFormatDate.js

@@ -0,0 +1,65 @@
+export const useFormatDate = () => {
+    /**
+     * Format date to DD/MM/YY
+     * @param date Date string to format
+     * @returns Formatted date string with time (DD/MM/YY)
+     */
+    function toDDMMYY(date) {
+        if (!date)
+            return '--/--/--';
+        const parsedDate = new Date(date);
+        const day = String(parsedDate.getDate()).padStart(2, '0');
+        const month = String(parsedDate.getMonth() + 1).padStart(2, '0');
+        const year = String(parsedDate.getFullYear()).slice(-2);
+        return `${day}/${month}/${year}`;
+    }
+    /**
+     * Format date to DD/MM/YYYY
+     * @param date Date string to format
+     * @returns Formatted date string with time (DD/MM/YYYY)
+     */
+    function toDDMMYYYY(date) {
+        if (!date)
+            return '--/--/----';
+        const parsedDate = new Date(date);
+        const day = String(parsedDate.getDate()).padStart(2, '0');
+        const month = String(parsedDate.getMonth() + 1).padStart(2, '0');
+        const year = String(parsedDate.getFullYear());
+        return `${day}/${month}/${year}`;
+    }
+    /**
+ * Format date with time (used for audit logs and timestamps)
+ * @param date Date string to format
+ * @returns Formatted date string with time (YYYY/MM/DD HH:MM)
+ */
+    function toDateTime(date) {
+        if (!date)
+            return '--/--/---- --:--';
+        const parsedDate = new Date(date);
+        const day = String(parsedDate.getDate()).padStart(2, '0');
+        const month = String(parsedDate.getMonth() + 1).padStart(2, '0');
+        const year = String(parsedDate.getFullYear());
+        const hours = String(parsedDate.getHours()).padStart(2, '0');
+        const minutes = String(parsedDate.getMinutes()).padStart(2, '0');
+        return `${day}/${month}/${year} ${hours}:${minutes}`;
+    }
+    function toDateTime12h(date) {
+        if (!date)
+            return '--/--/---- --:-- --';
+        const parsedDate = new Date(date);
+        const day = String(parsedDate.getDate()).padStart(2, '0');
+        const month = String(parsedDate.getMonth() + 1).padStart(2, '0');
+        const year = String(parsedDate.getFullYear());
+        const rawHours = parsedDate.getHours();
+        const ampm = rawHours >= 12 ? 'PM' : 'AM';
+        const hours = String(rawHours % 12 || 12).padStart(2, '0');
+        const minutes = String(parsedDate.getMinutes()).padStart(2, '0');
+        return `${day}/${month}/${year} ${hours}:${minutes} ${ampm}`;
+    }
+    return {
+        toDDMMYY,
+        toDDMMYYYY,
+        toDateTime,
+        toDateTime12h
+    };
+};

package/dist/useNumbersToWords.d.ts

@@ -0,0 +1,4 @@
+export declare const useNumbersToWords: () => {
+    spell: (value: number) => string;
+};
+//# sourceMappingURL=useNumbersToWords.d.ts.map

package/dist/useNumbersToWords.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNumbersToWords.d.ts","sourceRoot":"","sources":["../src/useNumbersToWords.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB;mBAsHJ,MAAM,KAAG,MAAM;CAQxC,CAAA"}

package/dist/useNumbersToWords.js

@@ -0,0 +1,124 @@
+export const useNumbersToWords = () => {
+    const ones = {
+        0: 'صفر', 1: 'واحد', 2: 'اثنان', 3: 'ثلاثة', 4: 'أربعة',
+        5: 'خمسة', 6: 'ستة', 7: 'سبعة', 8: 'ثمانية', 9: 'تسعة',
+        10: 'عشرة', 11: 'أحد عشر', 12: 'اثنى عشر',
+    };
+    const tens = {
+        1: 'عشر', 2: 'عشرون', 3: 'ثلاثون', 4: 'أربعون',
+        5: 'خمسون', 6: 'ستون', 7: 'سبعون', 8: 'ثمانون', 9: 'تسعون',
+    };
+    const hundreds = {
+        0: 'صفر', 1: 'مائة', 2: 'مئتان', 3: 'ثلاثمائة', 4: 'أربعمائة',
+        5: 'خمسمائة', 6: 'ستمائة', 7: 'سبعمائة', 8: 'ثمانمائة', 9: 'تسعمائة',
+    };
+    const thousands = { 1: 'ألف', 2: 'ألفان', 39: 'آلاف', 1199: 'ألفًا' };
+    const millions = { 1: 'مليون', 2: 'مليونان', 39: 'ملايين', 1199: 'مليونًا' };
+    const billions = { 1: 'مليار', 2: 'ملياران', 39: 'مليارات', 1199: 'مليارًا' };
+    const trillions = { 1: 'تريليون', 2: 'تريليونان', 39: 'تريليونات', 1199: 'تريليونًا' };
+    function getNth(number, first, end) {
+        let result = '';
+        for (let i = first; i <= end; i++)
+            result += String(number).charAt(i);
+        return result;
+    }
+    function getNthReverse(number, limit) {
+        let result = '';
+        let x = 1;
+        while (x !== limit) {
+            result = String(number).charAt(number.toString().length - x) + result;
+            x++;
+        }
+        return result;
+    }
+    function oneTen(number) {
+        let value = 'صفر';
+        if (number <= 12) {
+            value = ones[number] ?? 'صفر';
+        }
+        else {
+            const first = getNth(number, 0, 0);
+            const second = getNth(number, 1, 1);
+            if (tens[+first] === 'عشر')
+                value = `${ones[+second]} ${tens[+first]}`;
+            else
+                value = `${ones[+second]} و${tens[+first]}`;
+        }
+        return value;
+    }
+    function hundred(number) {
+        while (number.toString().length !== 3)
+            number = '0' + number;
+        const first = +getNth(number, 0, 0);
+        let value = hundreds[first];
+        value = `${value} و${oneTen(parseInt(getNth(number, 1, 2)))}`;
+        return value;
+    }
+    function thousandsTrillions(one, two, three, eleven, diff, number, other) {
+        other = parseInt(other);
+        other = _tafqeet(other);
+        if (other === '')
+            other = 'صفر';
+        let value = '';
+        number = parseInt(String(number));
+        const len = number.toString().length;
+        if (len === 4 + diff) {
+            const o = parseInt(getNth(number, 0, 0));
+            if (o === 1)
+                value = `${one} و${other}`;
+            else if (o === 2)
+                value = `${two} و${other}`;
+            else
+                value = `${oneTen(o)} ${three} و${other}`;
+        }
+        else if (len === 5 + diff) {
+            const t = parseInt(getNth(number, 0, 1));
+            if (t === 10)
+                value = `${oneTen(t)} ${three} و${other}`;
+            else
+                value = `${oneTen(t)} ${eleven} و${other}`;
+        }
+        else if (len === 6 + diff) {
+            const h = parseInt(getNth(number, 0, 2));
+            const twoDigit = parseInt(getNth(number, 1, 2));
+            const th = twoDigit === 0 ? one : eleven;
+            value = `${hundred(h)} ${th} و${other}`;
+        }
+        return value;
+    }
+    function _tafqeet(number) {
+        let value = '';
+        number = parseInt(String(number));
+        if (number.toString().match(/^[0-9]+$/) !== null && number.toString().length <= 14) {
+            const len = number.toString().length;
+            if (len <= 2)
+                value = oneTen(number);
+            else if (len === 3)
+                value = hundred(number);
+            else if (len <= 6)
+                value = thousandsTrillions(thousands[1], thousands[2], thousands[39], thousands[1199], 0, number, getNthReverse(number, 4));
+            else if (len <= 9)
+                value = thousandsTrillions(millions[1], millions[2], millions[39], millions[1199], 3, number, getNthReverse(number, 7));
+            else if (len <= 12)
+                value = thousandsTrillions(billions[1], billions[2], billions[39], billions[1199], 6, number, getNthReverse(number, 10));
+            else
+                value = thousandsTrillions(trillions[1], trillions[2], trillions[39], trillions[1199], 9, number, getNthReverse(number, 13));
+        }
+        return value
+            .replace(/وصفر/g, '')
+            .replace(/وundefined/g, '')
+            .replace(/ +(?= )/g, '')
+            .replace(/صفر و/g, '')
+            .replace(/صفر/g, '')
+            .replace(/مئتان أ/, 'مائتا أ')
+            .replace(/مئتان م/, 'مائتا م');
+    }
+    function spell(value) {
+        if (!value || value === 0)
+            return '';
+        return _tafqeet(Math.round(Math.abs(value)));
+    }
+    return {
+        spell
+    };
+};

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@dakkiin/eida",
+  "type": "module",
+  "version": "0.1.0",
+  "private": false,
+  "description": "Enjaz eida formatting utilities (dates, currency, Arabic number words)",
+  "license": "UNLICENSED",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/3lawi964/packages.git",
+    "directory": "src/packages/@enjaz-eida"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "vue": "^3.5.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3",
+    "vue": "^3.5.22"
+  }
+}