math-utils-simple 4.0.0 → 4.0.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "math-utils-simple",
-  "version": "4.0.0",
-  "description": "A simple math utility library for npm",
+  "version": "4.0.1",
+  "description": "Math utility library for npm",
   "type": "module",
   "main": "./src/index.js",
   "exports": {
@@ -16,6 +16,14 @@
     "npm",
     "library"
   ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/umar-farooq-5757/math-utils-simple.git"
+  },
+  "bugs": {
+    "url": "https://github.com/umar-farooq-5757/math-utils-simple/issues"
+  },
+  "homepage": "https://github.com/umar-farooq-5757/math-utils-simple#readme",
   "author": "Umar Farooq",
   "license": "MIT"
 }

package/src/index.js

@@ -104,4 +104,25 @@ export { default as projectVector } from "./arrays/projectVector.js";
 export { default as cumulativeSum } from "./arrays/cumulativeSum.js";
 export { default as movingAverage } from "./arrays/movingAverage.js";
 export { default as transpose } from "./arrays/transpose.js";
-export { default as matrixMultiply } from "./arrays/matrixMultiply.js";
+export { default as matrixMultiply } from "./arrays/matrixMultiply.js";
+
+// RANDOM
+export { default as random } from "./random/random.js";
+export { default as randomInt } from "./random/randomInt.js";
+export { default as randomFloat } from "./random/randomFloat.js";
+export { default as randomBoolean } from "./random/randomBoolean.js";
+export { default as randomChoice } from "./random/randomChoice.js";
+export { default as shuffle } from "./random/shuffle.js";
+export { default as sample } from "./random/sample.js";
+/**
+ * future goals
+ * randomSign() → returns -1 or 1
+randomHexColor()
+randomRGB()
+randomUUID() (using crypto.randomUUID())
+randomString(length, charset)
+randomDate(start, end)
+weightedChoice(items, weights)
+randomGaussian(mean, stdDev) (normal distribution via the Box–Muller transform)
+randomSeed(seed) (seeded pseudo-random number generator)
+ */

package/src/random/random.js

@@ -0,0 +1,3 @@
+export default function random() {
+  return Math.random();
+}

package/src/random/randomBoolean.js

@@ -0,0 +1,3 @@
+export default function randomBoolean() {
+  return Math.random() < 0.5;
+}

package/src/random/randomChoice.js

@@ -0,0 +1,11 @@
+export default function randomChoice(array) {
+  if (!Array.isArray(array)) {
+    throw new TypeError("Expected an array.");
+  }
+
+  if (array.length === 0) {
+    throw new Error("Cannot choose from an empty array.");
+  }
+
+  return array[Math.floor(Math.random() * array.length)];
+}

package/src/random/randomFloat.js

@@ -0,0 +1,11 @@
+export default function randomFloat(min, max) {
+  if (typeof min !== "number" || typeof max !== "number") {
+    throw new TypeError("Expected numeric bounds.");
+  }
+
+  if (min > max) {
+    throw new Error("Minimum cannot be greater than maximum.");
+  }
+
+  return Math.random() * (max - min) + min;
+}

package/src/random/randomInt.js

@@ -0,0 +1,11 @@
+export default function randomInt(min, max) {
+  if (!Number.isInteger(min) || !Number.isInteger(max)) {
+    throw new TypeError("Expected integer bounds.");
+  }
+
+  if (min > max) {
+    throw new Error("Minimum cannot be greater than maximum.");
+  }
+
+  return Math.floor(Math.random() * (max - min + 1)) + min;
+}

package/src/random/sample.js

@@ -0,0 +1,17 @@
+import shuffle from "./shuffle.js";
+
+export default function sample(array, count) {
+  if (!Array.isArray(array)) {
+    throw new TypeError("Expected an array.");
+  }
+
+  if (!Number.isInteger(count) || count < 0) {
+    throw new Error("Count must be a non-negative integer.");
+  }
+
+  if (count > array.length) {
+    throw new Error("Count cannot exceed array length.");
+  }
+
+  return shuffle(array).slice(0, count);
+}

package/src/random/shuffle.js

@@ -0,0 +1,15 @@
+export default function shuffle(array) {
+  if (!Array.isArray(array)) {
+    throw new TypeError("Expected an array.");
+  }
+
+  const result = [...array];
+
+  for (let i = result.length - 1; i > 0; i--) {
+    const j = Math.floor(Math.random() * (i + 1));
+
+    [result[i], result[j]] = [result[j], result[i]];
+  }
+
+  return result;
+}