calcfy-calculators 1.0.0

package/README.md

@@ -0,0 +1,96 @@
+# CalcFy Calculators
+
+A lightweight, zero-dependency JavaScript library for financial, health, and trading calculations.
+
+🌐 **Full Calculator Suite:** [https://calcfy.cc](https://calcfy.cc)
+
+---
+
+## Installation
+
+```bash
+npm install calcfy-calculators
+```
+
+---
+
+## Usage
+
+```javascript
+const calcfy = require('calcfy-calculators');
+
+// EMI Calculator
+const emi = calcfy.calculateEMI(500000, 8.5, 240);
+console.log(emi);
+// { emi: 4340.08, totalAmount: 1041619.2, totalInterest: 541619.2 }
+
+// SIP Calculator
+const sip = calcfy.calculateSIP(5000, 12, 10);
+console.log(sip);
+// { maturityValue: 1164908.38, investedAmount: 600000, estimatedReturns: 564908.38 }
+
+// GST Calculator
+const gst = calcfy.calculateGST(10000, 18, 'exclusive');
+console.log(gst);
+// { gstAmount: 1800, preGST: 10000, postGST: 11800 }
+
+// Lot Size Calculator (Forex)
+const lot = calcfy.calculateLotSize(10000, 1, 20, 10);
+console.log(lot);
+// { lotSize: 0.5, riskAmount: 100, units: 50000 }
+
+// BMI Calculator
+const bmi = calcfy.calculateBMI(70, 175);
+console.log(bmi);
+// { bmi: 22.9, category: 'Normal' }
+```
+
+---
+
+## Available Calculators
+
+### 💰 Finance
+| Function | Description |
+|---|---|
+| `calculateEMI(principal, rate, months)` | Loan EMI calculator |
+| `calculateSIP(amount, return, years)` | SIP maturity value |
+| `calculateGST(amount, rate, type)` | GST inclusive/exclusive |
+| `calculateCompoundInterest(p, rate, years, n)` | Compound interest |
+| `calculateROI(initial, final)` | Return on investment |
+| `calculateFD(principal, rate, years)` | Fixed deposit maturity |
+
+### ❤️ Health
+| Function | Description |
+|---|---|
+| `calculateBMI(weight, height)` | Body Mass Index |
+| `calculateBMR(weight, height, age, gender)` | Basal Metabolic Rate |
+
+### 📊 Trading
+| Function | Description |
+|---|---|
+| `calculateLotSize(balance, risk%, pips, pipValue)` | Forex lot size |
+
+---
+
+## Why CalcFy?
+
+- ✅ Zero dependencies
+- ✅ Works in Node.js and browser
+- ✅ Simple, clean API
+- ✅ Accurate formulas
+
+For a full visual calculator experience with 47+ tools, visit **[https://calcfy.cc](https://calcfy.cc)**
+
+---
+
+## Links
+
+- 🌐 Website: [https://calcfy.cc](https://calcfy.cc)
+- 📧 Support: [calcfycc@gmail.com](mailto:calcfycc@gmail.com)
+- 🐛 Issues: [https://calcfy.cc/contact](https://calcfy.cc/contact)
+
+---
+
+## License
+
+MIT © [CalcFy](https://calcfy.cc)

package/index.js

@@ -0,0 +1,188 @@
+/**
+ * CalcFy Calculators
+ * A lightweight JavaScript library for financial, health, and trading calculations.
+ * Full calculator suite available at https://calcfy.cc
+ */
+
+// ─── FINANCE ────────────────────────────────────────
+
+/**
+ * EMI Calculator
+ * @param {number} principal - Loan amount
+ * @param {number} annualRate - Annual interest rate (%)
+ * @param {number} tenureMonths - Loan tenure in months
+ * @returns {object} { emi, totalAmount, totalInterest }
+ */
+function calculateEMI(principal, annualRate, tenureMonths) {
+  const r = annualRate / 100 / 12;
+  const emi = principal * r * Math.pow(1 + r, tenureMonths) / (Math.pow(1 + r, tenureMonths) - 1);
+  const totalAmount = emi * tenureMonths;
+  return {
+    emi: parseFloat(emi.toFixed(2)),
+    totalAmount: parseFloat(totalAmount.toFixed(2)),
+    totalInterest: parseFloat((totalAmount - principal).toFixed(2))
+  };
+}
+
+/**
+ * SIP Calculator
+ * @param {number} monthlyAmount - Monthly SIP amount
+ * @param {number} annualReturn - Expected annual return (%)
+ * @param {number} years - Investment period in years
+ * @returns {object} { maturityValue, investedAmount, estimatedReturns }
+ */
+function calculateSIP(monthlyAmount, annualReturn, years) {
+  const r = annualReturn / 100 / 12;
+  const n = years * 12;
+  const maturity = monthlyAmount * ((Math.pow(1 + r, n) - 1) / r) * (1 + r);
+  const invested = monthlyAmount * n;
+  return {
+    maturityValue: parseFloat(maturity.toFixed(2)),
+    investedAmount: parseFloat(invested.toFixed(2)),
+    estimatedReturns: parseFloat((maturity - invested).toFixed(2))
+  };
+}
+
+/**
+ * GST Calculator
+ * @param {number} amount - Base amount
+ * @param {number} gstRate - GST rate (%)
+ * @param {string} type - 'exclusive' or 'inclusive'
+ * @returns {object} { gstAmount, preGST, postGST }
+ */
+function calculateGST(amount, gstRate, type = 'exclusive') {
+  const rate = gstRate / 100;
+  let pre, gst, post;
+  if (type === 'exclusive') {
+    pre = amount; gst = amount * rate; post = amount + gst;
+  } else {
+    post = amount; pre = amount / (1 + rate); gst = post - pre;
+  }
+  return {
+    gstAmount: parseFloat(gst.toFixed(2)),
+    preGST: parseFloat(pre.toFixed(2)),
+    postGST: parseFloat(post.toFixed(2))
+  };
+}
+
+/**
+ * Compound Interest Calculator
+ * @param {number} principal - Initial amount
+ * @param {number} annualRate - Annual interest rate (%)
+ * @param {number} years - Time period in years
+ * @param {number} n - Compounding frequency per year (1=yearly, 12=monthly, 4=quarterly)
+ * @returns {object} { finalAmount, principal, interest }
+ */
+function calculateCompoundInterest(principal, annualRate, years, n = 12) {
+  const amount = principal * Math.pow(1 + annualRate / 100 / n, n * years);
+  return {
+    finalAmount: parseFloat(amount.toFixed(2)),
+    principal: parseFloat(principal.toFixed(2)),
+    interest: parseFloat((amount - principal).toFixed(2))
+  };
+}
+
+/**
+ * ROI Calculator
+ * @param {number} initialInvestment
+ * @param {number} finalValue
+ * @returns {object} { roiPercent, netProfit, totalReturn }
+ */
+function calculateROI(initialInvestment, finalValue) {
+  const roi = ((finalValue - initialInvestment) / initialInvestment) * 100;
+  return {
+    roiPercent: parseFloat(roi.toFixed(2)),
+    netProfit: parseFloat((finalValue - initialInvestment).toFixed(2)),
+    totalReturn: parseFloat(finalValue.toFixed(2))
+  };
+}
+
+/**
+ * FD Calculator
+ * @param {number} principal
+ * @param {number} annualRate - Annual interest rate (%)
+ * @param {number} years
+ * @returns {object} { maturityAmount, principal, interest }
+ */
+function calculateFD(principal, annualRate, years) {
+  const n = 4; // quarterly compounding
+  const amount = principal * Math.pow(1 + annualRate / 100 / n, n * years);
+  return {
+    maturityAmount: parseFloat(amount.toFixed(2)),
+    principal: parseFloat(principal.toFixed(2)),
+    interest: parseFloat((amount - principal).toFixed(2))
+  };
+}
+
+// ─── HEALTH ─────────────────────────────────────────
+
+/**
+ * BMI Calculator
+ * @param {number} weightKg
+ * @param {number} heightCm
+ * @returns {object} { bmi, category }
+ */
+function calculateBMI(weightKg, heightCm) {
+  const h = heightCm / 100;
+  const bmi = weightKg / (h * h);
+  let category;
+  if (bmi < 18.5) category = 'Underweight';
+  else if (bmi < 25) category = 'Normal';
+  else if (bmi < 30) category = 'Overweight';
+  else category = 'Obese';
+  return { bmi: parseFloat(bmi.toFixed(1)), category };
+}
+
+/**
+ * BMR Calculator (Mifflin-St Jeor)
+ * @param {number} weightKg
+ * @param {number} heightCm
+ * @param {number} age
+ * @param {string} gender - 'male' or 'female'
+ * @returns {object} { bmr, sedentary, moderate, active }
+ */
+function calculateBMR(weightKg, heightCm, age, gender) {
+  const bmr = gender === 'male'
+    ? 10 * weightKg + 6.25 * heightCm - 5 * age + 5
+    : 10 * weightKg + 6.25 * heightCm - 5 * age - 161;
+  return {
+    bmr: Math.round(bmr),
+    sedentary: Math.round(bmr * 1.2),
+    moderate: Math.round(bmr * 1.55),
+    active: Math.round(bmr * 1.725)
+  };
+}
+
+// ─── TRADING ────────────────────────────────────────
+
+/**
+ * Lot Size Calculator
+ * @param {number} accountBalance
+ * @param {number} riskPercent - Risk percentage (e.g. 1 for 1%)
+ * @param {number} stopLossPips
+ * @param {number} pipValue - Value per pip per lot (default 10 for forex majors)
+ * @returns {object} { lotSize, riskAmount, units }
+ */
+function calculateLotSize(accountBalance, riskPercent, stopLossPips, pipValue = 10) {
+  const riskAmount = accountBalance * riskPercent / 100;
+  const lotSize = riskAmount / (stopLossPips * pipValue);
+  return {
+    lotSize: parseFloat(lotSize.toFixed(2)),
+    riskAmount: parseFloat(riskAmount.toFixed(2)),
+    units: Math.round(lotSize * 100000)
+  };
+}
+
+// ─── EXPORTS ────────────────────────────────────────
+
+module.exports = {
+  calculateEMI,
+  calculateSIP,
+  calculateGST,
+  calculateCompoundInterest,
+  calculateROI,
+  calculateFD,
+  calculateBMI,
+  calculateBMR,
+  calculateLotSize
+};

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "calcfy-calculators",
+  "version": "1.0.0",
+  "description": "Lightweight JavaScript library for EMI, SIP, GST, BMI, Lot Size and more financial & health calculators. Full suite at calcfy.cc",
+  "main": "index.js",
+  "homepage": "https://calcfy.cc",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/calcfy/calcfy-calculators"
+  },
+  "keywords": [
+    "calculator",
+    "emi",
+    "sip",
+    "gst",
+    "bmi",
+    "lot-size",
+    "forex",
+    "finance",
+    "compound-interest",
+    "roi",
+    "fd",
+    "bmr",
+    "calcfy"
+  ],
+  "author": "CalcFy <calcfycc@gmail.com> (https://calcfy.cc)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://calcfy.cc/contact"
+  }
+}