persian-number-input 3.1.0 → 4.0.1

package/README.md

@@ -4,34 +4,37 @@
 
 ---
 
-[English 🇺🇸](#-english)| [فارسی 🇮🇷](#-فارسی)
+English 🇺🇸 | فارسی 🇮🇷
 
 ---
 
-## 🇺🇸 English
+## English
 
-Persian Number Input - React Component for Persian, English & Indic Number Formatting
-
-Easily input, format, and convert numbers in Persian, English, or Indic digits with customizable digit separators. Lightweight, React-compatible, and fully localized for React versions 16 to 19.
+**Persian Number Input** - A powerful React component and utility for formatting and handling numbers in Persian, English, or other localized digit systems. Perfect for multilingual applications requiring numeric inputs with customizable formatting, including decimal support.
 
 ✅ **Key Features:**
 
-- Support for Persian, English, and Indic digit localization
-- Customizable digit grouping separators (e.g., commas)
-- Automatically converts localized digits to standard English digits
-- Simple, easy-to-integrate React API
+- Supports Persian, English, and other digit localization (e.g., Indic)
+- Customizable digit grouping (e.g., thousands separator)
+- Handles decimal numbers with configurable precision using ``
+- Min/max value constraints for input validation, including decimals
+- Converts localized digits to standard English digits for processing
+- Lightweight and compatible with React 16 to 19
+- TypeScript support for robust development
 
 ### 🚀 Installation
 
+Install the package via npm or yarn:
+
 ```bash
-npm install persian-number-input
+npm install persian-number-input 
 ```
 
-![Size](./public/size.png)
+### 💻 Usage Examples
 
-### 💻 Usage Example
+#### 1. Using `PersianNumberInput` Component
 
-Simple usage example:
+This component is ideal for form inputs requiring localized number formatting.
 
 ```jsx
 import React, { useState } from "react";
@@ -42,10 +45,17 @@ const App = () => {
 
   return (
     <PersianNumberInput
-      initialValue="123456"
+      initialValue="123456.78"
       separatorCount={3}
-      lang="fa"
-      onChangeValue={(val) => setNumber(val)}
+      separatorChar=","
+      locale="fa"
+      maxDecimals={2}
+      min={0.5}
+      max={1000000.999}
+      showZero={true}
+      onValueChange={(val) => setNumber(val || "")}
+      placeholder="Enter a number"
+      className="numeric-input"
     />
   );
 };
@@ -53,85 +63,170 @@ const App = () => {
 export default App;
 ```
 
-### 🔥 Output Example
+**Output**:
+```
+Input: 123456.78
+Displayed Output: ۱۲۳,۴۵۶٫۷۸
+English Output: 123456.78
+```
+
+#### 2. Using `usePersianNumberInput` Hook
+
+The `usePersianNumberInput` hook provides fine-grained control for custom input handling.
+
+```jsx
+import React from "react";
+import { usePersianNumberInput } from "persian-number-input";
+
+const CustomInput = () => {
+  const { value, onChange, rawValue } = usePersianNumberInput({
+    initialValue: "5000.25",
+    separatorCount: 3,
+    separatorChar: ",",
+    locale: "fa",
+    maxDecimals: 2,
+    min: 0.5,
+    max: 10000.999,
+    showZero: true,
+  });
 
+  return (
+    <div>
+      <input
+        type="text"
+        inputMode="decimal"
+        value={value}
+        onChange={onChange}
+        placeholder="Enter a number"
+      />
+      <p>Raw Value: {rawValue || "N/A"}</p>
+    </div>
+  );
+};
+
+export default CustomInput;
 ```
-Input: 123456
-Displayed Output: ۱۲۳,۴۵۶
-English Output: 123456
+
+**Explanation**:
+- The hook manages the input state and formatting, returning `value` (formatted for display) and `rawValue` (English digits).
+- Use this for custom input components or non-standard form controls.
+- **Output**:
+  ```
+  Displayed Input:ავ۰٫۲۵
+  Raw Value: 5000.25
+  ```
+
+#### 3. Using `transformNumber` Utility
+
+The `transformNumber` function formats numbers without requiring a React component, ideal for display-only scenarios.
+
+```javascript
+import { transformNumber } from "persian-number-input";
+
+const number = 123456.789;
+const formatted = transformNumber(number, {
+  separatorCount: 3,
+  separatorChar: ",",
+  locale: "fa",
+  maxDecimals: 2,
+  showZero: true,
+});
+
+console.log(formatted); // Output: ۱۲۳,۴۵۶٫۷۹
 ```
 
-![Output Example](./public/output.png)
+**Explanation**:
+- Use `transformNumber` to format numbers for display in tables, labels, or other non-input contexts.
+- Supports the same options as `PersianNumberInput` (`separatorCount`, `locale`, etc.).
+- Returns a string with localized digits and formatting.
 
 ### 📚 Props Reference
 
-| Name           | Type                            | Default | Description                          |
-| -------------- | ------------------------------- | ------- | ------------------------------------ |
-| initialValue   | string                          | ""      | Initial input value                  |
-| separatorCount | number                          | 0       | Number of digits per group (e.g., 3) |
-| separatorChar  | string                          | ","     | Digit grouping character             |
-| lang           | 'fa' \| 'in' \| 'en'            | "fa"    | Digit localization language          |
-| onChangeValue  | (englishNumber: string) => void | -       | Callback function on value change    |
-
----
+| Name | Type | Default | Description |
+| --- | --- | --- | --- |
+| `initialValue` | `string | number` | `""` | Initial value of the input |
+| `separatorCount` | `number` | `3` | Number of digits per group (e.g., 3 for thousands) |
+| `separatorChar` | `string` | `","` | Character used for grouping digits (e.g., `,` or `.`) |
+| `locale` | `string` | `"fa"` | Language for digit localization (e.g., `fa`, `en`) |
+| `maxDecimals` | `number` | `0` | Maximum number of decimal places allowed |
+| `showZero` | `boolean` | `false` | If `true`, displays `0` when the input is empty or zero |
+| `min` | `number` | - | Minimum allowed value (supports decimals, e.g., `0.5`) |
+| `max` | `number` | - | Maximum allowed value (supports decimals, e.g., `1000.201`) |
+| `onValueChange` | `(value: string | undefined) => void` | - | Callback for value changes |
+| `...rest` | `InputHTMLAttributes` | - | Standard HTML input attributes (e.g., `className`, `placeholder`, `style`) |
+
+### 🌟 Why Use Persian Number Input?
+
+- **Multilingual Support**: Seamlessly handle Persian, English, or other localized digits.
+- **Customizable Formatting**: Control separators, decimals, and zero display.
+- **Robust Validation**: Enforce min/max constraints with decimal precision using ``.
+- **Developer-Friendly**: TypeScript support and a simple API for quick integration.
+- **Lightweight**: Optimized for performance with minimal dependencies.
 
 ### ❓ FAQ (Frequently Asked Questions)
 
 **Does this package support React 19?**  
-Yes, it fully supports React versions 16 through 19.
+Yes, it is fully compatible with React 16 through 19.
 
-**What is the best use-case scenario for this component?**  
-Ideal for multilingual web applications, forms, and any interface requiring localized numeric inputs.
+**Can I use decimal numbers?**  
+Yes, set `maxDecimals` to the desired number of decimal places (e.g., `maxDecimals={2}`).
 
-**How can I customize the styles of this component?**  
-You can pass custom classes or inline styles directly to the component to match your design requirements.
+**How do I enforce minimum and maximum values?**  
+Use the `min` and `max` props, which support decimals (e.g., `min={0.5}`, `max={1000.201}`).
 
----
+**How can I style the input?**  
+Pass `className` or `style` props to customize the input’s appearance.
+
+**What happens if the user enters an invalid number?**  
+The component sanitizes inputs, ensuring only valid numbers are processed, and respects min/max constraints.
 
 ### 🌟 Support the Project
 
-If you find this package helpful, **please give it a star ⭐ on GitHub** to encourage further improvements.
+If you find this package useful, **please give it a star ⭐ on GitHub** to support further development.
 
 👉 **[GitHub Repository](https://github.com/javadSharifi/persian-number-input)**
 
 Thank you for your support! ❤️🚀
 
----
-
 ### 📈 SEO Keywords
 
-`Persian Number Input`, `React Persian input`, `localization`, `digit grouping`, `Persian digits`, `React numeric input`, `number formatter`
-
----
+`Persian Number Input`, `React Persian input`, `React number formatting`, `localized numeric input`, `Persian digits`, `React numeric input`, `number formatter`, `TypeScript React component`, `multilingual input`, `React number formatting hook`, `Persian number utility`
 
 ### 📄 License
 
-[MIT License](LICENSE)
+MIT License
 
-© 2024 Your Name. All rights reserved.
+© 2025 Javad Sharifi. All rights reserved.
 
-# persian-number-input
+---
 
-## 🇮🇷 فارسی
+## فارسی
 
-کامپوننت React برای ورودی اعداد فارسی، انگلیسی و هندی با قابلیت جداکننده ارقام و محلی‌سازی کامل.
+**کامپوننت ورودی اعداد فارسی** - یک کامپوننت و ابزار قدرتمند React برای مدیریت و فرمت‌بندی اعداد به صورت فارسی، انگلیسی یا سایر سیستم‌های ارقام محلی. ایده‌آل برای برنامه‌های چندزبانه که نیاز به ورودی‌های عددی با فرمت سفارشی و پشتیبانی از اعشار دارند.
 
 ✅ **امکانات کلیدی:**
 
-- پشتیبانی از اعداد فارسی، انگلیسی و هندی
-- قابلیت تعیین جداکننده ارقام دلخواه (هزارگان)
-- تبدیل خودکار اعداد محلی به اعداد انگلیسی
-- استفاده آسان و پشتیبانی از React نسخه‌های 16 تا 19
+- پشتیبانی از ارقام فارسی، انگلیسی و سایر زبان‌ها (مانند هندی)
+- قابلیت تنظیم جداکننده ارقام (مثل هزارگان)
+
+- اعمال محدودیت‌های حداقل و حداکثر با پشتیبانی از اعشار
+- تبدیل خودکار ارقام محلی به ارقام انگلیسی برای پردازش
+- سبک و سازگار با React 16 تا 19
+- پشتیبانی از TypeScript برای توسعه امن
 
 ### 🚀 نصب
 
+پکیج را از طریق npm یا yarn نصب کنید:
+
 ```bash
-npm install persian-number-input
+npm install persian-number-input 
 ```
 
-### 💻 روش استفاده
+### 💻 مثال‌های استفاده
+
+#### ۱. استفاده از کامپوننت `PersianNumberInput`
 
-مثال ساده:
+این کامپوننت برای ورودی‌های فرم با فرمت‌بندی محلی مناسب است.
 
 ```jsx
 import React, { useState } from "react";
@@ -142,10 +237,17 @@ const App = () => {
 
   return (
     <PersianNumberInput
-      initialValue="123456"
+      initialValue="123456.78"
       separatorCount={3}
-      lang="fa"
-      onChangeValue={(val) => setNumber(val)}
+      separatorChar=","
+      locale="fa"
+      maxDecimals={2}
+      min={0.5}
+      max={1000000.999}
+      showZero={true}
+      onValueChange={(val) => setNumber(val || "")}
+      placeholder="یک عدد وارد کنید"
+      className="numeric-input"
     />
   );
 };
@@ -153,32 +255,135 @@ const App = () => {
 export default App;
 ```
 
-### 🔥 مثال خروجی
+**خروجی**:
+```
+ورودی: 123456.78
+خروجی نمایشی: ۱۲۳,۴۵۶٫۷۸
+خروجی انگلیسی: 123456.78
+```
+
+#### ۲. استفاده از هوک `usePersianNumberInput`
+
+هوک `usePersianNumberInput` برای کنترل دقیق ورودی‌های سفارشی استفاده می‌شود.
 
+```jsx
+import React from "react";
+import { usePersianNumberInput } from "persian-number-input";
+
+const CustomInput = () => {
+  const { value, onChange, rawValue } = usePersianNumberInput({
+    initialValue: "5000.25",
+    separatorCount: 3,
+    separatorChar: ",",
+    locale: "fa",
+    maxDecimals: 2,
+    min: 0.5,
+    max: 10000.999,
+    showZero: true,
+  });
+
+  return (
+    <div>
+      <input
+        type="text"
+        inputMode="decimal"
+        value={value}
+        onChange={onChange}
+        placeholder="یک عدد وارد کنید"
+      />
+      <p>مقدار خام: {rawValue || "بدون مقدار"}</p>
+    </div>
+  );
+};
+
+export default CustomInput;
 ```
-ورودی: 123456
-خروجی نمایشی: ۱۲۳,۴۵۶
-خروجی انگلیسی: 123456
+
+**توضیح**:
+- این هوک وضعیت ورودی و فرمت‌بندی را مدیریت می‌کند و `value` (برای نمایش) و `rawValue` (ارقام انگلیسی) را برمی‌گرداند.
+- برای کامپوننت‌های ورودی سفارشی یا فرم‌های غیراستاندارد مناسب است.
+- **خروجی**:
+  ```
+  ورودی نمایشی: ۵,۰۰۰٫۲۵
+  مقدار خام: 5000.25
+  ```
+
+#### ۳. استفاده از ابزار `transformNumber`
+
+تابع `transformNumber` برای فرمت‌بندی اعداد بدون نیاز به کامپوننت React مناسب است.
+
+```javascript
+import { transformNumber } from "persian-number-input";
+
+const number = 123456.789;
+const formatted = transformNumber(number, {
+  separatorCount: 3,
+  separatorChar: ",",
+  locale: "fa",
+  maxDecimals: 2,
+  showZero: true,
+});
+
+console.log(formatted); // خروجی: ۱۲۳,۴۵۶٫۷۹
 ```
 
-![مثال خروجی ](./public/output.png)
+**توضیح**:
+- از `transformNumber` برای فرمت‌بندی اعداد در جداول، برچسب‌ها یا سایر موارد غیرورودی استفاده کنید.
+- همان گزینه‌های `PersianNumberInput` (مانند `separatorCount` و `locale`) را پشتیبانی می‌کند.
+- یک رشته با ارقام محلی و فرمت‌بندی مناسب برمی‌گرداند.
 
-### 📚 مشخصات Props
+### 📚 مرجع مشخصات (Props)
 
-| نام            | نوع                             | پیشفرض | توضیح                            |
-| -------------- | ------------------------------- | ------ | -------------------------------- |
-| initialValue   | string                          | ""     | مقدار اولیه                      |
-| separatorCount | number                          | 0      | تعداد ارقام جداشده (مثلاً ۳ رقم) |
-| separatorChar  | string                          | ","    | کاراکتر جداکننده (مانند `,`)     |
-| lang           | 'fa' \| 'in' \| 'en'            | "fa"   | زبان نمایش ارقام                 |
-| onChangeValue  | (englishNumber: string) => void | -      | فراخوانی در تغییر مقدار          |
+| نام | نوع | پیش‌فرض | توضیح |
+| --- | --- | --- | --- |
+| `initialValue` | `string | number` | `""` | مقدار اولیه ورودی |
+| `separatorCount` | `number` | `3` | تعداد ارقام در هر گروه (مثلاً ۳ برای هزارگان) |
+| `separatorChar` | `string` | `","` | کاراکتر جداکننده گروه‌ها (مثلاً `,` یا `.`) |
+| `locale` | `string` | `"fa"` | زبان برای محلی‌سازی ارقام (مثلاً `fa` یا `en`) |
+| `maxDecimals` | `number` | `0` | حداکثر تعداد ارقام اعشاری مجاز |
+| `showZero` | `boolean` | `false` | اگر `true` باشد، عدد `0` را در ورودی خالی یا صفر نمایش می‌دهد |
+| `min` | `number` | - | حداقل مقدار مجاز (پشتیبانی از اعشار، مثلاً `0.5`) |
+| `max` | `number` | - | حداکثر مقدار مجاز (پشتیبانی از اعشار، مثلاً `1000.201`) |
+| `onValueChange` | `(value: string | undefined) => void` | - | فراخوانی در تغییر مقدار |
+| `...rest` | `InputHTMLAttributes` | - | ویژگی‌های استاندارد ورودی HTML (مثل `className`، `placeholder`، `style`) |
 
----
+### 🌟 چرا از این کامپوننت استفاده کنیم؟
+
+- **پشتیبانی چندزبانه**: مدیریت آسان ارقام فارسی، انگلیسی یا سایر زبان‌ها.
+- **فرمت‌بندی انعطاف‌پذیر**: کنترل جداکننده‌ها، اعشار و نمایش صفر.
+- **اعتبارسنجی قوی**: اعمال محدودیت‌های حداقل و حداکثر با دقت اعشاری با ``.
+- **مناسب توسعه‌دهندگان**: پشتیبانی از TypeScript و API ساده برای ادغام سریع.
+- **سبک و سریع**: بهینه‌شده برای عملکرد با حداقل وابستگی‌ها.
+
+### ❓ سوالات متداول
+
+**آیا این پکیج از React 19 پشتیبانی می‌کند؟**  
+بله، کاملاً با React 16 تا 19 سازگار است.
+
+**آیا می‌توان از اعداد اعشاری استفاده کرد؟**  
+بله، با تنظیم `maxDecimals` می‌توانید تعداد ارقام اعشاری را مشخص کنید (مثلاً `maxDecimals={2}`).
+
+**چگونه می‌توان حداقل و حداکثر مقدار را اعمال کرد؟**  
+از پراپ‌های `min` و `max` استفاده کنید که از اعشار پشتیبانی می‌کنند (مثلاً `min={0.5}` و `max={1000.201}`).
+
+**چگونه ظاهر ورودی را سفارشی کنم؟**  
+با پراپ‌های `className` یا `style` می‌توانید ظاهر ورودی را تغییر دهید.
+
+**اگر کاربر عدد نامعتبری وارد کند چه می‌شود؟**  
+کامپوننت ورودی‌ها را پاکسازی می‌کند و فقط اعداد معتبر را پردازش می‌کند، ضمن رعایت محدودیت‌های min/max.
 
 ### 🌟 حمایت از پروژه
 
-اگر این پکیج برای شما مفید بود، **لطفاً یک ستاره به مخزن GitHub بدهید ⭐**. این بهترین راه برای حمایت از پروژه و تشویق توسعه‌دهنده به بهبود آن است.
+اگر این پکیج برای شما مفید بود، **لطفاً یک ستاره ⭐ به مخزن GitHub بدهید** تا توسعه بیشتر آن را تشویق کنید.
 
-👉 **[GitHub Repository](https://github.com/javadSharifi/persian-number-input)**
+👉 **[مخزن GitHub](https://github.com/javadSharifi/persian-number-input)**
+
+از حمایت شما سپاسگزاریم! ❤️🚀
+
+### 📈 کلمات کلیدی برای جستجو
+
+`ورودی اعداد فارسی`, `کامپوننت React فارسی`, `فرمت‌بندی اعداد در React`, `ورودی عددی محلی‌سازی‌شده`, `ارقام فارسی`, `ورودی عددی React`, `فرمت‌کننده اعداد`, `کامپوننت TypeScript React`, `ورودی چندزبانه`, `هوک فرمت‌بندی اعداد`, `ابزار اعداد فارسی`
+
+### 📄 مجوز
 
-از حمایت شما متشکریم! ❤️🚀
+MIT License

package/dist/components/PersianNumberInput.d.ts

@@ -1,12 +1,11 @@
 import React from 'react';
-interface PersianNumberInputCustomProps {
-    initialValue?: string;
-    separatorCount?: number;
-    separatorChar?: string;
-    lang?: 'fa' | 'in' | 'en';
-    onChangeValue?: (englishNumber: string) => void;
+import type { TransformNumberOptions } from '../utils/transformNumber';
+interface PersianNumberInputProps extends TransformNumberOptions, Omit<React.InputHTMLAttributes<HTMLInputElement>, 'onChange' | 'value'> {
+    onValueChange?: (value: string | undefined) => void;
+    initialValue?: number | string;
+    min?: number;
+    max?: number;
 }
-type AllowedInputProps = Pick<React.InputHTMLAttributes<HTMLInputElement>, 'className' | 'style' | 'placeholder' | 'disabled' | 'readOnly' | 'id' | 'name' | 'autoComplete' | 'autoFocus' | 'maxLength' | 'minLength' | 'required' | 'title' | 'dir' | 'onClick' | 'onKeyDown' | 'onKeyUp' | 'onKeyPress' | 'onFocus' | 'onBlur' | 'onMouseDown' | 'onMouseUp' | 'onMouseEnter' | 'onMouseLeave' | 'onTouchStart' | 'onTouchEnd' | 'onPaste'>;
-export type PersianNumberInputProps = PersianNumberInputCustomProps & AllowedInputProps;
 declare const PersianNumberInput: React.FC<PersianNumberInputProps>;
 export default PersianNumberInput;
+//# sourceMappingURL=PersianNumberInput.d.ts.map

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

@@ -0,0 +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"}

package/dist/components/PersianNumberInput.js

@@ -1,3 +1,4 @@
+"use strict";
 var __rest = (this && this.__rest) || function (s, e) {
     var t = {};
     for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
@@ -9,29 +10,38 @@ var __rest = (this && this.__rest) || function (s, e) {
         }
     return t;
 };
-import React, { useCallback, useState } from 'react';
-import { toLocalizedDigits, groupDigits, convertToEnglishDigits } from '../utils/digitUtils';
-// استایل پایه برای input
-const baseInputStyle = {
-    border: '1px solid #ccc',
-    borderRadius: '4px',
-};
+Object.defineProperty(exports, "__esModule", { value: true });
+const jsx_runtime_1 = require("react/jsx-runtime");
+const usePersianNumberInput_1 = require("../hooks/usePersianNumberInput");
 const PersianNumberInput = (_a) => {
-    var { initialValue = '', separatorCount = 0, separatorChar = ',', lang = 'fa', onChangeValue, style } = _a, rest = __rest(_a, ["initialValue", "separatorCount", "separatorChar", "lang", "onChangeValue", "style"]);
-    // تابع برای اعتبارسنجی ورودی و جلوگیری از کاراکترهای غیرمجاز
-    const sanitizeInput = (input) => input.replace(/[^\d,]/g, '');
-    const [value, setValue] = useState(() => convertToEnglishDigits(initialValue).replace(/\D/g, ''));
-    const handleChange = useCallback((e) => {
-        // فیلتر کردن ورودی‌های غیرمجاز
-        const input = sanitizeInput(convertToEnglishDigits(e.target.value));
-        setValue(input);
-        if (onChangeValue)
-            onChangeValue(input);
-    }, [onChangeValue]);
-    const formattedValue = groupDigits(value, separatorCount, separatorChar);
-    const displayValue = lang === 'en' ? formattedValue : toLocalizedDigits(formattedValue, lang);
-    const mergedStyle = Object.assign(Object.assign({}, baseInputStyle), style);
-    return (React.createElement("input", Object.assign({ value: displayValue, onChange: handleChange, style: mergedStyle }, rest)));
+    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"]);
+    // اعتبارسنجی پراپ‌ها
+    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 را هم برگردانید اگر لازم است
+     } = (0, usePersianNumberInput_1.usePersianNumberInput)({
+        initialValue,
+        separatorCount,
+        separatorChar,
+        locale,
+        maxDecimals,
+        showZero,
+        onValueChange,
+        min,
+        max
+    });
+    return ((0, jsx_runtime_1.jsx)("input", Object.assign({ type: "text" // یا "tel" هم گاهی استفاده می شود
+        , inputMode: "decimal", dir: "ltr" // معمولا برای اعداد بهتر است
+     }, restInputProps, { value: formattedValue, onChange: onChange })));
 };
-export default PersianNumberInput;
+exports.default = PersianNumberInput;
 //# sourceMappingURL=PersianNumberInput.js.map

package/dist/components/PersianNumberInput.js.map

@@ -1 +1 @@
-{"version":3,"file":"PersianNumberInput.js","sourceRoot":"","sources":["../../src/components/PersianNumberInput.tsx"],"names":[],"mappings":";;;;;;;;;;;AAAA,OAAO,KAAK,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AA0C7F,yBAAyB;AACzB,MAAM,cAAc,GAAwB;IACxC,MAAM,EAAE,gBAAgB;IACxB,YAAY,EAAE,KAAK;CACtB,CAAC;AAIF,MAAM,kBAAkB,GAAsC,CAAC,EAQ9D,EAAE,EAAE;QAR0D,EAC3D,YAAY,GAAG,EAAE,EACjB,cAAc,GAAG,CAAC,EAClB,aAAa,GAAG,GAAG,EACnB,IAAI,GAAG,IAAI,EACX,aAAa,EACb,KAAK,OAER,EADM,IAAI,cAPoD,qFAQ9D,CADU;IAEP,6DAA6D;IAC7D,MAAM,aAAa,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAEtE,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,sBAAsB,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;IAElG,MAAM,YAAY,GAAG,WAAW,CAAC,CAAC,CAAsC,EAAE,EAAE;QACxE,+BAA+B;QAC/B,MAAM,KAAK,GAAG,aAAa,CAAC,sBAAsB,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACpE,QAAQ,CAAC,KAAK,CAAC,CAAC;QAChB,IAAI,aAAa;YAAE,aAAa,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC;IAEpB,MAAM,cAAc,GAAG,WAAW,CAAC,KAAK,EAAE,cAAc,EAAE,aAAa,CAAC,CAAC;IACzE,MAAM,YAAY,GAAG,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,iBAAiB,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;IAE9F,MAAM,WAAW,mCAAQ,cAAc,GAAK,KAAK,CAAE,CAAC;IAEpD,OAAO,CACH,6CACI,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,YAAY,EACtB,KAAK,EAAE,WAAW,IACd,IAAI,EACV,CACL,CAAC;AACN,CAAC,CAAC;AAEF,eAAe,kBAAkB,CAAC"}
+{"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"}

package/dist/hooks/usePersianNumberInput.d.ts

@@ -0,0 +1,21 @@
+import React from 'react';
+import { TransformNumberOptions } from '../utils/transformNumber';
+interface UsePersianNumberInputProps extends TransformNumberOptions {
+    initialValue?: number | string;
+    onValueChange?: (value: string | undefined) => void;
+    min?: number;
+    max?: number;
+}
+interface UsePersianNumberInputReturn {
+    /** مقدار فرمت شده برای نمایش در input. */
+    value: string;
+    /** تابع onChange برای اتصال به input. */
+    onChange: (event: React.ChangeEvent<HTMLInputElement>) => void;
+    /** تابع برای تنظیم مقدار به صورت برنامه نویسی (مقدار عددی تمیز). */
+    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 {};
+//# sourceMappingURL=usePersianNumberInput.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usePersianNumberInput.d.ts","sourceRoot":"","sources":["../../src/hooks/usePersianNumberInput.ts"],"names":[],"mappings":"AAAA,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,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,WAAW,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;IAC/D,oEAAoE;IACpE,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IAC1D,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAWD,eAAO,MAAM,qBAAqB,GAAI,2GAUnC,0BAA+B,KAAG,2BAqIpC,CAAC"}

package/dist/hooks/usePersianNumberInput.js

@@ -0,0 +1,139 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.usePersianNumberInput = void 0;
+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");
+// تابع کمکی برای گرد کردن مقدار به تعداد اعشار مشخص
+const roundToDecimals = (value, maxDecimals) => {
+    if (!value || !value.includes('.'))
+        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 = 0, showZero = false, onValueChange, min, max, } = {}) => {
+    // State داخلی برای نگه داشتن مقدار عددی *تمیز شده* (ارقام انگلیسی، بدون جداکننده)
+    const [rawValue, setRawValue] = (0, react_1.useState)(() => {
+        if (initialValue === null || initialValue === undefined)
+            return undefined;
+        // مقدار اولیه را پاکسازی کن
+        let sanitized = (0, digitUtils_1.sanitizeNumericInput)(String(initialValue));
+        // اگر مقدار اولیه 0 بود و showZero false بود، مقدار خام را undefined بگذار
+        if (parseFloat(sanitized) === 0 &&
+            !showZero &&
+            initialValue !== 0 &&
+            initialValue !== '0') {
+            return undefined;
+        }
+        // گرد کردن به تعداد اعشار مجاز
+        sanitized = roundToDecimals(sanitized, maxDecimals);
+        // بررسی min و max برای مقدار اولیه
+        if (sanitized) {
+            try {
+                const numericValue = new decimal_js_1.default(sanitized);
+                if ((min !== undefined && numericValue.lt(min)) ||
+                    (max !== undefined && numericValue.gt(max))) {
+                    return undefined; // اگر مقدار اولیه خارج از محدوده است، undefined برگردان
+                }
+            }
+            catch (error) {
+                console.warn(`Invalid initial value: ${sanitized}`, error);
+                return undefined; // در صورت خطا، مقدار نامعتبر را رد کن
+            }
+        }
+        return sanitized || undefined; // اگر پاکسازی نتیجه خالی داد، undefined بگذار
+    });
+    // استفاده از useMemo برای بهینه سازی
+    const displayValue = (0, react_1.useMemo)(() => {
+        const options = { separatorCount, separatorChar, locale, maxDecimals, showZero };
+        // اگر rawValue تعریف نشده باشد، "" برگردان
+        if (rawValue === undefined) {
+            return showZero ? (0, transformNumber_1.transformNumber)('0', options) : '';
+        }
+        return (0, transformNumber_1.transformNumber)(rawValue, options);
+    }, [rawValue, separatorCount, separatorChar, locale, maxDecimals, showZero]);
+    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);
+            // بررسی min و max
+            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; // در صورت خطا، مقدار نامعتبر را رد کن
+                }
+            }
+            // اگر مقدار پاکسازی شده 0 بود و showZero=false، مقدار خام را undefined بگذار
+            valueToSet =
+                parseFloat(sanitizedValue) === 0 &&
+                    !showZero &&
+                    sanitizedValue !== '0.'
+                    ? undefined
+                    : sanitizedValue;
+            setRawValue(valueToSet);
+            if (onValueChange) {
+                onValueChange(valueToSet); // اطلاع رسانی مقدار عددی تمیز شده
+            }
+        }
+    }, [rawValue, onValueChange, showZero, min, max, maxDecimals]);
+    const handleSetValue = (0, react_1.useCallback)((newValue) => {
+        if (newValue === null || newValue === undefined) {
+            setRawValue(undefined);
+            if (onValueChange)
+                onValueChange(undefined);
+            return;
+        }
+        let sanitizedValue = (0, digitUtils_1.sanitizeNumericInput)(String(newValue));
+        // گرد کردن به تعداد اعشار مجاز
+        sanitizedValue = roundToDecimals(sanitizedValue, maxDecimals);
+        // بررسی min و max
+        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 valueToSet = parseFloat(sanitizedValue) === 0 &&
+            !showZero &&
+            sanitizedValue !== '0.'
+            ? undefined
+            : sanitizedValue;
+        setRawValue(valueToSet);
+        if (onValueChange) {
+            onValueChange(valueToSet);
+        }
+    }, [onValueChange, showZero, min, max, maxDecimals]);
+    return {
+        value: displayValue, // مقدار قالب بندی شده برای input
+        onChange: handleChange, // تابع برای اتصال به input.onChange
+        setValue: handleSetValue, // تابع برای تنظیم مقدار برنامه ای
+        rawValue: rawValue, // مقدار عددی خام (رشته انگلیسی)
+    };
+};
+exports.usePersianNumberInput = usePersianNumberInput;
+//# sourceMappingURL=usePersianNumberInput.js.map

