persian-number-input 4.0.5 → 4.0.7

package/dist/components/PersianNumberInput.d.ts

@@ -1,10 +1,19 @@
 import React from 'react';
 import type { TransformNumberOptions } from '../utils/transformNumber';
-interface PersianNumberInputProps extends TransformNumberOptions, Omit<React.InputHTMLAttributes<HTMLInputElement>, 'onChange' | 'value'> {
-    onValueChange?: (value: string | undefined) => void;
+interface PersianNumberInputProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'onChange' | 'value' | 'min' | 'max'>, // min/max از نوع input حذف شد چون خودمان هندل می‌کنیم
+Omit<TransformNumberOptions, 'maxDecimals'> {
+    /** مقدار اولیه */
     initialValue?: number | string;
+    /** تابعی که با تغییر مقدار خام (انگلیسی و بدون فرمت) فراخوانی می‌شود */
+    onValueChange?: (value: string | undefined) => void;
+    /** حداقل مقدار مجاز (اعشار پشتیبانی می‌شود) */
     min?: number;
+    /** حداکثر مقدار مجاز (اعشار پشتیبانی می‌شود) */
     max?: number;
+    /** حداکثر تعداد ارقام اعشار مجاز (undefined یعنی نامحدود) */
+    maxDecimals?: number;
+    /** کاراکتری که کاربر برای وارد کردن اعشار استفاده می‌کند (پیش‌فرض '.') */
+    inputDecimalSeparator?: string;
 }
 declare const PersianNumberInput: React.FC<PersianNumberInputProps>;
 export default PersianNumberInput;

package/dist/components/PersianNumberInput.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PersianNumberInput.d.ts","sourceRoot":"","sources":["../../src/components/PersianNumberInput.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAGvE,UAAU,uBACN,SAAQ,sBAAsB,EAC9B,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC;IAEvE,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IACpD,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,QAAA,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC,uBAAuB,CAiDzD,CAAC;AAEF,eAAe,kBAAkB,CAAC"}
+{"version":3,"file":"PersianNumberInput.d.ts","sourceRoot":"","sources":["../../src/components/PersianNumberInput.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAGvE,UAAU,uBACN,SAAQ,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,KAAK,GAAG,KAAK,CAAC,EAAE,sDAAsD;AACvJ,IAAI,CAAC,sBAAsB,EAAE,aAAa,CAAC;IAE3C,kBAAkB;IAClB,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,wEAAwE;IACxE,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IACpD,+CAA+C;IAC/C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,QAAA,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC,uBAAuB,CAqDzD,CAAC;AAEF,eAAe,kBAAkB,CAAC"}

package/dist/components/PersianNumberInput.js

@@ -15,32 +15,38 @@ const jsx_runtime_1 = require("react/jsx-runtime");
 const usePersianNumberInput_1 = require("../hooks/usePersianNumberInput");
 const PersianNumberInput = (_a) => {
     var { 
-    // جدا کردن آپشن های هوک از بقیه پراپ های input
-    initialValue, separatorCount, separatorChar, locale, maxDecimals, showZero, onValueChange, min, max } = _a, 
-    // بقیه پراپ ها (مثل className, style, placeholder, id و ...) به input اصلی منتقل می شوند
-    restInputProps = __rest(_a, ["initialValue", "separatorCount", "separatorChar", "locale", "maxDecimals", "showZero", "onValueChange", "min", "max"]);
-    // اعتبارسنجی پراپ‌ها
+    // جدا کردن آپشن های هوک و نمایش از بقیه پراپ های input
+    initialValue, separatorCount, separatorChar, locale, showZero, onValueChange, min, max, maxDecimals, inputDecimalSeparator } = _a, // پراپ جدید
+    // بقیه پراپ ها (مثل className, style, placeholder, id, disabled و ...) به input اصلی منتقل می شوند
+    restInputProps = __rest(_a, ["initialValue", "separatorCount", "separatorChar", "locale", "showZero", "onValueChange", "min", "max", "maxDecimals", "inputDecimalSeparator"]);
+    // اعتبارسنجی پراپ‌ها (اختیاری ولی خوب)
     if (maxDecimals !== undefined && maxDecimals < 0) {
         console.warn('maxDecimals باید غیرمنفی باشد');
         maxDecimals = 0;
     }
     if (min !== undefined && max !== undefined && min > max) {
         console.warn('min نباید بزرگ‌تر از max باشد');
+        // شاید بهتر باشد یکی را نادیده گرفت یا خطا داد؟ فعلا فقط هشدار.
     }
-    const { value: formattedValue, onChange, rawValue, // می توانید rawValue را هم برگردانید اگر لازم است
+    const { value: formattedValue, // مقدار فرمت شده برای نمایش
+    onChange, // تابع onChange برای input
+    // setValue,          // اگر نیاز به تنظیم مقدار از بیرون دارید
+    // rawValue,          // مقدار خام انگلیسی بدون فرمت (اگر لازم دارید)
      } = (0, usePersianNumberInput_1.usePersianNumberInput)({
         initialValue,
         separatorCount,
         separatorChar,
         locale,
-        maxDecimals,
         showZero,
         onValueChange,
         min,
-        max
+        max,
+        maxDecimals,
+        inputDecimalSeparator, // پاس دادن پراپ جدید به هوک
     });
-    return ((0, jsx_runtime_1.jsx)("input", Object.assign({ type: "text" // یا "tel" هم گاهی استفاده می شود
-        , inputMode: "decimal", dir: "ltr" // معمولا برای اعداد بهتر است
+    return ((0, jsx_runtime_1.jsx)("input", Object.assign({ type: "text" // استفاده از text به جای number برای کنترل کامل فرمت
+        , inputMode: "decimal" // کیبورد مناسب در موبایل را نشان می‌دهد
+        , dir: "ltr" // برای اعداد معمولا ltr بهتر است، حتی در متن فارسی
      }, restInputProps, { value: formattedValue, onChange: onChange })));
 };
 exports.default = PersianNumberInput;

package/dist/components/PersianNumberInput.js.map

@@ -1 +1 @@
-{"version":3,"file":"PersianNumberInput.js","sourceRoot":"","sources":["../../src/components/PersianNumberInput.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;AACA,0EAAuE;AAcvE,MAAM,kBAAkB,GAAsC,CAAC,EAa9D,EAAE,EAAE;QAb0D;IAC3D,+CAA+C;IAC/C,YAAY,EACZ,cAAc,EACd,aAAa,EACb,MAAM,EACN,WAAW,EACX,QAAQ,EACR,aAAa,EACb,GAAG,EACH,GAAG,OAGN;IAFG,yFAAyF;IACtF,cAAc,cAZ0C,uHAa9D,CADoB;IAEjB,qBAAqB;IACrB,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;QAC/C,OAAO,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QAC9C,WAAW,GAAG,CAAC,CAAC;IACpB,CAAC;IACD,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,GAAG,GAAG,EAAE,CAAC;QACtD,OAAO,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,EACF,KAAK,EAAE,cAAc,EACrB,QAAQ,EACR,QAAQ,EAAE,kDAAkD;MAC/D,GAAG,IAAA,6CAAqB,EAAC;QACtB,YAAY;QACZ,cAAc;QACd,aAAa;QACb,MAAM;QACN,WAAW;QACX,QAAQ;QACR,aAAa;QACb,GAAG;QACH,GAAG;KACN,CAAC,CAAC;IAEH,OAAO,CACH,gDACI,IAAI,EAAC,MAAM,CAAC,kCAAkC;UAC9C,SAAS,EAAC,SAAS,EACnB,GAAG,EAAC,KAAK,CAAC,6BAA6B;QACnC,cAAc,IAClB,KAAK,EAAE,cAAc,EACrB,QAAQ,EAAE,QAAQ,IACpB,CACL,CAAC;AACN,CAAC,CAAC;AAEF,kBAAe,kBAAkB,CAAC"}
+{"version":3,"file":"PersianNumberInput.js","sourceRoot":"","sources":["../../src/components/PersianNumberInput.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;AAEA,0EAAuE;AAuBvE,MAAM,kBAAkB,GAAsC,CAAC,EAc9D,EAAE,EAAE;QAd0D;IAC3D,uDAAuD;IACvD,YAAY,EACZ,cAAc,EACd,aAAa,EACb,MAAM,EACN,QAAQ,EACR,aAAa,EACb,GAAG,EACH,GAAG,EACH,WAAW,EACX,qBAAqB,OAGxB,EAH0B,YAAY;IACnC,mGAAmG;IAChG,cAAc,cAb0C,gJAc9D,CADoB;IAEjB,uCAAuC;IACvC,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;QAC/C,OAAO,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QAC9C,WAAW,GAAG,CAAC,CAAC;IACpB,CAAC;IACD,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,GAAG,GAAG,EAAE,CAAC;QACtD,OAAO,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QAC9C,gEAAgE;IACpE,CAAC;IAED,MAAM,EACF,KAAK,EAAE,cAAc,EAAE,4BAA4B;IACnD,QAAQ,EAAc,2BAA2B;IACjD,+DAA+D;IAC/D,qEAAqE;MACxE,GAAG,IAAA,6CAAqB,EAAC;QACtB,YAAY;QACZ,cAAc;QACd,aAAa;QACb,MAAM;QACN,QAAQ;QACR,aAAa;QACb,GAAG;QACH,GAAG;QACH,WAAW;QACX,qBAAqB,EAAE,4BAA4B;KACtD,CAAC,CAAC;IAEH,OAAO,CACH,gDACI,IAAI,EAAC,MAAM,CAAC,qDAAqD;UACjE,SAAS,EAAC,SAAS,CAAC,wCAAwC;UAC5D,GAAG,EAAC,KAAK,CAAC,mDAAmD;QACzD,cAAc,IAClB,KAAK,EAAE,cAAc,EACrB,QAAQ,EAAE,QAAQ,IACpB,CACL,CAAC;AACN,CAAC,CAAC;AAEF,kBAAe,kBAAkB,CAAC"}

package/dist/hooks/usePersianNumberInput.d.ts

@@ -1,10 +1,12 @@
 import React from 'react';
 import { TransformNumberOptions } from '../utils/transformNumber';
-interface UsePersianNumberInputProps extends TransformNumberOptions {
+interface UsePersianNumberInputProps extends Omit<TransformNumberOptions, 'maxDecimals'> {
     initialValue?: number | string;
     onValueChange?: (value: string | undefined) => void;
     min?: number;
     max?: number;
+    maxDecimals?: number;
+    inputDecimalSeparator?: string;
 }
 interface UsePersianNumberInputReturn {
     value: string;
@@ -12,6 +14,6 @@ interface UsePersianNumberInputReturn {
     setValue: (newValue: number | string | undefined) => void;
     rawValue: string | undefined;
 }
-export declare const usePersianNumberInput: ({ initialValue, separatorCount, separatorChar, locale, maxDecimals, showZero, onValueChange, min, max, }?: UsePersianNumberInputProps) => UsePersianNumberInputReturn;
+export declare const usePersianNumberInput: ({ initialValue, separatorCount, separatorChar, locale, showZero, onValueChange, min, max, maxDecimals, inputDecimalSeparator, }?: UsePersianNumberInputProps) => UsePersianNumberInputReturn;
 export {};
 //# sourceMappingURL=usePersianNumberInput.d.ts.map

package/dist/hooks/usePersianNumberInput.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usePersianNumberInput.d.ts","sourceRoot":"","sources":["../../src/hooks/usePersianNumberInput.ts"],"names":[],"mappings":"AACA,OAAO,KAAyC,MAAM,OAAO,CAAC;AAE9D,OAAO,EAAmB,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAGnF,UAAU,0BAA2B,SAAQ,sBAAsB;IACjE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IACpD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,UAAU,2BAA2B;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,WAAW,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;IAC/D,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IAC1D,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAWD,eAAO,MAAM,qBAAqB,GAAI,2GAUnC,0BAA+B,KAAG,2BA4FpC,CAAC"}
+{"version":3,"file":"usePersianNumberInput.d.ts","sourceRoot":"","sources":["../../src/hooks/usePersianNumberInput.ts"],"names":[],"mappings":"AACA,OAAO,KAAoD,MAAM,OAAO,CAAC;AAEzE,OAAO,EAAmB,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAGnF,UAAU,0BAA2B,SAAQ,IAAI,CAAC,sBAAsB,EAAE,aAAa,CAAC;IACtF,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IACpD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,UAAU,2BAA2B;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,WAAW,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;IAC/D,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IAC1D,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAED,eAAO,MAAM,qBAAqB,GAAI,kIAWnC,0BAA+B,KAAG,2BAoHpC,CAAC"}

package/dist/hooks/usePersianNumberInput.js

@@ -9,104 +9,106 @@ const react_1 = require("react");
 const decimal_js_1 = __importDefault(require("decimal.js"));
 const transformNumber_1 = require("../utils/transformNumber");
 const digitUtils_1 = require("../utils/digitUtils");
-// اگر maxDecimals تعریف نشده باشد، اعشار حفظ می‌شود
-const roundToDecimals = (value, maxDecimals) => {
-    if (!value || !value.includes('.') || maxDecimals == null)
-        return value;
-    const [integerPart, fractionalPart] = value.split('.');
-    if (maxDecimals === 0)
-        return integerPart;
-    const trimmedFractional = fractionalPart.slice(0, maxDecimals);
-    return trimmedFractional ? `${integerPart}.${trimmedFractional}` : integerPart;
-};
-const usePersianNumberInput = ({ initialValue, separatorCount = 3, separatorChar = ',', locale = 'fa', maxDecimals, // undefined یعنی نامحدود
-showZero = false, onValueChange, min, max, } = {}) => {
-    const [rawValue, setRawValue] = (0, react_1.useState)(() => {
-        if (initialValue == null)
+const usePersianNumberInput = ({ initialValue, separatorCount = 3, separatorChar = ',', locale = 'fa', showZero = false, onValueChange, min, max, maxDecimals, inputDecimalSeparator = '.', } = {}) => {
+    const getSanitizedAndRoundedValue = (0, react_1.useCallback)((val) => {
+        if (val === null || val === undefined)
             return undefined;
-        let sanitized = (0, digitUtils_1.sanitizeNumericInput)(String(initialValue));
-        sanitized = roundToDecimals(sanitized, maxDecimals);
-        if (sanitized) {
+        let sanitized = (0, digitUtils_1.sanitizeNumericInput)(String(val), inputDecimalSeparator);
+        // مقادیر بینابینی '-', '.', '-.' را فعلا نگه دار
+        if (sanitized === '-' || sanitized === '.' || sanitized === '-.') {
+            // این مقادیر نباید به عنوان مقدار نهایی باقی بمانند اگر showZero=false
+            // در انتها بررسی می‌شود
+        }
+        else if (sanitized) { // اگر رشته خالی یا فقط بینابینی نیست
             try {
                 const numericValue = new decimal_js_1.default(sanitized);
-                if ((min !== undefined && numericValue.lt(min)) ||
-                    (max !== undefined && numericValue.gt(max))) {
-                    return undefined;
+                // ****** اصلاح مشکل ۲: Clamp کردن مقدار ******
+                if (min !== undefined && numericValue.lt(min)) {
+                    console.warn(`Value ${sanitized} is less than min ${min}. Clamping to min.`);
+                    // مقدار را به min محدود کن: min را به رشته تبدیل، sanitize و round کن
+                    const minStr = (0, digitUtils_1.sanitizeNumericInput)(String(min), '.'); // min را با نقطه استاندارد sanitize کن
+                    sanitized = (0, digitUtils_1.roundToDecimals)(minStr, maxDecimals);
+                }
+                else if (max !== undefined && numericValue.gt(max)) {
+                    console.warn(`Value ${sanitized} exceeds max ${max}. Clamping to max.`);
+                    // مقدار را به max محدود کن: max را به رشته تبدیل، sanitize و round کن
+                    const maxStr = (0, digitUtils_1.sanitizeNumericInput)(String(max), '.'); // max را با نقطه استاندارد sanitize کن
+                    sanitized = (0, digitUtils_1.roundToDecimals)(maxStr, maxDecimals);
+                }
+                else {
+                    // اگر در محدوده بود، فقط مقدار اصلی sanitize شده را گرد کن
+                    sanitized = (0, digitUtils_1.roundToDecimals)(sanitized, maxDecimals);
                 }
             }
             catch (error) {
-                console.warn(`Invalid initial value: ${sanitized}`, error);
-                return undefined;
+                // اگر در تبدیل به Decimal خطا رخ داد (مثلا برای مقادیر بینابینی نامعتبر)
+                console.warn(`Error processing sanitized value: ${sanitized}`, error);
+                return undefined; // مقدار نامعتبر است
             }
         }
-        if (parseFloat(sanitized) === 0 && !showZero && sanitized !== '0') {
+        else {
+            // اگر sanitizeNumericInput رشته خالی برگرداند
             return undefined;
         }
-        return sanitized || undefined;
-    });
-    const displayValue = (0, react_1.useMemo)(() => {
-        const options = { separatorCount, separatorChar, locale, maxDecimals, showZero };
-        if (rawValue === undefined) {
-            return showZero ? (0, transformNumber_1.transformNumber)('0', options) : '';
+        // مدیریت showZero برای مقدار نهایی (بعد از clamp و round)
+        if (!showZero) {
+            // اگر مقادیر بینابینی هستند، آنها را به undefined تبدیل کن
+            if (sanitized === '-' || sanitized === '.' || sanitized === '-.') {
+                return undefined;
+            }
+            // اگر مقدار عددی صفر است (و صرفا نقطه انتهایی ندارد)
+            try {
+                if (sanitized && new decimal_js_1.default(sanitized).isZero() && !sanitized.endsWith('.')) {
+                    return undefined;
+                }
+            }
+            catch ( /* نادیده گرفتن خطا */_a) { /* نادیده گرفتن خطا */ }
+        }
+        // در نهایت، اگر رشته خالی شده، undefined برگردان
+        return sanitized === '' ? undefined : sanitized;
+    }, [inputDecimalSeparator, min, max, maxDecimals, showZero]);
+    const [rawValue, setRawValue] = (0, react_1.useState)(() => getSanitizedAndRoundedValue(initialValue));
+    (0, react_1.useEffect)(() => {
+        // فقط اگر initialValue واقعا تغییر کرده، rawValue را آپدیت کن
+        // این از بازنشانی ناخواسته جلوگیری می‌کند
+        const newSanitized = getSanitizedAndRoundedValue(initialValue);
+        // مقایسه دقیق لازم است
+        if (newSanitized !== rawValue) {
+            // setRawValue(newSanitized); // آیا این لازم است؟ شاید باعث رفتار ناخواسته شود
         }
+        // TODO: بررسی دقیق رفتار useEffect با initialValue
+    }, [initialValue]); // getSanitizedAndRoundedValue را از وابستگی حذف کردیم تا از لوپ جلوگیری شود
+    const displayValue = (0, react_1.useMemo)(() => {
+        const options = { separatorCount, separatorChar, locale, showZero, maxDecimals };
+        // تابع transformNumber حالا باید بتواند rawValue های مختلف را به درستی نمایش دهد
         return (0, transformNumber_1.transformNumber)(rawValue, options);
-    }, [rawValue, separatorCount, separatorChar, locale, maxDecimals, showZero]);
+    }, [rawValue, separatorCount, separatorChar, locale, showZero, maxDecimals]);
     const handleChange = (0, react_1.useCallback)((event) => {
         const inputValue = event.target.value;
-        let sanitizedValue = (0, digitUtils_1.sanitizeNumericInput)(inputValue);
-        if (sanitizedValue !== rawValue) {
-            sanitizedValue = roundToDecimals(sanitizedValue, maxDecimals);
-            let valueToSet = sanitizedValue;
-            if (sanitizedValue) {
-                try {
-                    const numericValue = new decimal_js_1.default(sanitizedValue);
-                    if ((min !== undefined && numericValue.lt(min)) ||
-                        (max !== undefined && numericValue.gt(max))) {
-                        return; // خارج از محدوده
-                    }
-                }
-                catch (error) {
-                    console.warn(`Invalid input value: ${sanitizedValue}`, error);
-                    return;
-                }
-            }
-            if (parseFloat(sanitizedValue) === 0 && !showZero && sanitizedValue !== '0.') {
-                valueToSet = undefined;
+        const newRawValue = getSanitizedAndRoundedValue(inputValue);
+        // فقط اگر مقدار خام جدید با مقدار قبلی متفاوت است، آپدیت کن
+        if (newRawValue !== rawValue) {
+            setRawValue(newRawValue);
+            if (onValueChange) {
+                onValueChange(newRawValue);
             }
-            setRawValue(valueToSet);
-            if (onValueChange)
-                onValueChange(valueToSet);
         }
-    }, [rawValue, onValueChange, showZero, min, max, maxDecimals]);
+        // نکته: اگر کاربر کاراکتری وارد کند که باعث clamp شدن شود (مثلا در max)،
+        // newRawValue ممکن است با rawValue قبلی *متفاوت* باشد (برابر با max)،
+        // ولی با چیزی که کاربر تایپ کرده متفاوت است. input باید آپدیت شود تا مقدار clamp شده را نشان دهد.
+        // منطق فعلی این کار را انجام می‌دهد.
+    }, [rawValue, getSanitizedAndRoundedValue, onValueChange] // getSanitizedAndRoundedValue اینجا لازم است
+    );
     const handleSetValue = (0, react_1.useCallback)((newValue) => {
-        if (newValue == null) {
-            setRawValue(undefined);
-            if (onValueChange)
-                onValueChange(undefined);
-            return;
-        }
-        let sanitizedValue = (0, digitUtils_1.sanitizeNumericInput)(String(newValue));
-        sanitizedValue = roundToDecimals(sanitizedValue, maxDecimals);
-        if (sanitizedValue) {
-            try {
-                const numericValue = new decimal_js_1.default(sanitizedValue);
-                if ((min !== undefined && numericValue.lt(min)) ||
-                    (max !== undefined && numericValue.gt(max))) {
-                    return;
-                }
-            }
-            catch (error) {
-                console.warn(`Invalid set value: ${sanitizedValue}`, error);
-                return;
+        const newRawValue = getSanitizedAndRoundedValue(newValue);
+        if (newRawValue !== rawValue) {
+            setRawValue(newRawValue);
+            if (onValueChange) {
+                onValueChange(newRawValue);
             }
         }
-        const valueToSet = parseFloat(sanitizedValue) === 0 && !showZero && sanitizedValue !== '0.'
-            ? undefined
-            : sanitizedValue;
-        setRawValue(valueToSet);
-        if (onValueChange)
-            onValueChange(valueToSet);
-    }, [onValueChange, showZero, min, max, maxDecimals]);
+    }, [rawValue, getSanitizedAndRoundedValue, onValueChange] // getSanitizedAndRoundedValue اینجا لازم است
+    );
     return { value: displayValue, onChange: handleChange, setValue: handleSetValue, rawValue };
 };
 exports.usePersianNumberInput = usePersianNumberInput;

package/dist/hooks/usePersianNumberInput.js.map

@@ -1 +1 @@
-{"version":3,"file":"usePersianNumberInput.js","sourceRoot":"","sources":["../../src/hooks/usePersianNumberInput.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"usePersianNumberInput.js","sourceRoot":"","sources":["../../src/hooks/usePersianNumberInput.ts"],"names":[],"mappings":"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"}

package/dist/utils/digitUtils.d.ts

@@ -5,44 +5,32 @@ export declare const digitsMap: {
     [key: string]: ReadonlyArray<string>;
 };
 /**
- * نقشه جداکننده اعشار برای زبان‌های مختلف.
+ * نقشه جداکننده اعشار برای زبان‌های مختلف (برای نمایش خروجی).
  */
 export declare const decimalSeparatorMap: {
     [key: string]: string;
 };
-/**
- * تبدیل رشته حاوی ارقام محلی (مانند فارسی) به رشته با ارقام انگلیسی (0-9).
- * @param str رشته ورودی
- * @returns رشته با ارقام انگلیسی
- */
 export declare const convertToEnglishDigits: (str: string) => string;
-/**
- * تبدیل رشته حاوی ارقام انگلیسی (0-9) به رشته با ارقام محلی.
- * @param numStr رشته با ارقام انگلیسی
- * @param locale کد زبان ('fa', 'in', ...)
- * @returns رشته با ارقام محلی
- */
 export declare const toLocalizedDigits: (numStr: string, locale: keyof typeof digitsMap) => string;
-/**
- * جایگزینی جداکننده اعشار انگلیسی (.) با جداکننده محلی.
- * @param numStr رشته با ارقام و جداکننده انگلیسی
- * @param locale کد زبان
- * @returns رشته با جداکننده اعشار محلی
- */
 export declare const localizeDecimalSeparator: (numStr: string, locale: keyof typeof decimalSeparatorMap) => string;
+export declare const groupDigits: (numStr: string, separatorCount: number, separatorChar?: string) => string;
 /**
- * گروه‌بندی ارقام قسمت صحیح یک عدد با استفاده از جداکننده.
- * @param numStr قسمت صحیح عدد (فقط ارقام انگلیسی)
- * @param separatorCount تعداد ارقام در هر گروه
- * @param separatorChar کاراکتر جداکننده
- * @returns رشته گروه‌بندی شده
+ * پاک‌سازی ورودی عددی.
+ * ارقام محلی و جداکننده اعشار محلی (٫) و جداکننده دلخواه ورودی را به انگلیسی تبدیل می‌کند.
+ * کاراکترهای غیرمجاز را حذف می‌کند.
+ * فقط یک نقطه اعشار و یک علامت منفی در ابتدا را مجاز می‌داند.
+ *
+ * @param value رشته ورودی
+ * @param inputDecimalSeparator کاراکتر جداکننده اعشار که کاربر در ورودی استفاده می‌کند (پیش‌فرض '.')
+ * @returns رشته پاک‌شده با ارقام انگلیسی و نقطه استاندارد (.). می‌تواند شامل '-' یا '.' یا '-.' باشد.
  */
-export declare const groupDigits: (numStr: string, separatorCount: number, separatorChar?: string) => string;
+export declare const sanitizeNumericInput: (value: string | number | null | undefined, inputDecimalSeparator?: string) => string;
 /**
- * پاک‌سازی ورودی عددی برای اجازه دادن به کاراکترهای مجاز (اعداد، نقطه و منفی).
- * این نسخه جدید: ارقام فارسی و جداکننده اعشار فارسی را هم پشتیبانی می‌کند.
- * @param value - رشته ورودی
- * @returns رشته پاک‌شده
+ * گرد کردن یا محدود کردن تعداد ارقام اعشار یک رشته عددی (انگلیسی).
+ * مهم: این تابع نقطه انتهایی را حفظ می‌کند اگر ورودی با نقطه تمام شود و maxDecimals صفر نباشد.
+ * @param value رشته عددی با ارقام انگلیسی و نقطه استاندارد.
+ * @param maxDecimals حداکثر تعداد اعشار مجاز (undefined یعنی بدون محدودیت).
+ * @returns رشته گرد شده یا محدود شده.
  */
-export declare const sanitizeNumericInput: (value: string) => string;
+export declare const roundToDecimals: (value: string, maxDecimals?: number) => string;
 //# sourceMappingURL=digitUtils.d.ts.map

package/dist/utils/digitUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"digitUtils.d.ts","sourceRoot":"","sources":["../../src/utils/digitUtils.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAA;CAI7D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CAGxD,CAAC;AAgBF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GAAI,KAAK,MAAM,KAAG,MAGpD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,QAAQ,MAAM,EAAE,QAAQ,MAAM,OAAO,SAAS,KAAG,MAIlF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GAAI,QAAQ,MAAM,EAAE,QAAQ,MAAM,OAAO,mBAAmB,KAAG,MAInG,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GACtB,QAAQ,MAAM,EACd,gBAAgB,MAAM,EACtB,sBAAmB,KAClB,MAMF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAAI,OAAO,MAAM,KAAG,MAgCpD,CAAC"}
+{"version":3,"file":"digitUtils.d.ts","sourceRoot":"","sources":["../../src/utils/digitUtils.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAA;CAI7D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CAGxD,CAAC;AAYF,eAAO,MAAM,sBAAsB,GAAI,KAAK,MAAM,KAAG,MAGpD,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,QAAQ,MAAM,EAAE,QAAQ,MAAM,OAAO,SAAS,KAAG,MAIlF,CAAC;AAEF,eAAO,MAAM,wBAAwB,GAAI,QAAQ,MAAM,EAAE,QAAQ,MAAM,OAAO,mBAAmB,KAAG,MAInG,CAAC;AAEF,eAAO,MAAM,WAAW,GACtB,QAAQ,MAAM,EACd,gBAAgB,MAAM,EACtB,sBAAmB,KAClB,MAOF,CAAC;AAGF;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,GAC7B,OAAO,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EACzC,wBAAuB,MAAY,KACpC,MA2FF,CAAC;AAGF;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,MAAM,EAAE,cAAc,MAAM,KAAG,MAkCrE,CAAC"}

package/dist/utils/digitUtils.js

@@ -1,50 +1,37 @@
 "use strict";
 // utils/digitUtils.ts
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.sanitizeNumericInput = exports.groupDigits = exports.localizeDecimalSeparator = exports.toLocalizedDigits = exports.convertToEnglishDigits = exports.decimalSeparatorMap = exports.digitsMap = void 0;
+exports.roundToDecimals = exports.sanitizeNumericInput = exports.groupDigits = exports.localizeDecimalSeparator = exports.toLocalizedDigits = exports.convertToEnglishDigits = exports.decimalSeparatorMap = exports.digitsMap = void 0;
 /**
  * نقشه ارقام محلی برای زبان‌های مختلف.
  */
 exports.digitsMap = {
     fa: ["۰", "۱", "۲", "۳", "۴", "۵", "۶", "۷", "۸", "۹"],
     // می‌توانید زبان‌های دیگر را اضافه کنید
-    // in: ["०", "१", "२", "३", "४", "५", "६", "७", "८", "९"],
+    // ar: ["٠", "١", "٢", "٣", "٤", "٥", "٦", "٧", "٨", "٩"],
 };
 /**
- * نقشه جداکننده اعشار برای زبان‌های مختلف.
+ * نقشه جداکننده اعشار برای زبان‌های مختلف (برای نمایش خروجی).
  */
 exports.decimalSeparatorMap = {
     fa: "٫",
-    // en: ".",
+    // en: ".", // انگلیسی معمولا نقطه است
 };
-// همه ارقام محلی را به یک رشته واحد می‌چسبانیم تا regex بسازیم
+// --- توابع کمکی برای تبدیل ارقام ---
 const allLocalizedDigits = Object.values(exports.digitsMap).flat().join("");
-// مپ برای تبدیل رقم محلی به رقم انگلیسی
 const conversionMap = {};
 for (const locale in exports.digitsMap) {
     exports.digitsMap[locale].forEach((digit, index) => {
         conversionMap[digit] = index.toString();
     });
 }
-// Regex برای پیدا کردن تمام ارقام محلی
 const localizedDigitsRegex = new RegExp(`[${allLocalizedDigits}]`, 'g');
-/**
- * تبدیل رشته حاوی ارقام محلی (مانند فارسی) به رشته با ارقام انگلیسی (0-9).
- * @param str رشته ورودی
- * @returns رشته با ارقام انگلیسی
- */
 const convertToEnglishDigits = (str) => {
     if (!str)
         return "";
     return str.replace(localizedDigitsRegex, (char) => conversionMap[char] || char);
 };
 exports.convertToEnglishDigits = convertToEnglishDigits;
-/**
- * تبدیل رشته حاوی ارقام انگلیسی (0-9) به رشته با ارقام محلی.
- * @param numStr رشته با ارقام انگلیسی
- * @param locale کد زبان ('fa', 'in', ...)
- * @returns رشته با ارقام محلی
- */
 const toLocalizedDigits = (numStr, locale) => {
     if (!numStr || !exports.digitsMap[locale])
         return numStr;
@@ -52,66 +39,157 @@ const toLocalizedDigits = (numStr, locale) => {
     return numStr.replace(/\d/g, (digit) => localeDigits[parseInt(digit, 10)]);
 };
 exports.toLocalizedDigits = toLocalizedDigits;
-/**
- * جایگزینی جداکننده اعشار انگلیسی (.) با جداکننده محلی.
- * @param numStr رشته با ارقام و جداکننده انگلیسی
- * @param locale کد زبان
- * @returns رشته با جداکننده اعشار محلی
- */
 const localizeDecimalSeparator = (numStr, locale) => {
     const separator = exports.decimalSeparatorMap[locale];
-    if (!separator)
-        return numStr;
+    if (!separator || !numStr.includes('.'))
+        return numStr; // فقط اگر نقطه انگلیسی وجود داشت جایگزین کن
     return numStr.replace('.', separator);
 };
 exports.localizeDecimalSeparator = localizeDecimalSeparator;
-/**
- * گروه‌بندی ارقام قسمت صحیح یک عدد با استفاده از جداکننده.
- * @param numStr قسمت صحیح عدد (فقط ارقام انگلیسی)
- * @param separatorCount تعداد ارقام در هر گروه
- * @param separatorChar کاراکتر جداکننده
- * @returns رشته گروه‌بندی شده
- */
 const groupDigits = (numStr, separatorCount, separatorChar = ',') => {
     if (!numStr || separatorCount <= 0) {
         return numStr;
     }
+    // فقط روی قسمت صحیح اعمال شود (اگر فقط قسمت صحیح داده شده)
     const regex = new RegExp(`\\B(?=(\\d{${separatorCount}})+(?!\\d))`, 'g');
     return numStr.replace(regex, separatorChar);
 };
 exports.groupDigits = groupDigits;
 /**
- * پاک‌سازی ورودی عددی برای اجازه دادن به کاراکترهای مجاز (اعداد، نقطه و منفی).
- * این نسخه جدید: ارقام فارسی و جداکننده اعشار فارسی را هم پشتیبانی می‌کند.
- * @param value - رشته ورودی
- * @returns رشته پاک‌شده
+ * پاک‌سازی ورودی عددی.
+ * ارقام محلی و جداکننده اعشار محلی (٫) و جداکننده دلخواه ورودی را به انگلیسی تبدیل می‌کند.
+ * کاراکترهای غیرمجاز را حذف می‌کند.
+ * فقط یک نقطه اعشار و یک علامت منفی در ابتدا را مجاز می‌داند.
+ *
+ * @param value رشته ورودی
+ * @param inputDecimalSeparator کاراکتر جداکننده اعشار که کاربر در ورودی استفاده می‌کند (پیش‌فرض '.')
+ * @returns رشته پاک‌شده با ارقام انگلیسی و نقطه استاندارد (.). می‌تواند شامل '-' یا '.' یا '-.' باشد.
  */
-const sanitizeNumericInput = (value) => {
-    // ۱) تبدیل ارقام فارسی به انگلیسی
-    let normalized = (0, exports.convertToEnglishDigits)(value);
-    // ۲) تبدیل جداکننده اعشار فارسی (٫) به نقطه
-    normalized = normalized.replace(/٫/g, '.');
-    // ۳) حذف کاراکترهای غیرمجاز
-    let sanitized = normalized.replace(/[^0-9.\-]/g, '');
-    // حذف صفرهای ابتدایی مگر در موارد اعشاری
-    if (sanitized.startsWith('0') && !sanitized.startsWith('0.') && sanitized.length > 1) {
-        sanitized = sanitized.replace(/^0+/, '');
-    }
-    // نگه‌داشتن فقط یک نقطه اعشار
-    const parts = sanitized.split('.');
-    if (parts.length > 2) {
-        sanitized = `${parts[0]}.${parts[1]}`;
-    }
-    // حذف منفی‌های اضافه و اطمینان از جای صحیح آن
-    sanitized = sanitized.replace(/-+/g, '-');
-    if (sanitized.includes('-') && !sanitized.startsWith('-')) {
-        sanitized = sanitized.replace(/-/, '');
-    }
-    // اگر ورودی خالی یا فقط '-' یا '.' است، خالی برگردان
-    if (sanitized === '' || sanitized === '-' || sanitized === '.') {
+const sanitizeNumericInput = (value, inputDecimalSeparator = '.') => {
+    if (value === null || value === undefined)
         return '';
+    let str = String(value);
+    // 1. تبدیل ارقام محلی به انگلیسی
+    str = (0, exports.convertToEnglishDigits)(str);
+    // 2. تبدیل جداکننده اعشار فارسی (٫) به نقطه استاندارد (.)
+    str = str.replace(/٫/g, '.');
+    // 3. تبدیل جداکننده اعشار ورودی دلخواه (اگر با نقطه استاندارد فرق دارد) به نقطه استاندارد
+    const standardSeparator = '.';
+    if (inputDecimalSeparator && inputDecimalSeparator !== standardSeparator) {
+        // برای جلوگیری از خطای regex با کاراکترهای خاص، آن را escape می‌کنیم
+        const escapedSeparator = inputDecimalSeparator.replace(/[-\/\\^$*+?.()|[\]{}]/g, '\\$&');
+        const sepRegex = new RegExp(escapedSeparator, 'g');
+        str = str.replace(sepRegex, standardSeparator);
+    }
+    // 4. مدیریت علامت منفی: فقط یک منفی در ابتدا مجاز است
+    const negative = str.startsWith('-');
+    // تمام کاراکترهای غیر از عدد و نقطه استاندارد را حذف کن (منفی را جداگانه بررسی کردیم)
+    str = str.replace(/[^0-9.]/g, '');
+    // 5. مدیریت نقطه اعشار: فقط اولین نقطه مجاز است
+    const firstDotIndex = str.indexOf(standardSeparator);
+    if (firstDotIndex !== -1) {
+        const integerPart = str.substring(0, firstDotIndex);
+        // قسمت اعشاری شامل همه چیز بعد از نقطه اول است، و نقاط اضافی در آن حذف می‌شود
+        const fractionalPart = str.substring(firstDotIndex + 1).replace(/\./g, '');
+        str = `${integerPart}${standardSeparator}${fractionalPart}`;
+    }
+    // 6. بازگرداندن علامت منفی در صورت لزوم
+    //    فقط اگر رشته خالی نباشد و فقط نقطه نباشد، منفی را اضافه کن
+    if (negative && str !== '' && str !== standardSeparator) {
+        str = `-${str}`;
+    }
+    // 7. مدیریت صفرهای پیشرو در قسمت صحیح (بعد از پردازش منفی و نقطه)
+    // مثال: "-005.1" -> "-5.1", "005" -> "5", "0.5" -> "0.5"
+    let sign = '';
+    let numericPart = str;
+    if (str.startsWith('-')) {
+        sign = '-';
+        numericPart = str.substring(1);
+    }
+    let [intPart, fracPart] = numericPart.split(standardSeparator);
+    if (intPart && intPart.length > 1 && intPart.startsWith('0')) {
+        intPart = intPart.replace(/^0+/, '');
+        if (intPart === '')
+            intPart = '0'; // اگر فقط صفر بود، 0 بماند (مثل 0.5)
     }
-    return sanitized;
+    else if (intPart === '') {
+        // اگر رشته با نقطه شروع شود (مثلا ".5")
+        if (fracPart !== undefined) {
+            intPart = '0';
+        }
+    }
+    // بازسازی رشته نهایی
+    if (fracPart !== undefined) {
+        str = `${sign}${intPart}${standardSeparator}${fracPart}`;
+    }
+    else if (intPart !== undefined) {
+        str = `${sign}${intPart}`;
+        // اگر ورودی اصلی فقط جداکننده بود، خروجی باید '.' باشد
+        if (value === inputDecimalSeparator && sign === '') {
+            str = '.';
+        }
+        // اگر ورودی اصلی فقط '-' بود
+        if (value === '-' && sign === '-' && intPart === undefined) {
+            str = '-';
+        }
+    }
+    else if (sign === '-' && value === '-') {
+        // اگر ورودی فقط '-' بود و پردازش‌ها آن را حذف کردند
+        str = '-';
+    }
+    else {
+        // موارد دیگر که ممکن است خالی شوند
+        str = '';
+    }
+    // اجازه دادن به حالت‌های بینابینی در تایپ
+    if (value === '-')
+        return '-';
+    if (String(value).endsWith(inputDecimalSeparator) && str === `${sign}${intPart}`) {
+        // اگر کاربر جداکننده را تایپ کرده ولی هنوز عددی بعدش نیامده
+        return `${str}${standardSeparator}`;
+    }
+    return str;
 };
 exports.sanitizeNumericInput = sanitizeNumericInput;
+/**
+ * گرد کردن یا محدود کردن تعداد ارقام اعشار یک رشته عددی (انگلیسی).
+ * مهم: این تابع نقطه انتهایی را حفظ می‌کند اگر ورودی با نقطه تمام شود و maxDecimals صفر نباشد.
+ * @param value رشته عددی با ارقام انگلیسی و نقطه استاندارد.
+ * @param maxDecimals حداکثر تعداد اعشار مجاز (undefined یعنی بدون محدودیت).
+ * @returns رشته گرد شده یا محدود شده.
+ */
+const roundToDecimals = (value, maxDecimals) => {
+    // اگر مقدار نامعتبر، بدون نقطه یا بدون نیاز به گرد کردن است، همان را برگردان
+    if (maxDecimals === undefined || !value || !value.includes('.')) {
+        return value;
+    }
+    const standardSeparator = '.';
+    const endsWithSeparator = value.endsWith(standardSeparator);
+    let [integerPart, fractionalPart = ''] = value.split(standardSeparator);
+    // اگر maxDecimals صفر است، قسمت صحیح را برگردان
+    if (maxDecimals <= 0) {
+        // اگر قسمت صحیح خالی بود (مثلا در حالت '-.')، صفر را برگردان
+        return integerPart === '' && value.startsWith('-') ? "-0" : (integerPart || "0");
+        // بازگشت بهتر: فقط قسمت صحیح
+        return integerPart || "0";
+    }
+    // قسمت اعشار را به تعداد مجاز کوتاه کن
+    const trimmedFractional = fractionalPart.slice(0, maxDecimals);
+    // بازسازی رشته
+    if (trimmedFractional) {
+        return `${integerPart}${standardSeparator}${trimmedFractional}`;
+    }
+    else {
+        // اگر قسمت اعشاری بعد از کوتاه کردن خالی شد
+        // اگر ورودی اصلی با نقطه تمام شده بود، نقطه را حفظ کن
+        if (endsWithSeparator) {
+            return `${integerPart}${standardSeparator}`;
+        }
+        else {
+            // در غیر این صورت فقط قسمت صحیح را برگردان
+            return integerPart;
+        }
+    }
+};
+exports.roundToDecimals = roundToDecimals;
 //# sourceMappingURL=digitUtils.js.map

package/dist/utils/digitUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"digitUtils.js","sourceRoot":"","sources":["../../src/utils/digitUtils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"digitUtils.js","sourceRoot":"","sources":["../../src/utils/digitUtils.ts"],"names":[],"mappings":";AAAA,sBAAsB;;;AAEtB;;GAEG;AACU,QAAA,SAAS,GAA6C;IACjE,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;IACtD,wCAAwC;IACxC,0DAA0D;CAC3D,CAAC;AAEF;;GAEG;AACU,QAAA,mBAAmB,GAA8B;IAC5D,EAAE,EAAE,GAAG;IACP,sCAAsC;CACvC,CAAC;AAEF,sCAAsC;AACtC,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC,iBAAS,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACpE,MAAM,aAAa,GAA8B,EAAE,CAAC;AACpD,KAAK,MAAM,MAAM,IAAI,iBAAS,EAAE,CAAC;IAC/B,iBAAS,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QACzC,aAAa,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC;AACD,MAAM,oBAAoB,GAAG,IAAI,MAAM,CAAC,IAAI,kBAAkB,GAAG,EAAE,GAAG,CAAC,CAAC;AAEjE,MAAM,sBAAsB,GAAG,CAAC,GAAW,EAAU,EAAE;IAC5D,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,OAAO,GAAG,CAAC,OAAO,CAAC,oBAAoB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;AAClF,CAAC,CAAC;AAHW,QAAA,sBAAsB,0BAGjC;AAEK,MAAM,iBAAiB,GAAG,CAAC,MAAc,EAAE,MAA8B,EAAU,EAAE;IAC1F,IAAI,CAAC,MAAM,IAAI,CAAC,iBAAS,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IACjD,MAAM,YAAY,GAAG,iBAAS,CAAC,MAAM,CAAC,CAAC;IACvC,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;AAC7E,CAAC,CAAC;AAJW,QAAA,iBAAiB,qBAI5B;AAEK,MAAM,wBAAwB,GAAG,CAAC,MAAc,EAAE,MAAwC,EAAU,EAAE;IAC3G,MAAM,SAAS,GAAG,2BAAmB,CAAC,MAAM,CAAC,CAAC;IAC9C,IAAI,CAAC,SAAS,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,MAAM,CAAC,CAAC,4CAA4C;IACpG,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;AACxC,CAAC,CAAC;AAJW,QAAA,wBAAwB,4BAInC;AAEK,MAAM,WAAW,GAAG,CACzB,MAAc,EACd,cAAsB,EACtB,aAAa,GAAG,GAAG,EACX,EAAE;IACV,IAAI,CAAC,MAAM,IAAI,cAAc,IAAI,CAAC,EAAE,CAAC;QACnC,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,2DAA2D;IAC3D,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,cAAc,cAAc,aAAa,EAAE,GAAG,CAAC,CAAC;IACzE,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;AAC9C,CAAC,CAAC;AAXW,QAAA,WAAW,eAWtB;AAGF;;;;;;;;;GASG;AACI,MAAM,oBAAoB,GAAG,CAChC,KAAyC,EACzC,wBAAgC,GAAG,EAC7B,EAAE;IACR,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACrD,IAAI,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAExB,iCAAiC;IACjC,GAAG,GAAG,IAAA,8BAAsB,EAAC,GAAG,CAAC,CAAC;IAElC,0DAA0D;IAC1D,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAE7B,0FAA0F;IAC1F,MAAM,iBAAiB,GAAG,GAAG,CAAC;IAC9B,IAAI,qBAAqB,IAAI,qBAAqB,KAAK,iBAAiB,EAAE,CAAC;QACvE,qEAAqE;QACrE,MAAM,gBAAgB,GAAG,qBAAqB,CAAC,OAAO,CAAC,wBAAwB,EAAE,MAAM,CAAC,CAAC;QACzF,MAAM,QAAQ,GAAG,IAAI,MAAM,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;QACnD,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;IACnD,CAAC;IAED,sDAAsD;IACtD,MAAM,QAAQ,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACrC,sFAAsF;IACtF,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAElC,gDAAgD;IAChD,MAAM,aAAa,GAAG,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACrD,IAAI,aAAa,KAAK,CAAC,CAAC,EAAE,CAAC;QACvB,MAAM,WAAW,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;QACpD,8EAA8E;QAC9E,MAAM,cAAc,GAAG,GAAG,CAAC,SAAS,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC3E,GAAG,GAAG,GAAG,WAAW,GAAG,iBAAiB,GAAG,cAAc,EAAE,CAAC;IAChE,CAAC;IAED,wCAAwC;IACxC,gEAAgE;IAChE,IAAI,QAAQ,IAAI,GAAG,KAAK,EAAE,IAAI,GAAG,KAAK,iBAAiB,EAAE,CAAC;QACtD,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;IACpB,CAAC;IAED,kEAAkE;IAClE,yDAAyD;IACzD,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,IAAI,WAAW,GAAG,GAAG,CAAC;IACtB,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,IAAI,GAAG,GAAG,CAAC;QACX,WAAW,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACnC,CAAC;IAED,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAE/D,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3D,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACrC,IAAI,OAAO,KAAK,EAAE;YAAE,OAAO,GAAG,GAAG,CAAC,CAAC,qCAAqC;IAC5E,CAAC;SAAM,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;QACxB,wCAAwC;QACxC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,GAAG,GAAG,CAAC;QAClB,CAAC;IACL,CAAC;IAED,qBAAqB;IACrB,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QACzB,GAAG,GAAG,GAAG,IAAI,GAAG,OAAO,GAAG,iBAAiB,GAAG,QAAQ,EAAE,CAAC;IAC7D,CAAC;SAAM,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC/B,GAAG,GAAG,GAAG,IAAI,GAAG,OAAO,EAAE,CAAC;QAC1B,uDAAuD;QACvD,IAAI,KAAK,KAAK,qBAAqB,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;YAChD,GAAG,GAAG,GAAG,CAAC;QACf,CAAC;QACA,6BAA6B;QAC7B,IAAI,KAAK,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YACzD,GAAG,GAAG,GAAG,CAAC;QACd,CAAC;IACN,CAAC;SAAM,IAAI,IAAI,KAAK,GAAG,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;QACtC,oDAAoD;QACpD,GAAG,GAAG,GAAG,CAAC;IACf,CAAC;SAAM,CAAC;QACJ,mCAAmC;QACnC,GAAG,GAAG,EAAE,CAAC;IACb,CAAC;IAGD,0CAA0C;IACzC,IAAI,KAAK,KAAK,GAAG;QAAE,OAAO,GAAG,CAAC;IAC9B,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,qBAAqB,CAAC,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,OAAO,EAAE,EAAE,CAAC;QAC/E,4DAA4D;QAC5D,OAAO,GAAG,GAAG,GAAG,iBAAiB,EAAE,CAAC;IACxC,CAAC;IAGF,OAAO,GAAG,CAAC;AACf,CAAC,CAAC;AA9FW,QAAA,oBAAoB,wBA8F/B;AAGF;;;;;;GAMG;AACI,MAAM,eAAe,GAAG,CAAC,KAAa,EAAE,WAAoB,EAAU,EAAE;IAC3E,6EAA6E;IAC7E,IAAI,WAAW,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9D,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,MAAM,iBAAiB,GAAG,GAAG,CAAC;IAC9B,MAAM,iBAAiB,GAAG,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IAC5D,IAAI,CAAC,WAAW,EAAE,cAAc,GAAG,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAExE,gDAAgD;IAChD,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;QACnB,6DAA6D;QAC7D,OAAO,WAAW,KAAK,EAAE,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,IAAI,GAAG,CAAC,CAAC;QAChF,6BAA6B;QAC7B,OAAO,WAAW,IAAI,GAAG,CAAC;IAC/B,CAAC;IAED,uCAAuC;IACvC,MAAM,iBAAiB,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;IAE/D,eAAe;IACf,IAAI,iBAAiB,EAAE,CAAC;QACpB,OAAO,GAAG,WAAW,GAAG,iBAAiB,GAAG,iBAAiB,EAAE,CAAC;IACpE,CAAC;SAAM,CAAC;QACJ,4CAA4C;QAC5C,sDAAsD;QACtD,IAAI,iBAAiB,EAAE,CAAC;YACpB,OAAO,GAAG,WAAW,GAAG,iBAAiB,EAAE,CAAC;QAChD,CAAC;aAAM,CAAC;YACJ,2CAA2C;YAC3C,OAAO,WAAW,CAAC;QACvB,CAAC;IACL,CAAC;AACL,CAAC,CAAC;AAlCW,QAAA,eAAe,mBAkC1B"}

package/dist/utils/transformNumber.d.ts

@@ -1,21 +1,18 @@
 export interface TransformNumberOptions {
-    /** تعداد ارقام در هر گروه برای جداسازی (مثلا 3). 0 یا کمتر یعنی بدون جداسازی. */
     separatorCount?: number;
-    /** کاراکتر جداکننده گروه ها (پیش فرض ','). */
     separatorChar?: string;
-    /** کد زبان برای نمایش ارقام ('fa', 'en', ...). پیش فرض 'fa'. */
     locale?: 'fa' | 'en' | string;
-    /** حداکثر تعداد ارقام اعشار مجاز. 0 یعنی بدون اعشار. */
     maxDecimals?: number;
-    /** اگر true باشد، حتی اگر مقدار ورودی 0 باشد، آن را نمایش بده. پیش فرض false */
     showZero?: boolean;
 }
 /**
- * یک عدد یا رشته عددی را به فرمت محلی و گروه بندی شده تبدیل می کند.
+ * رشته عددی خام (انگلیسی، با نقطه استاندارد) را به فرمت نمایشی تبدیل می‌کند.
+ * فرض می‌شود ورودی از rawValue هوک آمده و قبلا sanitize و round شده است.
  *
- * @param input عدد یا رشته ورودی. می تواند شامل ارقام محلی یا انگلیسی باشد.
+ * @param rawValue رشته عددی خام (مثلا "1234.5", "15.", "-0.1", "-", ".") یا undefined.
  * @param options تنظیمات قالب بندی.
- * @returns رشته قالب بندی شده یا رشته خالی اگر ورودی نامعتبر یا صفر (و showZero=false) باشد.
+ * @returns رشته قالب بندی شده برای نمایش.
  */
-export declare const transformNumber: (input: number | string | null | undefined, options?: TransformNumberOptions) => string;
+export declare const transformNumber: (rawValue: string | undefined, // تغییر ورودی به string | undefined برای وضوح
+options?: TransformNumberOptions) => string;
 //# sourceMappingURL=transformNumber.d.ts.map

package/dist/utils/transformNumber.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transformNumber.d.ts","sourceRoot":"","sources":["../../src/utils/transformNumber.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,sBAAsB;IACrC,iFAAiF;IACjF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8CAA8C;IAC9C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,MAAM,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;IAC9B,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAC1B,OAAO,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EACzC,UAAU,sBAAsB,KAC/B,MA6EF,CAAC"}
+{"version":3,"file":"transformNumber.d.ts","sourceRoot":"","sources":["../../src/utils/transformNumber.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,sBAAsB;IACrC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAC1B,UAAU,MAAM,GAAG,SAAS,EAAE,8CAA8C;AAC5E,UAAU,sBAAsB,KAC/B,MA8FF,CAAC"}

package/dist/utils/transformNumber.js

@@ -1,75 +1,98 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.transformNumber = void 0;
 // utils/transformNumber.ts
 const digitUtils_1 = require("./digitUtils");
+const decimal_js_1 = __importDefault(require("decimal.js")); // برای بررسی دقیق صفر
 /**
- * یک عدد یا رشته عددی را به فرمت محلی و گروه بندی شده تبدیل می کند.
+ * رشته عددی خام (انگلیسی، با نقطه استاندارد) را به فرمت نمایشی تبدیل می‌کند.
+ * فرض می‌شود ورودی از rawValue هوک آمده و قبلا sanitize و round شده است.
  *
- * @param input عدد یا رشته ورودی. می تواند شامل ارقام محلی یا انگلیسی باشد.
+ * @param rawValue رشته عددی خام (مثلا "1234.5", "15.", "-0.1", "-", ".") یا undefined.
  * @param options تنظیمات قالب بندی.
- * @returns رشته قالب بندی شده یا رشته خالی اگر ورودی نامعتبر یا صفر (و showZero=false) باشد.
+ * @returns رشته قالب بندی شده برای نمایش.
  */
-const transformNumber = (input, options) => {
-    const { separatorCount = 3, // پیش فرض 3 برای هزارگان
-    separatorChar = ',', locale = 'fa', maxDecimals = 0, showZero = false, // به طور پیش فرض صفر نمایش داده نشود مگر اینکه صریحا خواسته شود
-     } = options || {};
-    if (input === null || input === undefined || input === "") {
-        return showZero ? (0, digitUtils_1.toLocalizedDigits)("0", locale) : ""; // اگر ورودی خالی است و showZero=false، خالی برگردان
-    }
-    // 1. تبدیل ورودی به رشته و سپس به ارقام انگلیسی و پاکسازی اولیه
-    //    توجه: در استفاده با input، بهتر است sanitizeNumericInput روی مقدار input *قبل* از پاس دادن به این تابع اجرا شود.
-    //    اما برای اطمینان، اینجا هم یک تبدیل اولیه انجام می دهیم.
-    let str = (0, digitUtils_1.convertToEnglishDigits)(String(input));
-    // 2. بررسی اولیه برای معتبر بودن فرمت عددی (اختیاری اما مفید)
-    //    این regex اجازه یک منفی در ابتدا و یک نقطه اعشار را می دهد.
-    if (!/^-?\d*(\.\d*)?$/.test(str)) {
-        // اگر فرمت پایه عددی نیست (بعد از تبدیل به انگلیسی)، یا خالی برگردان یا خود ورودی اصلی
-        // تصمیم: فعلا خالی بر میگردانیم یا صفر اگر showZero فعال باشد
-        console.warn(`Invalid numeric string after conversion: "${str}" from input: "${input}"`);
+const transformNumber = (rawValue, // تغییر ورودی به string | undefined برای وضوح
+options) => {
+    const { separatorCount = 3, separatorChar = ',', locale = 'fa', maxDecimals, // ممکن است برای نمایش لازم باشد (اگرچه round در هوک انجام شده)
+    showZero = false, } = options || {};
+    // 1. مدیریت ورودی‌های null/undefined/empty
+    if (rawValue === null || rawValue === undefined || rawValue === "") {
+        // نکته: تبدیل صفر به لوکال '۰' در صورت نیاز
         return showZero ? (0, digitUtils_1.toLocalizedDigits)("0", locale) : "";
     }
-    // تبدیل رشته خالی یا فقط "-" به صفر اگر showZero فعال باشد
-    if ((str === "" || str === "-") && showZero) {
-        str = "0";
+    // 2. مدیریت حالت‌های خاص که ممکن است rawValue باشند
+    if (rawValue === "-") {
+        // اگر فقط منفی است، و showZero فعال است، شاید بهتر باشد "-0" نمایش دهیم؟
+        // فعلا خود "-" را برمی‌گردانیم یا اگر showZero=false خالی؟ سازگاری مهم است.
+        // اجازه دهید نمایش "-" را بدهیم.
+        return "-"; // یا بر اساس showZero تصمیم بگیرید
     }
-    else if (str === "" || str === "-") {
-        return ""; // اگر ورودی فقط "-" بود یا خالی شد، خالی برگردان
+    if (rawValue === ".") {
+        // نمایش "۰٫" یا فقط "٫" ؟ نمایش "۰٫" خواناتر است.
+        const display = showZero ? "0." : ".";
+        const localizedDisplay = (0, digitUtils_1.localizeDecimalSeparator)(display, locale);
+        return (0, digitUtils_1.toLocalizedDigits)(localizedDisplay, locale);
     }
-    // اگر ورودی فقط "." بود
-    if (str === ".") {
-        return showZero ? (0, digitUtils_1.toLocalizedDigits)("0", locale) : "۰"; // یا شاید "۰." ؟ تصمیم با شماست. نمایش صفر منطقی تر است.
+    if (rawValue === "-.") {
+        const display = showZero ? "-0." : "-.";
+        const localizedDisplay = (0, digitUtils_1.localizeDecimalSeparator)(display, locale);
+        return (0, digitUtils_1.toLocalizedDigits)(localizedDisplay, locale);
+    }
+    // 3. اطمینان از معتبر بودن فرمت (اختیاری، چون rawValue باید معتبر باشد)
+    //    این regex نقطه انتهایی را هم قبول می‌کند
+    if (!/^-?\d*(\.\d*)?$/.test(rawValue)) {
+        console.warn(`Invalid rawValue passed to transformNumber: "${rawValue}"`);
+        return showZero ? (0, digitUtils_1.toLocalizedDigits)("0", locale) : "";
     }
-    // 3. محدود کردن تعداد ارقام اعشار
-    let [integerPart, fractionalPart] = str.split('.');
-    integerPart = integerPart || "0"; // اگر ورودی مثل ".5" بود
-    if (fractionalPart !== undefined) {
-        if (maxDecimals > 0) {
-            fractionalPart = fractionalPart.slice(0, maxDecimals);
-            // اگر بعد از بریدن، قسمت اعشاری خالی شد، آن را حذف کن
-            str = fractionalPart ? `${integerPart}.${fractionalPart}` : integerPart;
+    // 4. بررسی صفر بودن مقدار (با دقت Decimal.js)
+    let isEffectivelyZero = false;
+    try {
+        if (rawValue !== '-' && rawValue !== '.' && rawValue !== '-.') { // از Decimal با این مقادیر جلوگیری کن
+            isEffectivelyZero = new decimal_js_1.default(rawValue).isZero();
         }
-        else {
-            // اگر maxDecimals صفر است، قسمت اعشار را حذف کن
-            str = integerPart;
+    }
+    catch ( /* خطا در تبدیل به Decimal نادیده گرفته شود */_a) { /* خطا در تبدیل به Decimal نادیده گرفته شود */ }
+    if (isEffectivelyZero && !showZero) {
+        // اگر مقدار صفر است و نباید نمایش داده شود
+        // مگر اینکه کاربر در حال تایپ نقطه بعد از صفر باشد (مثل '0.')
+        if (!rawValue.endsWith('.')) {
+            return "";
         }
     }
-    else {
-        str = integerPart; // قسمت اعشاری وجود نداشت
+    // 5. جدا کردن قسمت صحیح و اعشاری
+    //    rawValue باید از قبل round شده باشد، پس نیازی به roundToDecimals مجدد نیست.
+    let [integerPart, fractionalPart] = rawValue.split('.');
+    // بررسی وجود نقطه انتهایی (وقتی fractionalPart بعد از split کردن undefined است ولی نقطه در رشته بود)
+    const hasTrailingDot = rawValue.endsWith('.') && fractionalPart === undefined;
+    // رسیدگی به حالت‌هایی مثل ".5" که integerPart خالی است
+    if (integerPart === "" || integerPart === "-") {
+        // اگر فقط "-" بود یا خالی، با صفر جایگزین کن (اگر قرار است چیزی نمایش داده شود)
+        integerPart = rawValue.startsWith('-') ? "-0" : "0";
+    }
+    // 6. گروه‌بندی ارقام قسمت صحیح
+    const sign = integerPart.startsWith('-') ? '-' : '';
+    const absIntPart = integerPart.startsWith('-') ? integerPart.substring(1) : integerPart;
+    const groupedAbsInt = (0, digitUtils_1.groupDigits)(absIntPart, separatorCount, separatorChar);
+    const groupedInt = sign + groupedAbsInt;
+    // 7. بازسازی رشته نهایی (با در نظر گرفتن نقطه انتهایی)
+    let finalStr = groupedInt;
+    if (fractionalPart !== undefined) { // اگر قسمت اعشاری وجود دارد
+        finalStr = `${groupedInt}.${fractionalPart}`;
+    }
+    else if (hasTrailingDot) { // ****** این قسمت اصلاح شده ******
+        // اگر قسمت اعشاری وجود ندارد ولی رشته اصلی با نقطه تمام شده بود
+        finalStr = `${groupedInt}.`;
     }
-    // 4. جداسازی ارقام قسمت صحیح
-    //    دوباره استخراج بخش صحیح و اعشاری چون ممکن است در مرحله 3 تغییر کرده باشد
-    [integerPart, fractionalPart] = str.split('.');
-    integerPart = integerPart || "0"; // اطمینان مجدد برای حالت "."
-    const groupedInt = (0, digitUtils_1.groupDigits)(integerPart, separatorCount, separatorChar);
-    // 5. ترکیب مجدد قسمت صحیح و اعشاری (اگر وجود دارد)
-    let finalStr = fractionalPart !== undefined ? `${groupedInt}.${fractionalPart}` : groupedInt;
-    // 6. محلی سازی (اگر locale انگلیسی نیست)
+    // 8. محلی سازی (ارقام و جداکننده اعشار)
     if (locale && locale !== 'en') {
-        // 6.1 جایگزینی جداکننده اعشار انگلیسی با محلی (قبل از تبدیل ارقام)
+        // اول جداکننده نقطه را به محلی تبدیل کن
         finalStr = (0, digitUtils_1.localizeDecimalSeparator)(finalStr, locale);
-        // 6.2 تبدیل ارقام انگلیسی به محلی
-        finalStr = (0, digitUtils_1.toLocalizedDigits)(finalStr, locale); // cast لازم است چون locale ممکن است string باشد
+        // سپس ارقام انگلیسی را به محلی تبدیل کن
+        finalStr = (0, digitUtils_1.toLocalizedDigits)(finalStr, locale);
     }
     return finalStr;
 };

package/dist/utils/transformNumber.js.map

@@ -1 +1 @@
-{"version":3,"file":"transformNumber.js","sourceRoot":"","sources":["../../src/utils/transformNumber.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"transformNumber.js","sourceRoot":"","sources":["../../src/utils/transformNumber.ts"],"names":[],"mappings":";;;;;;AAAA,2BAA2B;AAC3B,6CAQsB;AACtB,4DAAiC,CAAC,sBAAsB;AAUxD;;;;;;;GAOG;AACI,MAAM,eAAe,GAAG,CAC7B,QAA4B,EAAE,8CAA8C;AAC5E,OAAgC,EACxB,EAAE;IACV,MAAM,EACJ,cAAc,GAAG,CAAC,EAClB,aAAa,GAAG,GAAG,EACnB,MAAM,GAAG,IAAI,EACb,WAAW,EAAE,+DAA+D;IAC5E,QAAQ,GAAG,KAAK,GACjB,GAAG,OAAO,IAAI,EAAE,CAAC;IAElB,2CAA2C;IAC3C,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,EAAE,EAAE,CAAC;QACnE,4CAA4C;QAC5C,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAA,8BAAiB,EAAC,GAAG,EAAE,MAAa,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/D,CAAC;IAED,oDAAoD;IACpD,IAAI,QAAQ,KAAK,GAAG,EAAE,CAAC;QACnB,yEAAyE;QACzE,4EAA4E;QAC5E,iCAAiC;QACjC,OAAO,GAAG,CAAC,CAAC,mCAAmC;IACnD,CAAC;IACD,IAAI,QAAQ,KAAK,GAAG,EAAE,CAAC;QACnB,kDAAkD;QAClD,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;QACtC,MAAM,gBAAgB,GAAG,IAAA,qCAAwB,EAAC,OAAO,EAAE,MAAa,CAAC,CAAC;QAC1E,OAAO,IAAA,8BAAiB,EAAC,gBAAgB,EAAE,MAAa,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACnB,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QACxC,MAAM,gBAAgB,GAAG,IAAA,qCAAwB,EAAC,OAAO,EAAE,MAAa,CAAC,CAAC;QAC1E,OAAO,IAAA,8BAAiB,EAAC,gBAAgB,EAAE,MAAa,CAAC,CAAC;IAC/D,CAAC;IAGD,wEAAwE;IACxE,8CAA8C;IAC9C,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpC,OAAO,CAAC,IAAI,CAAC,gDAAgD,QAAQ,GAAG,CAAC,CAAC;QAC1E,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAA,8BAAiB,EAAC,GAAG,EAAE,MAAa,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACjE,CAAC;IAED,8CAA8C;IAC7C,IAAI,iBAAiB,GAAG,KAAK,CAAC;IAC9B,IAAI,CAAC;QACD,IAAI,QAAQ,KAAK,GAAG,IAAI,QAAQ,KAAK,GAAG,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC,CAAC,sCAAsC;YACnG,iBAAiB,GAAG,IAAI,oBAAO,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAC;QACvD,CAAC;IACL,CAAC;IAAC,QAAQ,8CAA8C,IAAhD,CAAC,CAAC,8CAA8C,CAAC,CAAC;IAE1D,IAAI,iBAAiB,IAAI,CAAC,QAAQ,EAAE,CAAC;QACjC,2CAA2C;QAC3C,8DAA8D;QAC9D,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,OAAO,EAAE,CAAC;QACd,CAAC;IACL,CAAC;IAEF,iCAAiC;IACjC,iFAAiF;IACjF,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACxD,qGAAqG;IACrG,MAAM,cAAc,GAAG,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,cAAc,KAAK,SAAS,CAAC;IAE9E,uDAAuD;IACvD,IAAI,WAAW,KAAK,EAAE,IAAI,WAAW,KAAK,GAAG,EAAE,CAAC;QAC5C,gFAAgF;QAChF,WAAW,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;IACxD,CAAC;IAED,+BAA+B;IAC/B,MAAM,IAAI,GAAG,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACpD,MAAM,UAAU,GAAG,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;IACxF,MAAM,aAAa,GAAG,IAAA,wBAAW,EAAC,UAAU,EAAE,cAAc,EAAE,aAAa,CAAC,CAAC;IAC7E,MAAM,UAAU,GAAG,IAAI,GAAG,aAAa,CAAC;IAExC,uDAAuD;IACvD,IAAI,QAAQ,GAAG,UAAU,CAAC;IAC1B,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC,CAAC,4BAA4B;QAC9D,QAAQ,GAAG,GAAG,UAAU,IAAI,cAAc,EAAE,CAAC;IAC/C,CAAC;SAAM,IAAI,cAAc,EAAE,CAAC,CAAO,mCAAmC;QACpE,gEAAgE;QAChE,QAAQ,GAAG,GAAG,UAAU,GAAG,CAAC;IAC9B,CAAC;IAED,wCAAwC;IACxC,IAAI,MAAM,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAC9B,wCAAwC;QACxC,QAAQ,GAAG,IAAA,qCAAwB,EAAC,QAAQ,EAAE,MAAa,CAAC,CAAC;QAC7D,wCAAwC;QACxC,QAAQ,GAAG,IAAA,8BAAiB,EAAC,QAAQ,EAAE,MAAa,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAjGW,QAAA,eAAe,mBAiG1B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "persian-number-input",
-  "version": "4.0.5",
+  "version": "4.0.7",
   "description": "React component for Persian, Indic, or English localized number input with customizable digit grouping",
   "main": "dist/index.js",
   "module": "dist/index.js",