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