# Persian Tools

> A comprehensive, high-performance TypeScript toolkit for Persian (Farsi) text, numbers, validation, and locale utilities — works in Node.js, Bun, and the browser.

## Docs

- [Examples](https://persian-tools.usestrict.dev/getting-started/examples.md): Practical examples and common use cases for Persian Tools
- [Installation](https://persian-tools.usestrict.dev/getting-started/installation.md): Learn how to install Persian Tools in your project
- [Usage Guide](https://persian-tools.usestrict.dev/getting-started/usage.md): Learn how to use Persian Tools utilities in your applications
- [Persian Tools](https://persian-tools.usestrict.dev/introduction.md): A comprehensive, high-performance TypeScript toolkit for Persian (Farsi) text, numbers, validation, and locale utilities
- [Who's Using Persian Tools?](https://persian-tools.usestrict.dev/showcase.md): Discover the companies and projects building amazing Persian/Farsi applications with Persian Tools
- [Bill Validation](https://persian-tools.usestrict.dev/utilities/banking/bill.md): Parse and validate Iranian utility bills
- [Extract Card Numbers](https://persian-tools.usestrict.dev/utilities/banking/extract-card-numbers.md): Iranian bank card number extraction with performance optimizations, type safety, and comprehensive validation
- [SHEBA/IBAN Validation](https://persian-tools.usestrict.dev/utilities/banking/sheba.md): Validate Iranian IBAN (SHEBA) numbers
- [Find Capital by Province](https://persian-tools.usestrict.dev/utilities/geographic/capital-by-province.md): Get the capital city of Iranian provinces
- [Find Province from Coordinates](https://persian-tools.usestrict.dev/utilities/geographic/province-from-coordinate.md): Determine the Iranian province from GPS coordinates
- [Comma Formatting](https://persian-tools.usestrict.dev/utilities/numbers/commas.md): Add or remove thousands separators in numbers
- [Digit Conversion](https://persian-tools.usestrict.dev/utilities/numbers/digits.md): Convert between Persian, Arabic, and English digit systems
- [Number to Words](https://persian-tools.usestrict.dev/utilities/numbers/number-to-words.md): Convert numeric values to Persian words with full customization options
- [Ordinal Suffix](https://persian-tools.usestrict.dev/utilities/numbers/ordinal-suffix.md): Add or remove Persian ordinal suffixes from numbers
- [Words to Number](https://persian-tools.usestrict.dev/utilities/numbers/words-to-number.md): Convert Persian words to numeric values with fuzzy matching support
- [Half-Space](https://persian-tools.usestrict.dev/utilities/text/half-space.md): Add proper Persian half-space (ZWNJ) characters for correct typography
- [Persian Character Conversion](https://persian-tools.usestrict.dev/utilities/text/persian-chars.md): Convert Arabic and English characters to proper Persian equivalents
- [Slugify](https://persian-tools.usestrict.dev/utilities/text/slugify.md): Generate URL-safe slugs from Persian text
- [Text Analyzer](https://persian-tools.usestrict.dev/utilities/text/text-analyzer.md): Analyze Persian text to get detailed statistics
- [URL Fix](https://persian-tools.usestrict.dev/utilities/text/url-fix.md): Decode and fix Persian URLs that are percent-encoded
- [Remaining Time](https://persian-tools.usestrict.dev/utilities/time/remaining-time.md): Calculate remaining time until a future date in Persian
- [Time Ago](https://persian-tools.usestrict.dev/utilities/time/time-ago.md): Convert timestamps to Persian relative time strings
- [Bank Card Validation](https://persian-tools.usestrict.dev/utilities/validation/card-number.md): Validate Iranian bank card numbers and extract card information
- [Legal ID Validation](https://persian-tools.usestrict.dev/utilities/validation/legal-id.md): Validate Iranian legal entity identification numbers (شناسه حقوقی)
- [National ID Validation](https://persian-tools.usestrict.dev/utilities/validation/national-id.md): Validate Iranian national identification numbers with comprehensive checks
- [Phone Number Validation](https://persian-tools.usestrict.dev/utilities/validation/phone-number.md): Validate Iranian mobile and landline phone numbers
- [Place by National ID](https://persian-tools.usestrict.dev/utilities/validation/place-by-national-id.md): Extract geographic information from Iranian National IDs
- [Vehicle Plate Recognition](https://persian-tools.usestrict.dev/utilities/vehicle/numberplate.md): Parse and validate Iranian vehicle license plates