payroll-rules-india 2.10.1 → 2.12.0

package/dist/rules/fy2024_2025/shiftAllowanceRules.js

@@ -0,0 +1,44 @@
+// Shift Allowance: payable days * 17.16 rupee per day
+export const shiftAllowanceRule = {
+    ruleCode: "SHIFT_ALLOWANCE",
+    name: "Shift Allowance",
+    category: "Earning",
+    type: "Custom",
+    version: "FY2024-2025",
+    description: "Shift Allowance = payable days * 17.16 rupee per day",
+    condition: "payableDays > 0",
+    monthlyFormula: "round(payableDays * 17.16, 2)",
+    annualFormula: "round(payableDays * 17.16 * 12, 2)",
+};
+// Shift Allowance: payable days * 11.50 rupee per day
+export const shiftAllowanceRuleNew = {
+    ruleCode: "SHIFT_ALLOWANCE_NEW",
+    name: "Shift Allowance -new ",
+    category: "Earning",
+    type: "Custom",
+    version: "FY2024-2025",
+    description: "Shift Allowance = payable days * 11.50 rupee per day",
+    condition: "payableDays > 0",
+    monthlyFormula: "round(payableDays * 11.50, 2)",
+    annualFormula: "round(payableDays * 11.50 * 12, 2)",
+};
+export const shiftAllowanceRuleTierA = {
+    ruleCode: "SHIFT_ALLOWANCE_TIER_A",
+    name: "Shift Allowance",
+    category: "Earning",
+    type: "Custom",
+    version: "FY2024-2025",
+    description: "Shift Allowance calculated as 7.5% of wage rate multiplied by shift days.",
+    condition: "shiftDays > 0",
+    monthlyFormula: "round((dailyWages * 0.075) * shiftDays, 0)",
+};
+export const nightShiftAllowanceRuleTierB = {
+    ruleCode: "NIGHT_SHIFT_ALLOWANCE",
+    name: "Night Shift Allowance",
+    category: "Earning",
+    type: "Custom",
+    version: "FY2024-2025",
+    description: "shift allowance calculated at Rs.6.15 per night shift day.",
+    condition: "shiftDays > 0",
+    monthlyFormula: "round(shiftDays * 6.15, 2)",
+};

package/dist/rules/fy2024_2025/specialAllowanceRules.d.ts

@@ -0,0 +1,3 @@
+import { Rule } from "../../utils/types";
+export declare const specialAllowanceRule: Rule;
+export declare const specialAllowanceDailyRule: Rule;

package/dist/rules/fy2024_2025/specialAllowanceRules.js

@@ -0,0 +1,22 @@
+export const specialAllowanceRule = {
+    ruleCode: "SPECIAL_ALLOWANCE",
+    name: "Special Allowance",
+    category: "Earning",
+    version: "FY2024-2025",
+    description: "Residual component after mandatory allocations",
+    condition: "ctc > 0",
+    monthlyFormula: "round((ctc / 12) - (basic + hra + conveyance + da + gratuity + pf + esi), 2)",
+    annualFormula: "round(ctc - ((basic + hra + conveyance + da + gratuity + pf + esi) * 12), 2)",
+};
+// Special Allowance: 22 rupees per day * worked days
+export const specialAllowanceDailyRule = {
+    ruleCode: "SPECIAL_ALLOWANCE_DAILY",
+    name: "Special Allowance - Daily Rate",
+    category: "Earning",
+    type: "Custom",
+    version: "FY2024-2025",
+    description: "Special Allowance = 22 rupees per day * worked days (payable days)",
+    condition: "payableDays > 0",
+    monthlyFormula: "round(22 * payableDays, 2)",
+    annualFormula: "round(22 * payableDays * 12, 2)",
+};

package/dist/rules/fy2024_2025/teaAllowanceRules.d.ts

@@ -0,0 +1,2 @@
+import { Rule } from "../../utils/types";
+export declare const teaAllowanceRule: Rule;

package/dist/rules/fy2024_2025/teaAllowanceRules.js

@@ -0,0 +1,12 @@
+// Tea Allowance: 544 * No of payable days
+export const teaAllowanceRule = {
+    ruleCode: "TEA_ALLOWANCE",
+    name: "Tea Allowance",
+    category: "Earning",
+    type: "Custom",
+    version: "FY2024-2025",
+    description: "Tea Allowance = 5.44 * No of payable days",
+    condition: "payableDays > 0",
+    monthlyFormula: "round(5.44 * payableDays, 2)",
+    annualFormula: "round(5.44 * payableDays * 12, 2)",
+};

