probability-picker 1.0.1 → 1.2.0

package/README.md

@@ -1,10 +1,10 @@
 # Probability Picker
-A library that helps obtain a value based on probability.
+A lightweight library for selecting random values based on weighted probabilities.
 
 ## Installation
 
 ```bash
-npm install probability-picker
+npm i probability-picker
 ```
 
 ## Usage
@@ -12,9 +12,9 @@ npm install probability-picker
 The `probabilityPicker` function will return `a`, `b`, or `c`. The probability of each one is defined as a value in the object.
     
 ```javascript
-import probabilityPicker from 'probability-picker';
+import picker from 'probability-picker';
 
-const value = probabilityPicker({
+const value = picker({
     a: 10,
     b: 70,
     c: 20,

package/dist/index.cjs

@@ -0,0 +1,59 @@
+'use strict';
+
+// src/index.ts
+function filterNumbers(entries) {
+  return entries.filter((e) => typeof e[1] === "number" && !Number.isNaN(e[1]));
+}
+function sortEntries(entries) {
+  return entries.sort((a, b) => a[1] - b[1]);
+}
+function sumProbabilities(entries) {
+  return entries.reduce((acc, e) => acc + e[1], 0);
+}
+function normalizeProbabilities(entries, total) {
+  return entries.map(([k, v]) => [k, Math.round(v / total * 100)]);
+}
+function prepareEntries(entries) {
+  const filtered = filterNumbers(entries);
+  if (filtered.length === 0) return;
+  const sorted = sortEntries(filtered);
+  const sum = sumProbabilities(sorted);
+  if (sum === 0) return;
+  if (sum === 100) return sorted;
+  return normalizeProbabilities(sorted, sum);
+}
+function secureRandom() {
+  if (typeof globalThis.crypto === "undefined" || typeof globalThis.crypto.getRandomValues !== "function") {
+    return Math.random();
+  }
+  const array = new Uint32Array(1);
+  globalThis.crypto.getRandomValues(array);
+  return array[0] / 4294967296;
+}
+function random(min, max) {
+  return secureRandom() * (max - min) + min;
+}
+function chooseOne(entries) {
+  const num = random(1, 100);
+  let count = 0;
+  for (const entry of entries) {
+    count += entry[1];
+    if (num <= count) return entry[0];
+  }
+  return entries[entries.length - 1][0];
+}
+function probabilityPicker(map) {
+  if (!(map instanceof Object)) return null;
+  const entries = Object.entries(map);
+  if (entries.length === 0) return void 0;
+  const first = entries[0];
+  if (first && entries.length === 1) return first[0];
+  const prepared = prepareEntries(entries);
+  if (!prepared) return void 0;
+  return chooseOne(prepared);
+}
+var index_default = probabilityPicker;
+
+module.exports = index_default;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["type ProbabilityMap = Record<string, number>\r\ntype Entry = [string, number]\r\n\r\nfunction filterNumbers(entries: Entry[]) {\r\n    return entries.filter(e => typeof e[1] === 'number' && !Number.isNaN(e[1]))\r\n}\r\n\r\nfunction sortEntries(entries: Entry[]) {\r\n    return entries.sort((a, b) => a[1] - b[1])\r\n}\r\n\r\nfunction sumProbabilities(entries: Entry[]) {\r\n    return entries.reduce((acc, e) => acc + e[1], 0)\r\n}\r\n\r\nfunction normalizeProbabilities(entries: Entry[], total: number) {\r\n    return entries.map(([k, v]) => [k, Math.round((v / total) * 100)] as Entry)\r\n}\r\n\r\nfunction prepareEntries(entries: Entry[]) {\r\n    const filtered = filterNumbers(entries)\r\n    if (filtered.length === 0) return\r\n    const sorted = sortEntries(filtered)\r\n    const sum = sumProbabilities(sorted)\r\n    if (sum === 0) return\r\n    if (sum === 100) return sorted\r\n    return normalizeProbabilities(sorted, sum)\r\n}\r\n\r\nfunction secureRandom(): number {\r\n    if (typeof globalThis.crypto === 'undefined' || typeof globalThis.crypto.getRandomValues !== 'function') {\r\n        return Math.random()\r\n    }\r\n    const array = new Uint32Array(1)\r\n    globalThis.crypto.getRandomValues(array)\r\n    return array[0]! / 0x100000000\r\n}\r\n\r\nfunction random(min: number, max: number) {\r\n    return secureRandom() * (max - min) + min\r\n}\r\n\r\nfunction chooseOne(entries: Entry[]) {\r\n    const num = random(1, 100)\r\n    let count = 0\r\n    for (const entry of entries) {\r\n        count += entry[1]\r\n        if (num <= count) return entry[0]\r\n    }\r\n    return entries[entries.length - 1]![0]\r\n}\r\n\r\nfunction probabilityPicker(map: ProbabilityMap): string | null | undefined {\r\n    if (!(map instanceof Object)) return null\r\n    const entries = Object.entries(map) as Entry[]\r\n    if (entries.length === 0) return undefined\r\n    const first = entries[0]\r\n    if (first && entries.length === 1) return first[0]\r\n    const prepared = prepareEntries(entries)\r\n    if (!prepared) return undefined\r\n    return chooseOne(prepared)\r\n}\r\n\r\nexport default probabilityPicker;"]}

package/dist/index.d.cts

@@ -0,0 +1,4 @@
+type ProbabilityMap = Record<string, number>;
+declare function probabilityPicker(map: ProbabilityMap): string | null | undefined;
+
+export { probabilityPicker as default };

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+type ProbabilityMap = Record<string, number>;
+declare function probabilityPicker(map: ProbabilityMap): string | null | undefined;
+
+export { probabilityPicker as default };

package/dist/index.js

@@ -0,0 +1,57 @@
+// src/index.ts
+function filterNumbers(entries) {
+  return entries.filter((e) => typeof e[1] === "number" && !Number.isNaN(e[1]));
+}
+function sortEntries(entries) {
+  return entries.sort((a, b) => a[1] - b[1]);
+}
+function sumProbabilities(entries) {
+  return entries.reduce((acc, e) => acc + e[1], 0);
+}
+function normalizeProbabilities(entries, total) {
+  return entries.map(([k, v]) => [k, Math.round(v / total * 100)]);
+}
+function prepareEntries(entries) {
+  const filtered = filterNumbers(entries);
+  if (filtered.length === 0) return;
+  const sorted = sortEntries(filtered);
+  const sum = sumProbabilities(sorted);
+  if (sum === 0) return;
+  if (sum === 100) return sorted;
+  return normalizeProbabilities(sorted, sum);
+}
+function secureRandom() {
+  if (typeof globalThis.crypto === "undefined" || typeof globalThis.crypto.getRandomValues !== "function") {
+    return Math.random();
+  }
+  const array = new Uint32Array(1);
+  globalThis.crypto.getRandomValues(array);
+  return array[0] / 4294967296;
+}
+function random(min, max) {
+  return secureRandom() * (max - min) + min;
+}
+function chooseOne(entries) {
+  const num = random(1, 100);
+  let count = 0;
+  for (const entry of entries) {
+    count += entry[1];
+    if (num <= count) return entry[0];
+  }
+  return entries[entries.length - 1][0];
+}
+function probabilityPicker(map) {
+  if (!(map instanceof Object)) return null;
+  const entries = Object.entries(map);
+  if (entries.length === 0) return void 0;
+  const first = entries[0];
+  if (first && entries.length === 1) return first[0];
+  const prepared = prepareEntries(entries);
+  if (!prepared) return void 0;
+  return chooseOne(prepared);
+}
+var index_default = probabilityPicker;
+
+export { index_default as default };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";AAGA,SAAS,cAAc,OAAA,EAAkB;AACrC,EAAA,OAAO,OAAA,CAAQ,MAAA,CAAO,CAAA,CAAA,KAAK,OAAO,EAAE,CAAC,CAAA,KAAM,QAAA,IAAY,CAAC,MAAA,CAAO,KAAA,CAAM,CAAA,CAAE,CAAC,CAAC,CAAC,CAAA;AAC9E;AAEA,SAAS,YAAY,OAAA,EAAkB;AACnC,EAAA,OAAO,OAAA,CAAQ,IAAA,CAAK,CAAC,CAAA,EAAG,CAAA,KAAM,EAAE,CAAC,CAAA,GAAI,CAAA,CAAE,CAAC,CAAC,CAAA;AAC7C;AAEA,SAAS,iBAAiB,OAAA,EAAkB;AACxC,EAAA,OAAO,OAAA,CAAQ,OAAO,CAAC,GAAA,EAAK,MAAM,GAAA,GAAM,CAAA,CAAE,CAAC,CAAA,EAAG,CAAC,CAAA;AACnD;AAEA,SAAS,sBAAA,CAAuB,SAAkB,KAAA,EAAe;AAC7D,EAAA,OAAO,OAAA,CAAQ,GAAA,CAAI,CAAC,CAAC,GAAG,CAAC,CAAA,KAAM,CAAC,CAAA,EAAG,KAAK,KAAA,CAAO,CAAA,GAAI,KAAA,GAAS,GAAG,CAAC,CAAU,CAAA;AAC9E;AAEA,SAAS,eAAe,OAAA,EAAkB;AACtC,EAAA,MAAM,QAAA,GAAW,cAAc,OAAO,CAAA;AACtC,EAAA,IAAI,QAAA,CAAS,WAAW,CAAA,EAAG;AAC3B,EAAA,MAAM,MAAA,GAAS,YAAY,QAAQ,CAAA;AACnC,EAAA,MAAM,GAAA,GAAM,iBAAiB,MAAM,CAAA;AACnC,EAAA,IAAI,QAAQ,CAAA,EAAG;AACf,EAAA,IAAI,GAAA,KAAQ,KAAK,OAAO,MAAA;AACxB,EAAA,OAAO,sBAAA,CAAuB,QAAQ,GAAG,CAAA;AAC7C;AAEA,SAAS,YAAA,GAAuB;AAC5B,EAAA,IAAI,OAAO,WAAW,MAAA,KAAW,WAAA,IAAe,OAAO,UAAA,CAAW,MAAA,CAAO,oBAAoB,UAAA,EAAY;AACrG,IAAA,OAAO,KAAK,MAAA,EAAO;AAAA,EACvB;AACA,EAAA,MAAM,KAAA,GAAQ,IAAI,WAAA,CAAY,CAAC,CAAA;AAC/B,EAAA,UAAA,CAAW,MAAA,CAAO,gBAAgB,KAAK,CAAA;AACvC,EAAA,OAAO,KAAA,CAAM,CAAC,CAAA,GAAK,UAAA;AACvB;AAEA,SAAS,MAAA,CAAO,KAAa,GAAA,EAAa;AACtC,EAAA,OAAO,YAAA,EAAa,IAAK,GAAA,GAAM,GAAA,CAAA,GAAO,GAAA;AAC1C;AAEA,SAAS,UAAU,OAAA,EAAkB;AACjC,EAAA,MAAM,GAAA,GAAM,MAAA,CAAO,CAAA,EAAG,GAAG,CAAA;AACzB,EAAA,IAAI,KAAA,GAAQ,CAAA;AACZ,EAAA,KAAA,MAAW,SAAS,OAAA,EAAS;AACzB,IAAA,KAAA,IAAS,MAAM,CAAC,CAAA;AAChB,IAAA,IAAI,GAAA,IAAO,KAAA,EAAO,OAAO,KAAA,CAAM,CAAC,CAAA;AAAA,EACpC;AACA,EAAA,OAAO,OAAA,CAAQ,OAAA,CAAQ,MAAA,GAAS,CAAC,EAAG,CAAC,CAAA;AACzC;AAEA,SAAS,kBAAkB,GAAA,EAAgD;AACvE,EAAA,IAAI,EAAE,GAAA,YAAe,MAAA,CAAA,EAAS,OAAO,IAAA;AACrC,EAAA,MAAM,OAAA,GAAU,MAAA,CAAO,OAAA,CAAQ,GAAG,CAAA;AAClC,EAAA,IAAI,OAAA,CAAQ,MAAA,KAAW,CAAA,EAAG,OAAO,MAAA;AACjC,EAAA,MAAM,KAAA,GAAQ,QAAQ,CAAC,CAAA;AACvB,EAAA,IAAI,SAAS,OAAA,CAAQ,MAAA,KAAW,CAAA,EAAG,OAAO,MAAM,CAAC,CAAA;AACjD,EAAA,MAAM,QAAA,GAAW,eAAe,OAAO,CAAA;AACvC,EAAA,IAAI,CAAC,UAAU,OAAO,MAAA;AACtB,EAAA,OAAO,UAAU,QAAQ,CAAA;AAC7B;AAEA,IAAO,aAAA,GAAQ","file":"index.js","sourcesContent":["type ProbabilityMap = Record<string, number>\r\ntype Entry = [string, number]\r\n\r\nfunction filterNumbers(entries: Entry[]) {\r\n    return entries.filter(e => typeof e[1] === 'number' && !Number.isNaN(e[1]))\r\n}\r\n\r\nfunction sortEntries(entries: Entry[]) {\r\n    return entries.sort((a, b) => a[1] - b[1])\r\n}\r\n\r\nfunction sumProbabilities(entries: Entry[]) {\r\n    return entries.reduce((acc, e) => acc + e[1], 0)\r\n}\r\n\r\nfunction normalizeProbabilities(entries: Entry[], total: number) {\r\n    return entries.map(([k, v]) => [k, Math.round((v / total) * 100)] as Entry)\r\n}\r\n\r\nfunction prepareEntries(entries: Entry[]) {\r\n    const filtered = filterNumbers(entries)\r\n    if (filtered.length === 0) return\r\n    const sorted = sortEntries(filtered)\r\n    const sum = sumProbabilities(sorted)\r\n    if (sum === 0) return\r\n    if (sum === 100) return sorted\r\n    return normalizeProbabilities(sorted, sum)\r\n}\r\n\r\nfunction secureRandom(): number {\r\n    if (typeof globalThis.crypto === 'undefined' || typeof globalThis.crypto.getRandomValues !== 'function') {\r\n        return Math.random()\r\n    }\r\n    const array = new Uint32Array(1)\r\n    globalThis.crypto.getRandomValues(array)\r\n    return array[0]! / 0x100000000\r\n}\r\n\r\nfunction random(min: number, max: number) {\r\n    return secureRandom() * (max - min) + min\r\n}\r\n\r\nfunction chooseOne(entries: Entry[]) {\r\n    const num = random(1, 100)\r\n    let count = 0\r\n    for (const entry of entries) {\r\n        count += entry[1]\r\n        if (num <= count) return entry[0]\r\n    }\r\n    return entries[entries.length - 1]![0]\r\n}\r\n\r\nfunction probabilityPicker(map: ProbabilityMap): string | null | undefined {\r\n    if (!(map instanceof Object)) return null\r\n    const entries = Object.entries(map) as Entry[]\r\n    if (entries.length === 0) return undefined\r\n    const first = entries[0]\r\n    if (first && entries.length === 1) return first[0]\r\n    const prepared = prepareEntries(entries)\r\n    if (!prepared) return undefined\r\n    return chooseOne(prepared)\r\n}\r\n\r\nexport default probabilityPicker;"]}

package/package.json

@@ -1,9 +1,42 @@
 {
     "name": "probability-picker",
-    "version": "1.0.1",
-    "main": "probability-picker.js",
-    "license": "MIT",
+    "version": "1.2.0",
+    "description": "A lightweight library for selecting random values based on weighted probabilities.",
+    "main": "./dist/index.cjs",
+    "module": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js",
+            "require": "./dist/index.cjs"
+        }
+    },
+    "files": [
+        "dist",
+        "README.md",
+        "LICENSE"
+    ],
+    "scripts": {
+        "build": "tsup",
+        "dev": "tsup --watch",
+        "lint": "tsc --noEmit"
+    },
     "keywords": [
-        "probability"
-    ]
+        "probability",
+        "weighted",
+        "random"
+    ],
+    "author": "qgave (https://github.com/qgave)",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/qgave/probability-picker"
+    },
+    "type": "module",
+    "sideEffects": false,
+    "devDependencies": {
+        "tsup": "^8.5.1",
+        "typescript": "^5.9.3"
+    }
 }

package/probability-picker.js

@@ -1,68 +0,0 @@
-function probabilityPicker(e) {
-    if (e instanceof Object === false) return null;
-    let values = Object.entries(e);
-    if (values.length === 0) return undefined;
-    if (values.length === 1) return values[0][0];
-    values = prepareValues(values);
-    if (values === undefined) return;
-    return chooseOne(values);
-}
-
-function prepareValues(values) {
-    values = filterNumbers(values);
-    if (values.length === 0) return;
-    values = sortValues(values);
-    return prepareProbability(values);
-}
-
-function filterNumbers(values) {
-    const result = [];
-    for (let i = 0; i < values.length; i++) {
-        if (typeof values[i][1] === 'number' && !Number.isNaN(values[i][1])) {
-            result.push(values[i]);
-        }
-    }
-    return result;
-}
-
-function sortValues(values) {
-    return values.sort((a, b) => a[1] - b[1]);
-}
-
-function prepareProbability(values) {
-    const sum = sumProbabilities(values);
-    if (sum === 0) return;
-    if (sum === 100) return values;
-    return changeProbability(values, sum);
-}
-
-function changeProbability(values, totalProbability) {
-    for (let i = 0; i < values.length; i++) {
-        values[i][1] = Math.round((values[i][1] / totalProbability) * 100);
-    }
-    return values;
-}
-
-function sumProbabilities(values) {
-    let s = 0;
-    for (let i = 0; i < values.length; i++) {
-        s += values[i][1];
-    }
-    return s;
-}
-
-function chooseOne(values) {
-    const num = random(1, 100);
-    let count = 0;
-    for (let i = 0; i < values.length; i++) {
-        count += values[i][1];
-        if (num <= count) return values[i][0];
-    }
-    return values;
-}
-
-function random(min, max) {
-    return Math.random() * (max - min) + min;
-}
-
-export default probabilityPicker;