easyjs-maths 0.1.0

package/README.md

@@ -0,0 +1,26 @@
+# easyjs-maths
+
+Maths plugin for EasyJS. Basic loads by `easy.use(maths)`. Advanced loads by `easy.use(maths.advanced)`.
+
+## Install
+
+```bash
+npm i easyjs-maths
+```
+
+## Use
+
+```js
+const easy = require("easyjs-empty");
+const maths = require("easyjs-maths");
+
+// basic
+
+easy.use(maths);
+
+// advanced
+
+easy.use(maths.advanced);
+```
+
+Refer to the `easyjs-empty` Readme for more info.

package/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "easyjs-maths",
+  "version": "0.1.0",
+  "description": "EasyJS maths plugin (Python-style math/random helpers).",
+  "license": "ISC",
+  "type": "commonjs",
+  "main": "src/index.js",
+  "keywords": [
+    "easyjs",
+    "plugin",
+    "math",
+    "maths",
+    "random",
+    "javascript"
+  ]
+}

package/src/index.js

@@ -0,0 +1,82 @@
+// easyjs-maths
+const createSets = () => {
+  // --- basic math functions ---
+  const basic = {
+    sqrt: (n) => Math.sqrt(n),
+    pow: (a, b) => Math.pow(a, b),
+    floor: (n) => Math.floor(n),
+    ceil: (n) => Math.ceil(n),
+    round: (n) => Math.round(n),
+    abs: (n) => Math.abs(n),
+    min: (...nums) => Math.min(...nums),
+    max: (...nums) => Math.max(...nums),
+  };
+
+  // --- advanced math functions ---
+  const advanced = {
+    factorial: (n) => {
+      if (n < 0) throw new Error("factorial only accepts non-negative numbers");
+      let res = 1;
+      for (let i = 2; i <= n; i++) res *= i;
+      return res;
+    },
+    gcd: (a, b) => { while (b !== 0) [a, b] = [b, a % b]; return a; },
+    lcm: (a, b) => (a * b) / (function gcd(a, b){ while (b !== 0) [a, b] = [b, a % b]; return a; })(a, b),
+    lerp: (a, b, t) => a + (b - a) * t,
+    sin: Math.sin,
+    cos: Math.cos,
+    tan: Math.tan,
+    asin: Math.asin,
+    acos: Math.acos,
+    atan: Math.atan,
+    log: (x, base = Math.E) => Math.log(x) / Math.log(base),
+    log10: Math.log10,
+    pi: Math.PI,
+    e: Math.E,
+  };
+
+  // --- random functions ---
+  const randomFuncs = {
+    random: Math.random,
+    randint: (min, max) => Math.floor(Math.random() * (max - min + 1)) + min,
+    choice: (arr) => arr[Math.floor(Math.random() * arr.length)],
+    shuffle: (arr) => {
+      const copy = [...arr];
+      for (let i = copy.length - 1; i > 0; i--) {
+        const j = Math.floor(Math.random() * (i + 1));
+        [copy[i], copy[j]] = [copy[j], copy[i]];
+      }
+      return copy;
+    },
+    uniform: (min, max) => Math.random() * (max - min) + min,
+    sample: (arr, n) => {
+      const shuffled = [...arr].sort(() => 0.5 - Math.random());
+      return shuffled.slice(0, n);
+    }
+  };
+
+  // --- helper to add functions with override warnings ---
+  const addFuncs = (target, funcs) => {
+    for (const [name, fn] of Object.entries(funcs)) {
+      if (target[name]) {
+        console.log(`-- WARNING - overwriting ${name} - WARNING --`);
+      }
+      target[name] = fn;
+    }
+  };
+
+  return { basic, advanced, randomFuncs, addFuncs };
+};
+
+const maths = (easy) => {
+  const { basic, addFuncs } = createSets();
+  addFuncs(easy, basic);
+};
+
+// advanced plugin (function) for easy.use(maths.advanced)
+maths.advanced = (easy) => {
+  const { basic, advanced, randomFuncs, addFuncs } = createSets();
+  addFuncs(easy, { ...basic, ...advanced, ...randomFuncs });
+};
+
+module.exports = maths;