package/dist/hooks/usePersianNumberInput.js.map

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

package/dist/index.d.ts

@@ -1 +1,6 @@
+export { usePersianNumberInput } from "./hooks/usePersianNumberInput";
 export { default as PersianNumberInput } from "./components/PersianNumberInput";
+export { transformNumber } from "./utils/transformNumber";
+export type { TransformNumberOptions } from "./utils/transformNumber";
+export * from "./utils/digitUtils";
+//# 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,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,YAAY,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACtE,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -1,2 +1,28 @@
-export { default as PersianNumberInput } from "./components/PersianNumberInput";
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.transformNumber = exports.PersianNumberInput = exports.usePersianNumberInput = void 0;
+var usePersianNumberInput_1 = require("./hooks/usePersianNumberInput");
+Object.defineProperty(exports, "usePersianNumberInput", { enumerable: true, get: function () { return usePersianNumberInput_1.usePersianNumberInput; } });
+var PersianNumberInput_1 = require("./components/PersianNumberInput");
+Object.defineProperty(exports, "PersianNumberInput", { enumerable: true, get: function () { return __importDefault(PersianNumberInput_1).default; } });
+var transformNumber_1 = require("./utils/transformNumber");
+Object.defineProperty(exports, "transformNumber", { enumerable: true, get: function () { return transformNumber_1.transformNumber; } });
+__exportStar(require("./utils/digitUtils"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,iCAAiC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA,uEAAsE;AAA7D,8HAAA,qBAAqB,OAAA;AAC9B,sEAAgF;AAAvE,yIAAA,OAAO,OAAsB;AACtC,2DAA0D;AAAjD,kHAAA,eAAe,OAAA;AAExB,qDAAmC"}

package/dist/utils/digitUtils.d.ts

@@ -1,6 +1,48 @@
+/**
+ * نقشه ارقام محلی برای زبان‌های مختلف.
+ */
 export declare const digitsMap: {
-    [key: string]: string[];
+    [key: string]: ReadonlyArray<string>;
 };
-export declare const toLocalizedDigits: (numStr: string, locale: "fa" | "in") => string;
-export declare const groupDigits: (numStr: string, separatorCount: number, separatorChar?: string) => 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;
+/**
+ * گروه‌بندی ارقام قسمت صحیح یک عدد با استفاده از جداکننده.
+ * @param numStr قسمت صحیح عدد (فقط ارقام انگلیسی)
+ * @param separatorCount تعداد ارقام در هر گروه (مثلا 3 برای هزارگان)
+ * @param separatorChar کاراکتر جداکننده (پیش فرض ',')
+ * @returns رشته گروه‌بندی شده
+ */
+export declare const groupDigits: (numStr: string, separatorCount: number, separatorChar?: string) => string;
+/**
+ * پاکسازی ورودی کاربر برای نگه داشتن فقط کاراکترهای عددی معتبر (ارقام، یک نقطه، یک علامت منفی در ابتدا).
+ * ابتدا ارقام محلی را به انگلیسی تبدیل می کند.
+ * @param value مقدار ورودی کاربر
+ * @returns رشته عددی پاکسازی شده با ارقام انگلیسی
+ */
+export declare const sanitizeNumericInput: (value: string) => string;
+//# sourceMappingURL=digitUtils.d.ts.map

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

@@ -0,0 +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;AAaF;;;;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,MAOF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAAI,OAAO,MAAM,KAAG,MAyBpD,CAAC"}

package/dist/utils/digitUtils.js

@@ -1,43 +1,110 @@
-export const digitsMap = {
+"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.digitsMap = {
     fa: ["۰", "۱", "۲", "۳", "۴", "۵", "۶", "۷", "۸", "۹"],
-    in: ["०", "१", "२", "३", "४", "५", "६", "७", "८", "९"],
+    // می توانید زبان های دیگر را اضافه کنید
+    // in: ["०", "१", "२", "३", "४", "५", "६", "७", "८", "९"],
 };
-// تبدیل اعداد به اعداد محلی با استفاده از نقشه
-export const toLocalizedDigits = (numStr, locale) => {
-    const digits = digitsMap[locale];
-    return numStr.replace(/\d/g, (digit) => digits[parseInt(digit)]);
+/**
+ * نقشه جداکننده اعشار برای زبان‌های مختلف.
+ */
+exports.decimalSeparatorMap = {
+    fa: "٫",
+    // en: ".", (پیش فرض نقطه است)
 };
-// گروه‌بندی اعداد با استفاده از جداکننده
-export const groupDigits = (numStr, separatorCount, separatorChar = ",") => {
-    if (separatorCount && separatorCount > 0) {
-        return numStr.replace(new RegExp(`\\B(?=(\\d{${separatorCount}})+(?!\\d))`, "g"), separatorChar);
+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;
+    const localeDigits = exports.digitsMap[locale];
+    return numStr.replace(/\d/g, (digit) => localeDigits[parseInt(digit)]);
+};
+exports.toLocalizedDigits = toLocalizedDigits;
+/**
+ * جایگزینی جداکننده اعشار انگلیسی (.) با جداکننده محلی.
+ * @param numStr رشته با ارقام و جداکننده انگلیسی
+ * @param locale کد زبان
+ * @returns رشته با جداکننده اعشار محلی
+ */
+const localizeDecimalSeparator = (numStr, locale) => {
+    const separator = exports.decimalSeparatorMap[locale];
+    if (!separator)
+        return numStr; // اگر جداکننده محلی تعریف نشده، همان نقطه را برگردان
+    return numStr.replace(".", separator);
+};
+exports.localizeDecimalSeparator = localizeDecimalSeparator;
+/**
+ * گروه‌بندی ارقام قسمت صحیح یک عدد با استفاده از جداکننده.
+ * @param numStr قسمت صحیح عدد (فقط ارقام انگلیسی)
+ * @param separatorCount تعداد ارقام در هر گروه (مثلا 3 برای هزارگان)
+ * @param separatorChar کاراکتر جداکننده (پیش فرض ',')
+ * @returns رشته گروه‌بندی شده
+ */
+const groupDigits = (numStr, separatorCount, separatorChar = ",") => {
+    if (!numStr || separatorCount <= 0) {
+        return numStr;
     }
-    return numStr;
+    // Regex برای پیدا کردن محل درج جداکننده ها (از راست به چپ)
+    const regex = new RegExp(`\\B(?=(\\d{${separatorCount}})+(?!\\d))`, "g");
+    return numStr.replace(regex, separatorChar);
 };
-// تبدیل اعداد محلی به اعداد انگلیسی
-export const convertToEnglishDigits = (str) => {
-    const map = {
-        "۰": "0",
-        "۱": "1",
-        "۲": "2",
-        "۳": "3",
-        "۴": "4",
-        "۵": "5",
-        "۶": "6",
-        "۷": "7",
-        "۸": "8",
-        "۹": "9",
-        "०": "0",
-        "१": "1",
-        "२": "2",
-        "३": "3",
-        "४": "4",
-        "५": "5",
-        "६": "6",
-        "७": "7",
-        "८": "8",
-        "९": "9",
-    };
-    return str.replace(/[۰-۹०-९]/g, (char) => map[char]);
+exports.groupDigits = groupDigits;
+/**
+ * پاکسازی ورودی کاربر برای نگه داشتن فقط کاراکترهای عددی معتبر (ارقام، یک نقطه، یک علامت منفی در ابتدا).
+ * ابتدا ارقام محلی را به انگلیسی تبدیل می کند.
+ * @param value مقدار ورودی کاربر
+ * @returns رشته عددی پاکسازی شده با ارقام انگلیسی
+ */
+const sanitizeNumericInput = (value) => {
+    if (value === null || value === undefined)
+        return "";
+    // 1. تبدیل همه ارقام به انگلیسی
+    let cleaned = (0, exports.convertToEnglishDigits)(String(value));
+    // 2. حذف همه چیز به جز ارقام، نقطه و علامت منفی
+    cleaned = cleaned.replace(/[^-0-9.]/g, "");
+    // 3. مدیریت علامت منفی: فقط یکی در ابتدا مجاز است
+    const negativeSign = cleaned.startsWith("-") ? "-" : "";
+    cleaned = cleaned.replace(/-/g, ""); // حذف همه منفی ها
+    // 4. مدیریت نقطه اعشار: فقط یکی مجاز است
+    const parts = cleaned.split(".");
+    let integerPart = parts[0] || ""; // بخش صحیح
+    let fractionalPart = parts.slice(1).join(""); // فقط اولین بخش اعشاری را نگه دار
+    // 5. بازسازی رشته تمیز شده
+    let sanitized = negativeSign + integerPart;
+    if (parts.length > 1) { // اگر نقطه ای وجود داشت
+        sanitized += "." + fractionalPart;
+    }
+    return sanitized;
 };
+exports.sanitizeNumericInput = sanitizeNumericInput;
 //# 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":"AAAA,MAAM,CAAC,MAAM,SAAS,GAAgC;IACpD,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;IACtD,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;CACvD,CAAC;AAEF,+CAA+C;AAC/C,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAAc,EAAE,MAAmB,EAAE,EAAE;IACvE,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IACjC,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnE,CAAC,CAAC;AAEF,yCAAyC;AACzC,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,MAAc,EACd,cAAsB,EACtB,aAAa,GAAG,GAAG,EACnB,EAAE;IACF,IAAI,cAAc,IAAI,cAAc,GAAG,CAAC,EAAE,CAAC;QACzC,OAAO,MAAM,CAAC,OAAO,CACnB,IAAI,MAAM,CAAC,cAAc,cAAc,aAAa,EAAE,GAAG,CAAC,EAC1D,aAAa,CACd,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,oCAAoC;AACpC,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,GAAW,EAAE,EAAE;IACpD,MAAM,GAAG,GAA8B;QACrC,GAAG,EAAE,GAAG;QACR,GAAG,EAAE,GAAG;QACR,GAAG,EAAE,GAAG;QACR,GAAG,EAAE,GAAG;QACR,GAAG,EAAE,GAAG;QACR,GAAG,EAAE,GAAG;QACR,GAAG,EAAE,GAAG;QACR,GAAG,EAAE,GAAG;QACR,GAAG,EAAE,GAAG;QACR,GAAG,EAAE,GAAG;QACR,GAAG,EAAE,GAAG;QACR,GAAG,EAAE,GAAG;QACR,GAAG,EAAE,GAAG;QACR,GAAG,EAAE,GAAG;QACR,GAAG,EAAE,GAAG;QACR,GAAG,EAAE,GAAG;QACR,GAAG,EAAE,GAAG;QACR,GAAG,EAAE,GAAG;QACR,GAAG,EAAE,GAAG;QACR,GAAG,EAAE,GAAG;KACT,CAAC;IACF,OAAO,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;AACvD,CAAC,CAAC"}
+{"version":3,"file":"digitUtils.js","sourceRoot":"","sources":["../../src/utils/digitUtils.ts"],"names":[],"mappings":"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"}

package/dist/utils/transformNumber.d.ts

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

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

@@ -0,0 +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"}

package/dist/utils/transformNumber.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.transformNumber = void 0;
+// utils/transformNumber.ts
+const digitUtils_1 = require("./digitUtils");
+/**
+ * یک عدد یا رشته عددی را به فرمت محلی و گروه بندی شده تبدیل می کند.
+ *
+ * @param input عدد یا رشته ورودی. می تواند شامل ارقام محلی یا انگلیسی باشد.
+ * @param options تنظیمات قالب بندی.
+ * @returns رشته قالب بندی شده یا رشته خالی اگر ورودی نامعتبر یا صفر (و showZero=false) باشد.
+ */
+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}"`);
+        return showZero ? (0, digitUtils_1.toLocalizedDigits)("0", locale) : "";
+    }
+    // تبدیل رشته خالی یا فقط "-" به صفر اگر showZero فعال باشد
+    if ((str === "" || str === "-") && showZero) {
+        str = "0";
+    }
+    else if (str === "" || str === "-") {
+        return ""; // اگر ورودی فقط "-" بود یا خالی شد، خالی برگردان
+    }
+    // اگر ورودی فقط "." بود
+    if (str === ".") {
+        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;
+        }
+        else {
+            // اگر maxDecimals صفر است، قسمت اعشار را حذف کن
+            str = integerPart;
+        }
+    }
+    else {
+        str = integerPart; // قسمت اعشاری وجود نداشت
+    }
+    // 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 انگلیسی نیست)
+    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 باشد
+    }
+    return finalStr;
+};
+exports.transformNumber = transformNumber;
+//# sourceMappingURL=transformNumber.js.map

package/dist/utils/transformNumber.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "persian-number-input",
-  "version": "3.1.0",
+  "version": "4.0.1",
   "description": "React component for Persian, Indic, or English localized number input with customizable digit grouping",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -45,5 +45,8 @@
     "jest": "^29.7.0",
     "ts-jest": "^29.3.2",
     "typescript": "^5.8.3"
+  },
+  "dependencies": {
+    "decimal.js": "^10.5.0"
   }
 }