# ILS Currency Input Plugin
**Professional Israeli Shekel currency input with Enter-key confirmation and RTL support**

## 🏦 Perfect for Israeli Financial Applications

Transform your money input fields into professional, user-friendly currency inputs specifically designed for Israeli Shekel (₪) transactions. This plugin provides a polished, banking-grade experience that respects Hebrew RTL conventions while maintaining international usability standards.

## ✨ Key Features

### 🎯 **Enter-Key Confirmation**
- No annoying auto-formatting while typing
- Users type freely: `1000.50` stays as `1000.50`
- Press Enter to confirm: transforms to `₪ 1,000.50`
- Clean, distraction-free typing experience

### 🇮🇱 **Native Israeli Support**
- Proper ₪ (Shekel) symbol positioning
- RTL-aware layout with 4px spacing
- Hebrew suffix support: `1ק` → `₪ 1,000.00`
- Respects Israeli currency conventions

### 🔧 **Flexible & Configurable**
- **Decimal Places Control**: Set precision (0-4 decimal places)
- **Smart Parsing**: Handles k/m/b and Hebrew ק/מ/מליארד suffixes
- **Custom Events**: `ils_currency_updated` and `ils_currency_reset`
- **Auto-formatting**: Comma separators for thousands

### 💼 **Enterprise Ready**
- Robust error handling with retry logic
- Memory leak prevention with proper cleanup
- Custom event system for easy integration
- No console spam - silent operation

## 🚀 Use Cases

- **Banking Applications** - Transaction amounts, transfers
- **E-commerce** - Product pricing, checkout forms  
- **Accounting Software** - Invoice amounts, expense tracking
- **Financial Dashboards** - Budget inputs, financial planning
- **Real Estate** - Property prices, rental amounts

## ⚙️ Simple Setup

**Properties:**
- `input` - Initial value to display
- `decimal_places` - Number of decimal places (default: 2)

**Events to Listen For:**
```javascript
// Value confirmed with Enter key
element.addEventListener('ils_currency_updated', (e) => {
   console.log('New amount:', e.detail.value, '₪');
});

// Field was reset or cleared
element.addEventListener('ils_currency_reset', (e) => {
   console.log('Reset reason:', e.detail.reason);
});
```

## 🎨 Professional Appearance

- Clean, minimal design that inherits your app's styling
- Seamless integration with any UI framework
- Mobile-friendly and accessible
- Consistent with Israeli banking interfaces

## 🛡️ Reliability

- **Smart Reset Logic**: Automatic retry with exponential backoff
- **Input Validation**: Graceful handling of invalid entries  
- **State Synchronization**: Bulletproof state management
- **Cross-browser Compatible**: Works everywhere Bubble works

---

**Ready to provide your users with a premium Israeli currency input experience?**

*This plugin eliminates the frustration of auto-formatting inputs while maintaining professional currency display standards. Your Israeli users will appreciate the familiar RTL layout and proper ₪ symbol positioning.*