num-parity-core 1.1.0 → 1.1.3

package/README.md

@@ -0,0 +1,102 @@
+# ⚡ num-parity-core
+
+> A minimal, fast and reliable Node.js utility to detect number parity (even or odd).
+
+---
+
+## 🚀 Why num-parity-core?
+
+Because number validation should be instant, predictable, and dependency-free.
+
+No frameworks. No noise. Just logic.
+
+---
+
+## 📦 Installation
+
+npm install num-parity-core 
+
+---
+
+## 🧠 Usage
+
+const { isEven, parity } = require("num-parity-core");
+
+// Boolean check
+console.log(isEven(10)); // true
+console.log(isEven(7));  // false
+
+// Human-readable result
+console.log(parity(10)); // "even"
+console.log(parity(7));  // "odd"
+
+---
+
+## ⚙️ API Reference
+
+isEven(number)
+
+Returns true if the number is even, otherwise false.
+
+isEven(4); // true
+isEven(9); // false
+parity(number)
+
+Returns a string representing the number parity:
+
+"even"
+"odd"
+parity(2); // "even"
+parity(3); // "odd"
+
+---
+
+## 🧪 Example
+for (let i = 1; i <= 10; i++) {
+  console.log(i, "→", parity(i));
+}
+
+Output:
+
+1 → odd
+2 → even
+3 → odd
+4 → even
+5 → odd
+6 → even
+7 → odd
+8 → even
+9 → odd
+10 → even
+
+---
+
+## ⚡ Features
+
+⚡ Ultra lightweight
+🧠 Zero dependencies
+🚀 Fast execution
+📦 Works in Node.js
+🧩 Simple and predictable API
+
+---
+
+## 📌 Roadmap
+TypeScript support
+ESM module support
+CLI tool (npx num-parity-core)
+Browser compatibility
+Benchmark optimizations
+🤝 Contributing
+
+Pull requests are welcome.
+
+Keep it simple. Keep it clean.
+
+---
+
+## 📄 License
+
+MIT — use freely, build freely, improve freely.
+
+---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "num-parity-core",
-  "version": "1.1.0",
+  "version": "1.1.3",
   "description": "Simple package to check if a number is even or odd",
   "main": "index.js",
   "keywords": [