package/dist/rules/fy2024_2025/uniformAllowanceRules.d.ts

@@ -0,0 +1,6 @@
+import { Rule } from "../../utils/types";
+export declare const uniformAllowanceHSWRule: Rule;
+export declare const uniformAllowanceRule: Rule;
+export declare const uniformAllowanceSWRule: Rule;
+export declare const uniformAllowanceSSWRule: Rule;
+export declare const uniformAllowanceRuleForAll: Rule;

package/dist/rules/fy2024_2025/uniformAllowanceRules.js

@@ -0,0 +1,58 @@
+// Uniform Allowance - HSW: Rs. 60.63/- * payable days
+export const uniformAllowanceHSWRule = {
+    ruleCode: "UNIFORM_ALLOWANCE_HSW",
+    name: "Uniform Allowance - HSW",
+    category: "Earning",
+    type: "Custom",
+    version: "FY2024-2025",
+    description: "Uniform Allowance (HSW) = Rs. 60.63/- * payable days (worked days)",
+    condition: "payableDays > 0 && employeeCategory === 'HSW'",
+    monthlyFormula: "round(60.63 * payableDays, 2)",
+    annualFormula: "round(60.63 * payableDays * 12, 2)",
+};
+export const uniformAllowanceRule = {
+    ruleCode: "UNIFORM_ALLOWANCE_CUSTOM",
+    name: "Uniform Allowance - custom(HSW)",
+    category: "Earning",
+    type: "Custom",
+    version: "FY2024-2025",
+    description: "ONLY FOR HSW Uniform Allowance  = Rs. 65.00/- * payable days (worked days)",
+    condition: "payableDays > 0 && employeeCategory === 'HSW'",
+    monthlyFormula: "round(65 * payableDays, 2)",
+    annualFormula: "round(65 * payableDays * 12, 2)",
+};
+// Uniform Allowance - SW: Rs. 45.76/- * payable days
+export const uniformAllowanceSWRule = {
+    ruleCode: "UNIFORM_ALLOWANCE_SW",
+    name: "Uniform Allowance - SW",
+    category: "Earning",
+    type: "Custom",
+    version: "FY2024-2025",
+    description: "Uniform Allowance (SW) = Rs. 45.76/- * payable days (worked days)",
+    condition: "payableDays > 0 && employeeCategory === 'SW'",
+    monthlyFormula: "round(45.76 * payableDays, 2)",
+    annualFormula: "round(45.76 * payableDays * 12, 2)",
+};
+// Uniform Allowance - SSW: Rs. 38.90/- * payable days
+export const uniformAllowanceSSWRule = {
+    ruleCode: "UNIFORM_ALLOWANCE_SSW",
+    name: "Uniform Allowance - SSW",
+    category: "Earning",
+    type: "Custom",
+    version: "FY2024-2025",
+    description: "Uniform Allowance (SSW) = Rs. 38.90/- * payable days (worked days)",
+    condition: "payableDays > 0 && employeeCategory === 'SSW'",
+    monthlyFormula: "round(38.90 * payableDays, 2)",
+    annualFormula: "round(38.90 * payableDays * 12, 2)",
+};
+export const uniformAllowanceRuleForAll = {
+    ruleCode: "UNIFORM_ALLOWANCE_CUSTOM_ALL",
+    name: "Uniform Allowance - custom",
+    category: "Earning",
+    type: "Custom",
+    version: "FY2024-2025",
+    description: "General Uniform Allowance  = Rs. 65.00/- * payable days (worked days)",
+    condition: "payableDays > 0",
+    monthlyFormula: "round(65 * payableDays, 2)",
+    annualFormula: "round(65 * payableDays * 12, 2)",
+};

package/dist/rules/fy2024_2025/washingAllowanceRules.d.ts

@@ -0,0 +1,11 @@
+import { Rule } from "../../utils/types";
+export declare const washingAllowanceTierA: Rule;
+export declare const washingAllowanceTierB: Rule;
+export declare const washingAllowanceTierC: Rule;
+export declare const washingAllowanceTierCRevised: Rule;
+export declare const washingAllowanceUSWRuleTierD: Rule;
+export declare const washingAllowanceUSWRuleTierE: Rule;
+export declare const washingAllowanceUSWRuleTierF: Rule;
+export declare const washingAllowanceUSWRuleTierG: Rule;
+export declare const washingAllowanceTierH: Rule;
+export declare const washingAllowanceDailyRule: Rule;

