probability-picker 1.0.0 → 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 qgave
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

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

package/dist/index.cjs

@@ -0,0 +1,51 @@
+'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 random(min, max) {
+  return Math.random() * (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":";;;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,MAAA,CAAO,KAAa,GAAA,EAAa;AACtC,EAAA,OAAO,IAAA,CAAK,MAAA,EAAO,IAAK,GAAA,GAAM,GAAA,CAAA,GAAO,GAAA;AACzC;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.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 random(min: number, max: number) {\r\n    return Math.random() * (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,49 @@
+// 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 random(min, max) {
+  return Math.random() * (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,MAAA,CAAO,KAAa,GAAA,EAAa;AACtC,EAAA,OAAO,IAAA,CAAK,MAAA,EAAO,IAAK,GAAA,GAAM,GAAA,CAAA,GAAO,GAAA;AACzC;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 random(min: number, max: number) {\r\n    return Math.random() * (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,10 +1,42 @@
 {
     "name": "probability-picker",
-    "version": "1.0.0",
-    "main": "probability-picker.js",
-    "license": "MIT",
+    "version": "1.1.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": [
-        "javascript",
-        "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;