simple-calculator-saikat 1.0.0

package/README.md

@@ -0,0 +1,106 @@
+# simple-calculator-saikat
+
+A simple and lightweight calculator utility for Node.js.
+Provides basic math operations with clean and easy-to-use functions.
+
+---
+
+## 📦 Installation
+
+```bash
+npm install simple-calculator-saikat
+```
+
+---
+
+## 🚀 Usage
+
+### CommonJS (Node.js)
+
+```js
+const calc = require("simple-calculator-saikat");
+
+console.log(calc.add(2, 3)); // 5
+console.log(calc.subtract(5, 2)); // 3
+console.log(calc.multiply(3, 4)); // 12
+console.log(calc.divide(10, 2)); // 5
+```
+
+---
+
+### ES Modules (if supported)
+
+```js
+import { add, subtract } from "simple-calculator-saikat";
+
+console.log(add(2, 3)); // 5
+```
+
+---
+
+## 🧠 API
+
+### ➕ add(a, b)
+
+Returns the sum of two numbers.
+
+### ➖ subtract(a, b)
+
+Returns the difference between two numbers.
+
+### ✖️ multiply(a, b)
+
+Returns the product of two numbers.
+
+### ➗ divide(a, b)
+
+Returns the result of division.
+
+⚠️ Throws an error if dividing by zero.
+
+---
+
+## 🛡️ Error Handling
+
+```js
+calc.divide(10, 0);
+// Error: Cannot divide by zero
+```
+
+---
+
+## 💡 Example
+
+```js
+const { add, multiply } = require("simple-calculator-saikat");
+
+const total = add(10, 5);
+const result = multiply(total, 2);
+
+console.log(result); // 30
+```
+
+---
+
+## 🧑‍💻 TypeScript Support
+
+This package includes built-in TypeScript definitions.
+
+```ts
+import { add } from "simple-calculator-saikat";
+
+const result: number = add(2, 3);
+```
+
+---
+
+## 📄 License
+
+MIT License © Saikat
+
+---
+
+## ⭐ Contributing
+
+Pull requests are welcome!
+Feel free to open issues for bugs or feature requests.

package/index.d.ts

@@ -0,0 +1,4 @@
+export function add(a: number, b: number): number;
+export function subtract(a: number, b: number): number;
+export function multiply(a: number, b: number): number;
+export function divide(a: number, b: number): number;

package/index.js

@@ -0,0 +1,27 @@
+"use strict";
+
+function add(a, b) {
+  return a + b;
+}
+
+function subtract(a, b) {
+  return a - b;
+}
+
+function multiply(a, b) {
+  return a * b;
+}
+
+function divide(a, b) {
+  if (b === 0) {
+    throw new Error("Cannot divide by zero");
+  }
+  return a / b;
+}
+
+module.exports = {
+  add,
+  subtract,
+  multiply,
+  divide,
+};

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "simple-calculator-saikat",
+  "version": "1.0.0",
+  "description": "A simple and lightweight calculator utility for Node.js",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "files": [
+    "index.js",
+    "index.d.ts"
+  ],
+  "scripts": {
+    "test": "node test.js"
+  },
+  "keywords": [
+    "calculator",
+    "math",
+    "utility",
+    "nodejs"
+  ],
+  "author": "Saikat",
+  "license": "MIT"
+}