package/dist/rules/fy2024_2025/washingAllowanceRules.js

@@ -0,0 +1,105 @@
+export const washingAllowanceTierA = {
+    ruleCode: "WASHING_ALLOWANCE_TIER_A",
+    name: "Washing Allowance – Tier A",
+    category: "Earning",
+    type: "Custom",
+    version: "FY2024-2025",
+    description: "Washing Allowance = Rs. 16.02 * payable days",
+    condition: "payableDays > 0",
+    monthlyFormula: "round(16.02 * payableDays, 2)",
+    annualFormula: "round(16.02 * payableDays * 12, 2)",
+};
+export const washingAllowanceTierB = {
+    ruleCode: "WASHING_ALLOWANCE_TIER_B",
+    name: "Washing Allowance – Tier B",
+    category: "Earning",
+    type: "Custom",
+    version: "FY2024-2025",
+    description: "Washing Allowance = Rs. 12.58 * payable days",
+    condition: "payableDays > 0",
+    monthlyFormula: "round(12.58 * payableDays, 2)",
+    annualFormula: "round(12.58 * payableDays * 12, 2)",
+};
+export const washingAllowanceTierC = {
+    ruleCode: "WASHING_ALLOWANCE_TIER_C",
+    name: "Washing Allowance – Tier C",
+    category: "Earning",
+    type: "Custom",
+    version: "FY2024-2025",
+    description: "Washing Allowance = Rs. 10.30 * payable days",
+    condition: "payableDays > 0",
+    monthlyFormula: "round(10.30 * payableDays, 2)",
+    annualFormula: "round(10.30 * payableDays * 12, 2)",
+};
+export const washingAllowanceTierCRevised = {
+    ruleCode: "WASHING_ALLOWANCE_TIER_C_REVISED",
+    name: "Washing Allowance – Tier C (Revised Rate)",
+    category: "Earning",
+    type: "Custom",
+    version: "FY2024-2025",
+    description: "Washing Allowance = Rs. 11.50 * payable days",
+    condition: "payableDays > 0",
+    monthlyFormula: "round(11.50 * payableDays, 2)",
+    annualFormula: "round(11.50 * payableDays * 12, 2)",
+};
+export const washingAllowanceUSWRuleTierD = {
+    ruleCode: "WASHING_ALLOWANCE_USW",
+    name: "Washing Allowance (USW)",
+    category: "Earning",
+    type: "Custom",
+    version: "FY2024-2025",
+    description: "Washing allowance for USW category at Rs.25 per present day.",
+    condition: "payableDays > 0",
+    monthlyFormula: "round(payableDays * 25, 2)",
+};
+export const washingAllowanceUSWRuleTierE = {
+    ruleCode: "WASHING_ALLOWANCE_SW",
+    name: "Washing Allowance (SW)",
+    category: "Earning",
+    type: "Custom",
+    version: "FY2024-2025",
+    description: "Washing allowance for SW category at Rs.35 per present day.",
+    condition: "payableDays > 0",
+    monthlyFormula: "round(payableDays * 35, 2)",
+};
+export const washingAllowanceUSWRuleTierF = {
+    ruleCode: "WASHING_ALLOWANCE",
+    name: "Washing Allowance At ₹44",
+    category: "Earning",
+    type: "Custom",
+    version: "FY2024-2025",
+    description: "Washing allowance for SW category at Rs.44 per present day.",
+    condition: "payableDays > 0",
+    monthlyFormula: "round(payableDays * 44, 2)",
+};
+export const washingAllowanceUSWRuleTierG = {
+    ruleCode: "WASHING_ALLOWANCE_TIER_G",
+    name: "Washing Allowance At ₹5.44",
+    category: "Earning",
+    type: "Custom",
+    version: "FY2024-2025",
+    description: "Washing allowance for category at Rs.5.44 per present day.",
+    condition: "payableDays > 0",
+    monthlyFormula: "round(payableDays * 5.44, 2)",
+};
+export const washingAllowanceTierH = {
+    ruleCode: "WASHING_ALLOWANCE_TIER_H",
+    name: "Washing Allowance – Tier H",
+    category: "Earning",
+    type: "Custom",
+    version: "FY2024-2025",
+    description: "Washing Allowance = Rs. 10 * payable days",
+    condition: "payableDays > 0",
+    monthlyFormula: "round(10 * payableDays, 2)",
+    annualFormula: "round(10 * payableDays * 12, 2)",
+};
+export const washingAllowanceDailyRule = {
+    ruleCode: "WASHING_ALLOWANCE_DAILY",
+    name: "Washing Allowance",
+    category: "Earning",
+    type: "Custom",
+    version: "FY2024-2025",
+    description: "Washing allowance calculated at Rs.41 per payable day.",
+    condition: "payableDays > 0",
+    monthlyFormula: "round(payableDays * 41, 0)",
+};

