# payroll-rules-india

A professional, modular, and extensible **Payroll Rules Engine** designed for **India-specific salary calculations**.  
Supports **custom rules, statutory components (PF, ESI, PT, Bonus Act), rule evaluation, financial year–based logic, and customizable conditions**.

> ✔ Ideal for HRMS, Payroll Systems, SaaS Platforms, Staffing Companies, FinTech Apps  
> ✔ Built with TypeScript + Rollup  
> ✔ Includes production-ready JS + `.d.ts` types

---

## 🚀 Features

- 🧮 Custom Rule Engine for payroll formula evaluation  
- 🇮🇳 India Statutory Payroll Support (PF, ESI, PT, Bonus, LWF etc.)  
- 📅 FY-based rule structures (FY 2024–25, FY 2025–26...)  
- 🧩 Modular structure: `rules`, `utils`, `fy2024_2025`  
- 🧠 Expression evaluator using `expr-eval`  
- 🏗 Extend or override rules per client/PO/employee  
- 🔄 Easily integratable with Node, TypeScript, or React backend  
- 📦 Lightweight & optimized bundle

---

## 📦 Installation

```bash
npm install payroll-rules-india