randomcryp 2.0.0 → 2.1.1

package/README.md

@@ -9,7 +9,7 @@ The spelling is random-creep in case you are wondering.
 - Lightweight
 - Browser friendly
 - TypeScript definitions
-- Lots of methods and commonn aliases
+- Lots of methods and common aliases
 - Batteries Included (Zero dependencies)
 - Supported in all major JavaScript / TypeScript runtimes (Browser, Node, Deno, Bun etc.)
 
@@ -44,18 +44,19 @@ rangeInt(1, 10); // 7
 | -- | -- | -- |
 | **`bool(): boolean`** | Generates a random boolean (`true` or `false`). | `bool()` → `true` |
 | **`boolean(): boolean`** | Alias for `bool()`. | `boolean()` → `false` |
-| **`percentage(val: number): boolean`** | Generates `true` at given percentage of time. | `percentage(20)` → `false` |
+| **`percentage(p: number): boolean`** | Generates `true` at given percentage of time. | `percentage(20)` → `false` |
+| **`probability(p: number): boolean`** | Generates `true` with a given probability `p` and `false` with probability `1-p`. | `probability(0.8)` → `true` |
 | **`uSafeInt(): number`** | Generates a random integer between `0` (inclusive) and `Number.MAX_SAFE_INTEGER` (inclusive). | `uSafeInt()` → `4946544243668033` |
 | **`float(): number`** | Generates a random number between `0` (inclusive) and `1` (exclusive). | `number()` → `0.190088246732104` |
 | **`random(): number`** | Alias for `float()`. | `random()` → `0.9520779718919631` |
 | **`hex(length: number = 8, prefix: boolean = false): string`** | Generates a random hex string of the specified length (default 8). Optionally prefixes with '0x'. | `hex(16)` → `d1ef0149c7849844` |
 | **`choice(arr: ArrayLike<E>): E`** | Selects a random element from an array. | `choice([1, 2, 3, 4, 5])` → `3` |
 | **`pick(arr: ArrayLike<E>): E`** | Alias for `choice()`. | `pick([1, 2, 3, 4, 5])` → `1` |
-| **`shuffle(input: string): string`**, **`shuffle(input: Array<E>): Array<E>`** | Returns a new array or string after shuffling the given array or string. | `shuffle([1, 2, 3, 4, 5])` → `[ 1, 3, 2, 5, 4 ]` |
+| **`shuffle(input: string): string`**, **`shuffle(input: Array<E>): Array<E>`** | Returns a new array or string after shuffling the given array or string randomly. | `shuffle([1, 2, 3, 4, 5])` → `[ 1, 3, 2, 5, 4 ]` |
 | **`range(min: number, max: number): number`** | Generates a random number (not integer) between given `min` (inclusive) and `max` (exclusive). Throws if `min` > `max`. | `range(1, 5)` → `4.103370176158448` |
 | **`rangeInt(min: number, max: number): number`** | Generates a random number (not integer) between given `min` (inclusive) and `max` (exclusive). Throws if `min` > `max`. | `rangeInt(1, 10)` → `8` |
 | **`randInt(min: number, max: number): number`** | Alias for `rangeInt()`. | `randInt(1, 100)` → `35` |
-| **`safeInt(): number`** | Generates a random integer between `Number.MIN_SAFE_INTEGER` (inclusive) and `Number.MAX_SAFE_INTEGER` (inclusive). +0 and -0 both can be generated. 54 bits precision. Not recommended for genral usage. | `safeInt()` → `-5802548511349229` |
+| **`safeInt(): number`** | Generates a random integer between `Number.MIN_SAFE_INTEGER` (inclusive) and `Number.MAX_SAFE_INTEGER` (inclusive). `+0` and `-0` both can be generated. `54` bits precision. Not recommended for general usage. | `safeInt()` → `-5802548511349229` |
 | **`ifloat(): number`** | Generates a random number between `-1` (inclusive) and `1` (inclusive). Uses `safeInt()` and thus not recommended. | `ifloat()` → `-0.6076475248861822` |
 
 © 2025, Md. Touhidur Rahman.

package/dist/index.d.ts

@@ -1,34 +1,54 @@
-import { bool } from "./lib/bool";
-import { boolean } from "./lib/boolean";
+import { ifloat } from "./lib/ifloat";
 import { choice } from "./lib/choice";