package/dist/rules/index.d.ts

@@ -0,0 +1,5 @@
+import * as rules2024_2025 from "./fy2024_2025";
+export declare const payrollRules: {
+    "2024-2025": typeof rules2024_2025;
+};
+export type PayrollRuleSet = typeof payrollRules;

package/dist/rules/index.js

@@ -0,0 +1,4 @@
+import * as rules2024_2025 from "./fy2024_2025";
+export const payrollRules = {
+    "2024-2025": rules2024_2025,
+};

package/dist/utils/ruleEvaluator.d.ts

@@ -0,0 +1,2 @@
+import { Rule, EvaluationContext, EvaluationResult } from "./types";
+export declare function evaluateRule(rule: Rule, context: EvaluationContext, mode?: "monthly" | "annual"): EvaluationResult;

package/dist/utils/ruleEvaluator.js

@@ -0,0 +1,32 @@
+import { Parser } from "expr-eval";
+const parser = new Parser();
+const safeFunctions = {
+    round: (v, d = 2) => Math.round(v * Math.pow(10, d)) / Math.pow(10, d),
+    min: Math.min,
+    max: Math.max,
+    abs: Math.abs,
+};
+export function evaluateRule(rule, context, mode = "monthly") {
+    const formula = mode === "annual" ? rule.annualFormula : rule.monthlyFormula;
+    if (!formula) {
+        return {
+            applies: false,
+            value: null,
+            ruleCode: rule.ruleCode,
+            name: rule.name,
+            category: rule.category,
+        };
+    }
+    const conditionAst = rule.condition ? parser.parse(rule.condition) : null;
+    const formulaAst = parser.parse(formula);
+    const ctx = { ...context, ...safeFunctions };
+    const applies = conditionAst ? Boolean(conditionAst.evaluate(ctx)) : true;
+    const value = applies ? Number(formulaAst.evaluate(ctx)) : null;
+    return {
+        applies,
+        value,
+        ruleCode: rule.ruleCode,
+        name: rule.name,
+        category: rule.category,
+    };
+}

package/dist/utils/types.d.ts

@@ -0,0 +1,44 @@
+export type Rule = {
+    ruleCode: string;
+    name: string;
+    category: "Earning" | "Deduction" | "Adjustment";
+    type?: "Statutory" | "Custom" | "Fixed";
+    description?: string;
+    version?: string;
+    condition?: string;
+    monthlyFormula?: string;
+    annualFormula?: string;
+};
+export type EvaluationContext = {
+    basic?: number;
+    hra?: number;
+    da?: number;
+    specialAllowance?: number;
+    conveyance?: number;
+    gross?: number;
+    grossEarnings?: number;
+    ctc?: number;
+    lopDays?: number;
+    workedDays?: number;
+    payableDays?: number;
+    dailyWages?: number;
+    totalDaysInMonth?: number;
+    workingDaysInMonth?: number;
+    noOfHolidays?: number;
+    employeeCategory?: "HSW" | "SW" | "SSW";
+    isPfApplicable?: boolean;
+    isEsiApplicable?: boolean;
+    isMetro?: boolean;
+    pfWageLimit?: number;
+    esiWageLimit?: number;
+    state?: string;
+    taxRegime?: "old" | "new";
+    [key: string]: any;
+};
+export type EvaluationResult = {
+    applies: boolean;
+    value: number | null;
+    ruleCode: string;
+    name: string;
+    category: string;
+};

package/dist/utils/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "payroll-rules-india",
-  "version": "2.10.1",
+  "version": "2.12.0",
   "description": "Custom and statutory payroll rules engine for India salary calculations.",
   "author": "Yogesh c",
   "license": "MIT",