+import { randInt } from "./lib/randInt";
 import { float } from "./lib/float";
-import { hex } from "./lib/hex";
-import { ifloat } from "./lib/ifloat";
+import { bool } from "./lib/bool";
 import { percentage } from "./lib/percentage";
-import { pick } from "./lib/pick";
-import { randInt } from "./lib/randInt";
-import { random } from "./lib/random";
+import { uSafeInt } from "./lib/uSafeInt";
+import { probability } from "./lib/probability";
 import { range } from "./lib/range";
+import { random } from "./lib/random";
 import { rangeInt } from "./lib/rangeInt";
+import { boolean } from "./lib/boolean";
+import { hex } from "./lib/hex";
 import { safeInt } from "./lib/safeInt";
+import { pick } from "./lib/pick";
 import { shuffle } from "./lib/shuffle";
-import { uSafeInt } from "./lib/uSafeInt";
-export { bool, boolean, choice, float, hex, ifloat, percentage, pick, randInt, random, range, rangeInt, safeInt, shuffle, uSafeInt, };
-declare const _default: {
-    bool: () => boolean;
-    boolean: () => boolean;
-    choice: <E>(choices: ArrayLike<E>) => E | undefined;
-    float: () => number;
-    hex: (length?: number, prefix?: boolean) => string;
-    ifloat: () => number;
-    percentage: (input: number) => boolean;
-    pick: <E>(choices: ArrayLike<E>) => E | undefined;
-    randInt: (min: number, max: number) => number;
-    random: () => number;
-    range: (min: number, max: number) => number;
-    rangeInt: (min: number, max: number) => number;
-    safeInt: () => number;
-    shuffle: typeof shuffle;
-    uSafeInt: () => number;
+
+export {
+  ifloat,
+  choice,
+  randInt,
+  float,
+  bool,
+  percentage,
+  uSafeInt,
+  probability,
+  range,
+  random,
+  rangeInt,
+  boolean,
+  hex,
+  safeInt,
+  pick,
+  shuffle,
+};
+
+export default {
+  ifloat,
+  choice,
+  randInt,
+  float,
+  bool,
+  percentage,
+  uSafeInt,
+  probability,
+  range,
+  random,
+  rangeInt,
+  boolean,
+  hex,
+  safeInt,
+  pick,
+  shuffle,
 };
-export default _default;

package/dist/index.js

@@ -1,121 +1 @@
-// src/lib/uSafeInt.ts
-var POW_2_37 = Math.pow(2, 37);
-var POW_2_21 = Math.pow(2, 21);
-var POW_2_5 = Math.pow(2, 5);
-var uSafeInt = () => {
-  const [num1, num2, num3, num4] = crypto.getRandomValues(new Uint16Array(4));
-  return num1 * POW_2_37 + num2 * POW_2_21 + num3 * POW_2_5 + (num4 & POW_2_5 - 1);
-};
-
-// src/lib/bool.ts
-var bool = () => uSafeInt() % 2 === 0;
-// src/lib/float.ts
-var POW_2_53 = Math.pow(2, 53);
-var float = () => uSafeInt() / POW_2_53;
-
-// src/lib/choice.ts
-var choice = (choices) => {
-  if (choices.length === 0)
-    return;
-  return choices[Math.floor(float() * choices.length)];
-};
-
-// src/lib/hex.ts
-var digits = "0123456789abcdef";
-var hex = (length = 8, prefix = false) => {
-  const randArr = crypto.getRandomValues(new Uint8Array(Math.ceil(length / 2)));
-  const hexArr = new Array(randArr.length);
-  for (let i = 0, j = 0;i < length; i++, j = Math.floor(i / 2)) {
-    if (i % 2 === 0) {
-      hexArr[i] = digits[randArr[j] >> 4];
-    } else {
-      hexArr[i] = digits[randArr[j] & 15];
-    }
-  }
-  if (prefix)
-    return "0x" + hexArr.join("");
-  return hexArr.join("");
-};
-
-// src/lib/safeInt.ts
-var POW_2_372 = Math.pow(2, 37);
-var POW_2_212 = Math.pow(2, 21);
-var POW_2_52 = Math.pow(2, 5);
-var safeInt = () => {
-  const [num1, num2, num3, num4] = crypto.getRandomValues(new Uint16Array(4));
-  return ((num4 & POW_2_52) < 1 ? 1 : -1) * (num1 * POW_2_372 + num2 * POW_2_212 + num3 * POW_2_52 + (num4 & POW_2_52 - 1));
-};
-
-// src/lib/ifloat.ts
-var ifloat = () => safeInt() / Number.MAX_SAFE_INTEGER;
-
-// src/lib/percentage.ts
-var percentage = (input) => {
-  if (input < 0 || input > 100) {
-    throw new RangeError("input value should be between 0 and 100");
-  }
-  return float() * 100 < input;
-};
-// src/lib/rangeInt.ts
-var rangeInt = (min, max) => {
-  if (min > max) {
-    throw new RangeError("min must be less than or equal to max");
-  }
-  return min + Math.floor(float() * (max - min + 1));
-};
-// src/lib/range.ts
-var range = (min, max) => {
-  if (min > max) {
-    throw new RangeError("min must be less than or equal to max");
-  }
-  return min + float() * (max - min);
-};
-
-// src/lib/shuffle.ts
-function shuffle(input) {
-  const array = Array.from(input);
-  for (let i = array.length - 1;i > 0; i--) {
-    const pick = Math.floor(float() * (i + 1));
-    const temp = array[i];
-    array[i] = array[pick];
-    array[pick] = temp;
-  }
-  return typeof input === "string" ? array.join("") : array;
-}
-
-// src/index.ts
-var src_default = {
-  bool,
-  boolean: bool,
-  choice,
-  float,
-  hex,
-  ifloat,
-  percentage,
-  pick: choice,
-  randInt: rangeInt,
-  random: float,
-  range,
-  rangeInt,
-  safeInt,
-  shuffle,
-  uSafeInt
-};
-export {
-  uSafeInt,
-  shuffle,
-  safeInt,
-  rangeInt,
-  range,
-  float as random,
-  rangeInt as randInt,
-  choice as pick,
-  percentage,
-  ifloat,
-  hex,
-  float,
-  src_default as default,
-  choice,
-  bool as boolean,
-  bool
-};
+var k=Math.pow(2,37),N=Math.pow(2,21),D=Math.pow(2,5),L=()=>{let[z,B,H,J]=crypto.getRandomValues(new Uint16Array(4));return z*k+B*N+H*D+(J&D-1)};var Q=()=>L()%2===0;var R=Math.pow(2,53),C=()=>L()/R;var V=(z)=>{if(z.length===0)return;return z[Math.floor(C()*z.length)]};var U=(z=8,B=!1)=>{let H=crypto.getRandomValues(new Uint8Array(Math.ceil(z/2))),J=new Array(H.length);for(let K=0,$=0;K<z;K++,$=Math.floor(K/2))if(K%2===0)J[K]="0123456789abcdef"[H[$]>>4];else J[K]="0123456789abcdef"[H[$]&15];if(B)return"0x"+J.join("");return J.join("")};var S=Math.pow(2,37),I=Math.pow(2,21),q=Math.pow(2,5),Z=()=>{let[z,B,H,J]=crypto.getRandomValues(new Uint16Array(4));return((J&q)<1?1:-1)*(z*S+B*I+H*q+(J&q-1))};var X=()=>Z()/Number.MAX_SAFE_INTEGER;var F=(z)=>{if(z<0||z>100)throw new RangeError(`${z} is not in range [0, 100]`);return C()*100<z};var M=(z)=>{if(z<0||z>1)throw new RangeError(`${z} is not in range [0, 1]`);return C()<z};var Y=(z,B)=>{if(z>B)throw new RangeError("min must be less than or equal to max");return z+Math.floor(C()*(B-z+1))};var j=(z,B)=>{if(z>B)throw new RangeError("min must be less than or equal to max");return z+C()*(B-z)};function T(z){let B=Array.from(z);for(let H=B.length-1;H>0;H--){let J=Math.floor(C()*(H+1)),K=B[H];B[H]=B[J],B[J]=K}return typeof z==="string"?B.join(""):B}var Fz={bool:Q,boolean:Q,choice:V,float:C,hex:U,ifloat:X,percentage:F,probability:M,pick:V,randInt:Y,random:C,range:j,rangeInt:Y,safeInt:Z,shuffle:T,uSafeInt:L};export{L as uSafeInt,T as shuffle,Z as safeInt,Y as rangeInt,j as range,C as random,Y as randInt,M as probability,V as pick,F as percentage,X as ifloat,U as hex,C as float,Fz as default,V as choice,Q as boolean,Q as bool};

package/dist/lib/bool.d.ts

@@ -1,5 +1,5 @@
 /**
- * Generates a boolean value randomly.
- * true and false are equally likely.
+ * Generates a `boolean` value randomly.
+ * `true` and `false` are equally likely.
  **/
 export declare const bool: () => boolean;

package/dist/lib/choice.d.ts

@@ -1,6 +1,6 @@
 /**
  * Randomly choose an element from an array-like object.
- * @returns undefined if the array is empty.
+ * @returns `undefined` if the array is empty.
  * @returns a random element from the array if at least one element is present.
  * @example choice([1, 2, 3]) // 2
  */

package/dist/lib/float.d.ts

@@ -1,5 +1,5 @@
 /**
- * Generates a random number between 0 (inclusive) and 1 (exclusive).
- * with 53 bits precission.
+ * Generates a random number between `0` (inclusive) and `1` (exclusive).
+ * with `53` bits precission.
  **/
 export declare const float: () => number;

package/dist/lib/hex.d.ts

@@ -1,7 +1,7 @@
 /**
  * Generates a random hex string of the specified length.
  * @param {number} [length=8] - The length of the hex string to generate. Default is `8`.
- * @param {boolean} [prefix=false] - If true, the hex string will be prefixed with "0x". Default `false`.
+ * @param {boolean} [prefix=false] - If `true`, the hex string will be prefixed with `"0x"`. Default `false`.
  * @returns {string} A random hex string of the specified length.
  */
 export declare const hex: (length?: number, prefix?: boolean) => string;

package/dist/lib/ifloat.d.ts

@@ -1,5 +1,5 @@
 /**
- * Generates a random number between -1 (inclusive) and 1 (inclusive).
+ * Generates a random number between `-1` (inclusive) and `1` (inclusive).
  * Uses {@link safeInt} and thus not recommended for general usage also.
  *
  * Should be somewhat better for calculating PI.

package/dist/lib/percentage.d.ts

@@ -1,5 +1,6 @@
 /**
- * Generates true with the probability of the percentage value given.
+ * Generates `true` with the probability of the percentage value given.
  * @example percentage(20) // should return true 20% of the time and false 80% of the time.
+ * @throws RangeError if `p` is not range `[0, 100]`.
  **/
-export declare const percentage: (input: number) => boolean;
+export declare const percentage: (p: number) => boolean;

package/dist/lib/probability.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Generates `true` with a given probability `p` and `false` with probability `1-p`.
+ * @throws {RangeError} If `p` is not in range `[0, 1]`.
+ * @example probability(0.8); // returns true 80% of the time and false 20% of the time.
+ */
+export declare const probability: (p: number) => boolean;

package/dist/lib/uSafeInt.d.ts

@@ -1,6 +1,6 @@
 /**
  * Generates a random integer
- * between 0 (inclusive) and {@link Number.MAX_SAFE_INTEGER} (inclusive)
- * with 53 bits precission.
+ * between `0` (inclusive) and {@link Number.MAX_SAFE_INTEGER} (inclusive)
+ * with `53` bits precission.
  **/
 export declare const uSafeInt: () => number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "randomcryp",
-  "version": "2.0.0",
+  "version": "2.1.1",
   "license": "BSD-3-Clause",
   "description": "A cryptographically secure, feature rich, zero dependency and browser friendly random number generator library.",
   "author": {
@@ -17,12 +17,12 @@
   "types": "dist/index.d.ts",
   "scripts": {
     "format": "prettier --write .",
-    "build": "bun build src/index.ts --outdir dist && tsc -p tsconfig.dts.json"
+    "build": "bun scripts/build.ts"
   },
   "devDependencies": {
-    "@types/bun": "^1.2.8",
+    "@types/bun": "^1.2.9",
     "prettier": "^3.5.3",
-    "typescript": "^5.8.2"
+    "typescript": "^5.8.3"
   },
   "keywords": [
     "cryptographically-secure",