@alwatr/random 5.1.31 → 6.0.1

package/dist/main.js

@@ -0,0 +1,5 @@
+/* 📦 @alwatr/random v6.0.1 */
+import{getGlobalThis as P}from"@alwatr/global-this";var J=P(),Q=(()=>typeof J.crypto<"u")();function B(f){let k="";for(let v of f){let q=v.toString(16);k+=q.length===1?"0"+q:q}return k}function U(){return Math.random()}function R(f,k){return Math.random()*(k-f)+f}function D(f,k){return Math.floor(R(f,k+1))}function V(f,k=f,v="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789"){let q=k===f?f:D(f,k);if(q<=0)return"";let K=v.length,M="";if(q<=10){for(let z=0;z<q;z++)M+=v.charAt(Math.floor(Math.random()*K));return M}let N=Array(q);for(let z=0;z<q;z++)N[z]=v.charAt(Math.floor(Math.random()*K));return N.join("")}function W(f,k,v){if(v===0)return f;let q=Math.floor((k-f)/v);return f+D(0,q)*v}function X(f){for(let k=f.length-1;k>0;k--){let v=D(0,k);[f[k],f[v]]=[f[v],f[k]]}return f}function Y(f){if(f.length===0)throw Error("Cannot pick from empty array");return f[D(0,f.length-1)]}function O(f,k=0,v=255){for(let q=f.length-1;q>=0;q--)f[q]=D(k,v);return f}function Z(){if(Q&&J.crypto?.randomUUID)return J.crypto.randomUUID();let f=O(new Uint8Array(16));return f[6]=f[6]&15|64,f[8]=f[8]&191|128,`${B(f.subarray(0,4))}-${B(f.subarray(4,6))}-${B(f.subarray(6,8))}-${B(f.subarray(8,10))}-${B(f.subarray(10,16))}`}function _(f=0.5){return Math.random()<f}function $(){let f=O([,,,]);return`#${B(f)}`}export{Z as randUuid,V as randString,W as randStep,X as randShuffle,Y as randPick,U as randNumber,D as randInteger,R as randFloat,$ as randColor,_ as randBoolean,O as randArray,B as bytesToHex};
+
+//# debugId=9652FDFB4D6F485764756E2164756E21
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/main.ts"],
+  "sourcesContent": [
+    "import {getGlobalThis} from '@alwatr/global-this';\n\nconst globalThis = getGlobalThis();\n\n// Use the native crypto module when available for better randomness\nconst hasCrypto = (() => typeof globalThis.crypto !== 'undefined')();\n\n/**\n * Converts a Uint8Array or number array into a hexadecimal string representation.\n * Each byte is converted to a two-character hex string (padded with a leading zero if necessary)\n * and concatenated together to form a single string.\n *\n * @param bytes - The array of bytes to convert to hexadecimal\n * @returns A hexadecimal string representation of the input bytes\n *\n * @example\n * ```ts\n * // Using with Uint8Array\n * const bytes = new Uint8Array([10, 255, 0, 16]);\n * bytesToHex(bytes); // Returns \"0aff0010\"\n *\n * // Using with number array\n * const array = [171, 205, 3];\n * bytesToHex(array); // Returns \"abcd03\"\n * ```\n */\nexport function bytesToHex(bytes: number[] | Uint8Array): string {\n  let result = '';\n  for (const byte of bytes) {\n    const hex = byte.toString(16);\n    result += hex.length === 1 ? '0' + hex : hex;\n  }\n  return result;\n}\n\n/**\n * Returns a float random number between 0 and 1 (1 not included).\n *\n * Example:\n *\n * ```js\n * console.log(randNumber()); // 0.7124123\n * ```\n */\nexport function randNumber(): number {\n  return Math.random();\n}\n\n/**\n * Generate a random float number between min and max (max not included).\n *\n * Example:\n *\n * ```js\n * console.log(randFloat(1, 10)); // somewhere between 1 and 10 (as float)\n * ```\n */\nexport function randFloat(min: number, max: number): number {\n  return Math.random() * (max - min) + min;\n}\n\n/**\n * Generate a random integer number between min and max (max included).\n *\n * Example:\n *\n * ```js\n * console.log(randInteger(1, 10)); // somewhere between 1 and 10\n * ```\n */\nexport function randInteger(min: number, max: number): number {\n  // Use Math.floor and add 1 to max for better distribution\n  return Math.floor(randFloat(min, max + 1));\n}\n\n/**\n * Generate a random string with specified length.\n * The string will contain only characters from the characters list.\n * The length of the string will be between min and max (max included).\n * If max not specified, the length will be set to min.\n *\n * Example:\n *\n *```js\n * console.log(randString(6)); // something like 'Aab1V2'\n * console.log(randString(3, 6)); // random length between 3 and 6\n * console.log(randString(5, undefined, '01')); // binary string like '10101'\n * ```\n */\nexport function randString(\n  minLength: number,\n  maxLength: number = minLength,\n  chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789',\n): string {\n  const length = maxLength === minLength ? minLength : randInteger(minLength, maxLength);\n  if (length <= 0) return '';\n\n  const charsLength = chars.length;\n\n  let result = '';\n\n  // Small optimization for short strings\n  if (length <= 10) {\n    for (let i = 0; i < length; i++) {\n      result += chars.charAt(Math.floor(Math.random() * charsLength));\n    }\n    return result;\n  }\n  // else\n  // For longer strings, use array join for better performance\n  const resultArray = new Array(length);\n  for (let i = 0; i < length; i++) {\n    resultArray[i] = chars.charAt(Math.floor(Math.random() * charsLength));\n  }\n  return resultArray.join('');\n}\n\n/**\n * Generate a random integer between min and max with a step.\n *\n * Example:\n *\n * ```js\n * console.log(randStep(6, 10, 2)); // 6 or 8 or 10\n * ```\n */\nexport function randStep(min: number, max: number, step: number): number {\n  if (step === 0) {\n    return min; // Return min when step is 0 to avoid division by zero\n  }\n  const steps = Math.floor((max - min) / step);\n  return min + randInteger(0, steps) * step;\n}\n\n/**\n * Shuffle an array in place using Fisher-Yates shuffle algorithm and return it.\n *\n * Example:\n *\n * ```js\n * const array = [1, 2, 3, 4, 5];\n * randShuffle(array);\n * console.log(array); // [2, 4, 3, 1, 5] (randomized)\n * ```\n */\nexport function randShuffle<T>(array: T[]): T[] {\n  for (let i = array.length - 1; i > 0; i--) {\n    const j = randInteger(0, i);\n    [array[i], array[j]] = [array[j], array[i]];\n  }\n  return array;\n}\n\n/**\n * Choose a random item from an array.\n * Throws an error if the array is empty.\n *\n * Example:\n *\n * ```js\n * const array = [1, 2, 3, 4, 5];\n * console.log(randPick(array)); // one random element\n * ```\n */\nexport function randPick<T>(array: T[]): T {\n  if (array.length === 0) throw new Error('Cannot pick from empty array');\n  return array[randInteger(0, array.length - 1)];\n}\n\n/**\n * Fills a typed array with random integer values within the specified range.\n * The array is modified in place and also returned for chaining.\n *\n * @param array - The array to fill with random values (modified in place)\n * @param min - Minimum value (inclusive), defaults to 0\n * @param max - Maximum value (inclusive), defaults to 255\n * @returns The same array that was passed in (for chaining)\n *\n * @example\n * ```ts\n * // Fill a Uint8Array with random values (0-255)\n * randArray(new Uint8Array(10));\n *\n * // Fill with custom range\n * randArray(new Uint16Array(5), 1000, 2000); // Values between 1000-2000\n *\n * // Also works with number arrays\n * randArray(new Array<number>(8), -100, 100); // Values between -100 and 100\n * ```\n */\nexport function randArray<T extends number[] | Uint8Array | Uint16Array | Uint32Array>(array: T, min = 0, max = 255): T {\n  for (let i = array.length - 1; i >= 0; i--) {\n    array[i] = randInteger(min, max);\n  }\n  return array;\n}\n\n/**\n * Type alias for a UUID string.\n */\nexport type UUID = `${string}-${string}-${string}-${string}-${string}`;\n\n/**\n * Generate a random UUID (v4).\n *\n * Example:\n *\n * ```js\n * console.log(randUuid()); // \"a1b2c3d4-e5f6-47a8-b9c0-d1e2f3a4b5c6\"\n * ```\n */\nexport function randUuid(): UUID {\n  if (hasCrypto && globalThis.crypto?.randomUUID) {\n    return globalThis.crypto.randomUUID() as UUID;\n  }\n\n  // Fallback implementation\n  const bytes = randArray(new Uint8Array(16));\n  bytes[6] = (bytes[6] & 0x0f) | 0x40; // version 4\n  bytes[8] = (bytes[8] & 0xbf) | 0x80; // variant RFC4122\n\n  // prettier-ignore\n  return `${\n    bytesToHex(bytes.subarray(0, 4))\n  }-${\n    bytesToHex(bytes.subarray(4, 6))\n  }-${\n    bytesToHex(bytes.subarray(6, 8))\n  }-${\n    bytesToHex(bytes.subarray(8, 10))\n  }-${\n    bytesToHex(bytes.subarray(10, 16))\n  }` as UUID;\n}\n\n/**\n * Generate a random boolean with specified probability of being true.\n *\n * Example:\n *\n * ```js\n * console.log(randBoolean()); // 50% chance of true\n * console.log(randBoolean(0.8)); // 80% chance of true\n * ```\n */\nexport function randBoolean(probability = 0.5): boolean {\n  return Math.random() < probability;\n}\n\n/**\n * Generate a random hex color string.\n *\n * Example:\n *\n * ```js\n * console.log(randColor()); // \"#a1b2c3\"\n * ```\n */\nexport function randColor(): string {\n  const bytes = randArray(new Array<number>(3));\n  return `#${bytesToHex(bytes)}`;\n}\n"
+  ],
+  "mappings": ";AAAA,wBAAQ,4BAER,IAAM,EAAa,EAAc,EAG3B,GAAa,IAAM,OAAO,EAAW,OAAW,KAAa,EAqB5D,SAAS,CAAU,CAAC,EAAsC,CAC/D,IAAI,EAAS,GACb,QAAW,KAAQ,EAAO,CACxB,IAAM,EAAM,EAAK,SAAS,EAAE,EAC5B,GAAU,EAAI,SAAW,EAAI,IAAM,EAAM,EAE3C,OAAO,EAYF,SAAS,CAAU,EAAW,CACnC,OAAO,KAAK,OAAO,EAYd,SAAS,CAAS,CAAC,EAAa,EAAqB,CAC1D,OAAO,KAAK,OAAO,GAAK,EAAM,GAAO,EAYhC,SAAS,CAAW,CAAC,EAAa,EAAqB,CAE5D,OAAO,KAAK,MAAM,EAAU,EAAK,EAAM,CAAC,CAAC,EAiBpC,SAAS,CAAU,CACxB,EACA,EAAoB,EACpB,EAAQ,iEACA,CACR,IAAM,EAAS,IAAc,EAAY,EAAY,EAAY,EAAW,CAAS,EACrF,GAAI,GAAU,EAAG,MAAO,GAExB,IAAM,EAAc,EAAM,OAEtB,EAAS,GAGb,GAAI,GAAU,GAAI,CAChB,QAAS,EAAI,EAAG,EAAI,EAAQ,IAC1B,GAAU,EAAM,OAAO,KAAK,MAAM,KAAK,OAAO,EAAI,CAAW,CAAC,EAEhE,OAAO,EAIT,IAAM,EAAkB,MAAM,CAAM,EACpC,QAAS,EAAI,EAAG,EAAI,EAAQ,IAC1B,EAAY,GAAK,EAAM,OAAO,KAAK,MAAM,KAAK,OAAO,EAAI,CAAW,CAAC,EAEvE,OAAO,EAAY,KAAK,EAAE,EAYrB,SAAS,CAAQ,CAAC,EAAa,EAAa,EAAsB,CACvE,GAAI,IAAS,EACX,OAAO,EAET,IAAM,EAAQ,KAAK,OAAO,EAAM,GAAO,CAAI,EAC3C,OAAO,EAAM,EAAY,EAAG,CAAK,EAAI,EAchC,SAAS,CAAc,CAAC,EAAiB,CAC9C,QAAS,EAAI,EAAM,OAAS,EAAG,EAAI,EAAG,IAAK,CACzC,IAAM,EAAI,EAAY,EAAG,CAAC,EAC1B,CAAC,EAAM,GAAI,EAAM,EAAE,EAAI,CAAC,EAAM,GAAI,EAAM,EAAE,EAE5C,OAAO,EAcF,SAAS,CAAW,CAAC,EAAe,CACzC,GAAI,EAAM,SAAW,EAAG,MAAU,MAAM,8BAA8B,EACtE,OAAO,EAAM,EAAY,EAAG,EAAM,OAAS,CAAC,GAwBvC,SAAS,CAAsE,CAAC,EAAU,EAAM,EAAG,EAAM,IAAQ,CACtH,QAAS,EAAI,EAAM,OAAS,EAAG,GAAK,EAAG,IACrC,EAAM,GAAK,EAAY,EAAK,CAAG,EAEjC,OAAO,EAiBF,SAAS,CAAQ,EAAS,CAC/B,GAAI,GAAa,EAAW,QAAQ,WAClC,OAAO,EAAW,OAAO,WAAW,EAItC,IAAM,EAAQ,EAAU,IAAI,WAAW,EAAE,CAAC,EAK1C,OAJA,EAAM,GAAM,EAAM,GAAK,GAAQ,GAC/B,EAAM,GAAM,EAAM,GAAK,IAAQ,IAGxB,GACL,EAAW,EAAM,SAAS,EAAG,CAAC,CAAC,KAE/B,EAAW,EAAM,SAAS,EAAG,CAAC,CAAC,KAE/B,EAAW,EAAM,SAAS,EAAG,CAAC,CAAC,KAE/B,EAAW,EAAM,SAAS,EAAG,EAAE,CAAC,KAEhC,EAAW,EAAM,SAAS,GAAI,EAAE,CAAC,IAc9B,SAAS,CAAW,CAAC,EAAc,IAAc,CACtD,OAAO,KAAK,OAAO,EAAI,EAYlB,SAAS,CAAS,EAAW,CAClC,IAAM,EAAQ,EAAU,KAAoB,EAC5C,MAAO,IAAI,EAAW,CAAK",
+  "debugId": "9652FDFB4D6F485764756E2164756E21",
+  "names": []
+}

package/package.json

@@ -1,32 +1,59 @@
 {
   "name": "@alwatr/random",
+  "version": "6.0.1",
   "description": "A lightweight utility library for generating random numbers, strings, UUIDs and more",
-  "version": "5.1.31",
+  "license": "MPL-2.0",
   "author": "S. Ali Mihandoost <ali.mihandoost@gmail.com>",
+  "type": "module",
+  "repository": {
+    "directory": "packages/random",
+    "type": "git",
+    "url": "https://github.com/Alwatr/nanolib"
+  },
+  "homepage": "https://github.com/Alwatr/nanolib/tree/next/packages/random#readme",
   "bugs": "https://github.com/Alwatr/nanolib/issues",
+  "exports": {
+    ".": {
+      "types": "./dist/main.d.ts",
+      "default": "./dist/main.js"
+    }
+  },
+  "sideEffects": false,
   "dependencies": {
-    "@alwatr/global-this": "5.6.10"
+    "@alwatr/global-this": "6.0.1"
   },
   "devDependencies": {
-    "@alwatr/nano-build": "6.4.2",
-    "@alwatr/prettier-config": "6.0.2",
-    "@alwatr/tsconfig-base": "6.0.4",
+    "@alwatr/nano-build": "7.0.1",
+    "@alwatr/prettier-config": "7.0.1",
+    "@alwatr/tsconfig-base": "8.0.0",
     "typescript": "^5.9.3"
   },
-  "exports": {
-    ".": {
-      "types": "./dist/main.d.ts",
-      "import": "./dist/main.mjs",
-      "require": "./dist/main.cjs"
-    }
+  "scripts": {
+    "b": "bun run build",
+    "build": "bun run build:ts && bun run build:es",
+    "build:es": "nano-build --preset=module src/main.ts",
+    "build:ts": "tsc --build",
+    "c": "bun run clean",
+    "cb": "bun run clean && bun run build",
+    "clean": "rm -rfv dist *.tsbuildinfo",
+    "d": "bun run build:es && bun",
+    "t": "bun run test",
+    "test": "bun test",
+    "w": "bun run watch",
+    "watch": "bun run watch:ts & bun run watch:es",
+    "watch:es": "bun run build:es --watch",
+    "watch:ts": "bun run build:ts --watch --preserveWatchOutput"
   },
   "files": [
-    "**/*.{js,mjs,cjs,map,d.ts,html,md,LEGAL.txt}",
+    "**/*.{js,mjs,cjs,ts,map,d.ts,html,LEGAL.txt}",
+    "README.md",
     "LICENSE",
     "!demo/**/*",
     "!**/*.test.js"
   ],
-  "homepage": "https://github.com/Alwatr/nanolib/tree/next/packages/random#readme",
+  "publishConfig": {
+    "access": "public"
+  },
   "keywords": [
     "alwatr",
     "array-shuffle",
@@ -57,36 +84,6 @@
     "uuid",
     "uuid-v4"
   ],
-  "license": "MPL-2.0",
-  "main": "./dist/main.cjs",
-  "module": "./dist/main.mjs",
   "prettier": "@alwatr/prettier-config",
-  "publishConfig": {
-    "access": "public"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/Alwatr/nanolib",
-    "directory": "packages/random"
-  },
-  "scripts": {
-    "b": "bun run build",
-    "build": "bun run build:ts && bun run build:es",
-    "build:es": "nano-build --preset=module",
-    "build:ts": "tsc --build",
-    "c": "bun run clean",
-    "cb": "bun run clean && bun run build",
-    "clean": "rm -rfv dist *.tsbuildinfo",
-    "d": "bun run build:es && bun --enable-source-maps --trace-warnings",
-    "t": "bun run test",
-    "test": "bun test",
-    "w": "bun run watch",
-    "watch": "bun run watch:ts & bun run watch:es",
-    "watch:es": "bun run build:es --watch",
-    "watch:ts": "bun run build:ts --watch --preserveWatchOutput"
-  },
-  "sideEffects": false,
-  "type": "module",
-  "types": "./dist/main.d.ts",
-  "gitHead": "def1decf8f496f4b0d3d3ab952c346c689c30160"
+  "gitHead": "f843742e94d6ebed3921d57b624d9deb35c2c102"
 }

package/src/main.ts

@@ -0,0 +1,262 @@
+import {getGlobalThis} from '@alwatr/global-this';
+
+const globalThis = getGlobalThis();
+
+// Use the native crypto module when available for better randomness
+const hasCrypto = (() => typeof globalThis.crypto !== 'undefined')();
+
+/**
+ * Converts a Uint8Array or number array into a hexadecimal string representation.
+ * Each byte is converted to a two-character hex string (padded with a leading zero if necessary)
+ * and concatenated together to form a single string.
+ *
+ * @param bytes - The array of bytes to convert to hexadecimal
+ * @returns A hexadecimal string representation of the input bytes
+ *
+ * @example
+ * ```ts
+ * // Using with Uint8Array
+ * const bytes = new Uint8Array([10, 255, 0, 16]);
+ * bytesToHex(bytes); // Returns "0aff0010"
+ *
+ * // Using with number array
+ * const array = [171, 205, 3];
+ * bytesToHex(array); // Returns "abcd03"
+ * ```
+ */
+export function bytesToHex(bytes: number[] | Uint8Array): string {
+  let result = '';
+  for (const byte of bytes) {
+    const hex = byte.toString(16);
+    result += hex.length === 1 ? '0' + hex : hex;
+  }
+  return result;
+}
+
+/**
+ * Returns a float random number between 0 and 1 (1 not included).
+ *
+ * Example:
+ *
+ * ```js
+ * console.log(randNumber()); // 0.7124123
+ * ```
+ */
+export function randNumber(): number {
+  return Math.random();
+}
+
+/**
+ * Generate a random float number between min and max (max not included).
+ *
+ * Example:
+ *
+ * ```js
+ * console.log(randFloat(1, 10)); // somewhere between 1 and 10 (as float)
+ * ```
+ */
+export function randFloat(min: number, max: number): number {
+  return Math.random() * (max - min) + min;
+}
+
+/**
+ * Generate a random integer number between min and max (max included).
+ *
+ * Example:
+ *
+ * ```js
+ * console.log(randInteger(1, 10)); // somewhere between 1 and 10
+ * ```
+ */
+export function randInteger(min: number, max: number): number {
+  // Use Math.floor and add 1 to max for better distribution
+  return Math.floor(randFloat(min, max + 1));
+}
+
+/**
+ * Generate a random string with specified length.
+ * The string will contain only characters from the characters list.
+ * The length of the string will be between min and max (max included).
+ * If max not specified, the length will be set to min.
+ *
+ * Example:
+ *
+ *```js
+ * console.log(randString(6)); // something like 'Aab1V2'
+ * console.log(randString(3, 6)); // random length between 3 and 6
+ * console.log(randString(5, undefined, '01')); // binary string like '10101'
+ * ```
+ */
+export function randString(
+  minLength: number,
+  maxLength: number = minLength,
+  chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789',
+): string {
+  const length = maxLength === minLength ? minLength : randInteger(minLength, maxLength);
+  if (length <= 0) return '';
+
+  const charsLength = chars.length;
+
+  let result = '';
+
+  // Small optimization for short strings
+  if (length <= 10) {
+    for (let i = 0; i < length; i++) {
+      result += chars.charAt(Math.floor(Math.random() * charsLength));
+    }
+    return result;
+  }
+  // else
+  // For longer strings, use array join for better performance
+  const resultArray = new Array(length);
+  for (let i = 0; i < length; i++) {
+    resultArray[i] = chars.charAt(Math.floor(Math.random() * charsLength));
+  }
+  return resultArray.join('');
+}
+
+/**
+ * Generate a random integer between min and max with a step.
+ *
+ * Example:
+ *
+ * ```js
+ * console.log(randStep(6, 10, 2)); // 6 or 8 or 10
+ * ```
+ */
+export function randStep(min: number, max: number, step: number): number {
+  if (step === 0) {
+    return min; // Return min when step is 0 to avoid division by zero
+  }
+  const steps = Math.floor((max - min) / step);
+  return min + randInteger(0, steps) * step;
+}
+
+/**
+ * Shuffle an array in place using Fisher-Yates shuffle algorithm and return it.
+ *
+ * Example:
+ *
+ * ```js
+ * const array = [1, 2, 3, 4, 5];
+ * randShuffle(array);
+ * console.log(array); // [2, 4, 3, 1, 5] (randomized)
+ * ```
+ */
+export function randShuffle<T>(array: T[]): T[] {
+  for (let i = array.length - 1; i > 0; i--) {
+    const j = randInteger(0, i);
+    [array[i], array[j]] = [array[j], array[i]];
+  }
+  return array;
+}
+
+/**
+ * Choose a random item from an array.
+ * Throws an error if the array is empty.
+ *
+ * Example:
+ *
+ * ```js
+ * const array = [1, 2, 3, 4, 5];
+ * console.log(randPick(array)); // one random element
+ * ```
+ */
+export function randPick<T>(array: T[]): T {
+  if (array.length === 0) throw new Error('Cannot pick from empty array');
+  return array[randInteger(0, array.length - 1)];
+}
+
+/**
+ * Fills a typed array with random integer values within the specified range.
+ * The array is modified in place and also returned for chaining.
+ *
+ * @param array - The array to fill with random values (modified in place)
+ * @param min - Minimum value (inclusive), defaults to 0
+ * @param max - Maximum value (inclusive), defaults to 255
+ * @returns The same array that was passed in (for chaining)
+ *
+ * @example
+ * ```ts
+ * // Fill a Uint8Array with random values (0-255)
+ * randArray(new Uint8Array(10));
+ *
+ * // Fill with custom range
+ * randArray(new Uint16Array(5), 1000, 2000); // Values between 1000-2000
+ *
+ * // Also works with number arrays
+ * randArray(new Array<number>(8), -100, 100); // Values between -100 and 100
+ * ```
+ */
+export function randArray<T extends number[] | Uint8Array | Uint16Array | Uint32Array>(array: T, min = 0, max = 255): T {
+  for (let i = array.length - 1; i >= 0; i--) {
+    array[i] = randInteger(min, max);
+  }
+  return array;
+}
+
+/**
+ * Type alias for a UUID string.
+ */
+export type UUID = `${string}-${string}-${string}-${string}-${string}`;
+
+/**
+ * Generate a random UUID (v4).
+ *
+ * Example:
+ *
+ * ```js
+ * console.log(randUuid()); // "a1b2c3d4-e5f6-47a8-b9c0-d1e2f3a4b5c6"
+ * ```
+ */
+export function randUuid(): UUID {
+  if (hasCrypto && globalThis.crypto?.randomUUID) {
+    return globalThis.crypto.randomUUID() as UUID;
+  }
+
+  // Fallback implementation
+  const bytes = randArray(new Uint8Array(16));
+  bytes[6] = (bytes[6] & 0x0f) | 0x40; // version 4
+  bytes[8] = (bytes[8] & 0xbf) | 0x80; // variant RFC4122
+
+  // prettier-ignore
+  return `${
+    bytesToHex(bytes.subarray(0, 4))
+  }-${
+    bytesToHex(bytes.subarray(4, 6))
+  }-${
+    bytesToHex(bytes.subarray(6, 8))
+  }-${
+    bytesToHex(bytes.subarray(8, 10))
+  }-${
+    bytesToHex(bytes.subarray(10, 16))
+  }` as UUID;
+}
+
+/**
+ * Generate a random boolean with specified probability of being true.
+ *
+ * Example:
+ *
+ * ```js
+ * console.log(randBoolean()); // 50% chance of true
+ * console.log(randBoolean(0.8)); // 80% chance of true
+ * ```
+ */
+export function randBoolean(probability = 0.5): boolean {
+  return Math.random() < probability;
+}
+
+/**
+ * Generate a random hex color string.
+ *
+ * Example:
+ *
+ * ```js
+ * console.log(randColor()); // "#a1b2c3"
+ * ```
+ */
+export function randColor(): string {
+  const bytes = randArray(new Array<number>(3));
+  return `#${bytesToHex(bytes)}`;
+}

package/CHANGELOG.md

@@ -1,210 +0,0 @@
-# Change Log
-
-All notable changes to this project will be documented in this file.
-See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
-
-## [5.1.31](https://github.com/Alwatr/nanolib/compare/@alwatr/random@5.1.30...@alwatr/random@5.1.31) (2026-03-18)
-
-**Note:** Version bump only for package @alwatr/random
-
-## [5.1.30](https://github.com/Alwatr/nanolib/compare/@alwatr/random@5.1.29...@alwatr/random@5.1.30) (2026-03-16)
-
-### 🔨 Code Refactoring
-
-* migrate build scripts from yarn to bun across multiple packages ([d90e962](https://github.com/Alwatr/nanolib/commit/d90e962f15e5c951e191d5f02341279b6472abc3))
-
-## [5.1.29](https://github.com/Alwatr/nanolib/compare/@alwatr/random@5.1.28...@alwatr/random@5.1.29) (2026-02-18)
-
-**Note:** Version bump only for package @alwatr/random
-
-## [5.1.28](https://github.com/Alwatr/nanolib/compare/@alwatr/random@5.1.27...@alwatr/random@5.1.28) (2025-12-23)
-
-**Note:** Version bump only for package @alwatr/random
-
-## [5.1.27](https://github.com/Alwatr/nanolib/compare/@alwatr/random@5.1.26...@alwatr/random@5.1.27) (2025-12-13)
-
-**Note:** Version bump only for package @alwatr/random
-
-## [5.1.26](https://github.com/Alwatr/nanolib/compare/@alwatr/random@5.1.25...@alwatr/random@5.1.26) (2025-12-10)
-
-**Note:** Version bump only for package @alwatr/random
-
-## [5.1.25](https://github.com/Alwatr/nanolib/compare/@alwatr/random@5.1.24...@alwatr/random@5.1.25) (2025-11-18)
-
-### 🔨 Code Refactoring
-
-* remove unnecessary type declarations from tsconfig.json files ([89bcc7d](https://github.com/Alwatr/nanolib/commit/89bcc7db839807110b80f8ba34414ea9734d9c75))
-
-## [5.1.24](https://github.com/Alwatr/nanolib/compare/@alwatr/random@5.1.23...@alwatr/random@5.1.24) (2025-11-15)
-
-**Note:** Version bump only for package @alwatr/random
-
-## [5.1.23](https://github.com/Alwatr/nanolib/compare/@alwatr/random@5.1.22...@alwatr/random@5.1.23) (2025-11-15)
-
-**Note:** Version bump only for package @alwatr/random
-
-## [5.1.22](https://github.com/Alwatr/nanolib/compare/@alwatr/random@5.1.21...@alwatr/random@5.1.22) (2025-11-04)
-
-**Note:** Version bump only for package @alwatr/random
-
-## [5.1.21](https://github.com/Alwatr/nanolib/compare/@alwatr/random@5.1.20...@alwatr/random@5.1.21) (2025-10-06)
-
-### 🔗 Dependencies update
-
-* bump the npm-dependencies group with 4 updates ([9825815](https://github.com/Alwatr/nanolib/commit/982581552bbb4b97dca52af5e93a80937f0c3109))
-
-## [5.1.20](https://github.com/Alwatr/nanolib/compare/@alwatr/random@5.1.19...@alwatr/random@5.1.20) (2025-09-27)
-
-### 🧹 Miscellaneous Chores
-
-* exclude test files from package distribution ([86f4f2f](https://github.com/Alwatr/nanolib/commit/86f4f2f5985845c5cf3a3a9398de7b2f98ce53e7))
-
-## [5.1.19](https://github.com/Alwatr/nanolib/compare/@alwatr/random@5.1.18...@alwatr/random@5.1.19) (2025-09-22)
-
-**Note:** Version bump only for package @alwatr/random
-
-## [5.1.18](https://github.com/Alwatr/nanolib/compare/@alwatr/random@5.1.17...@alwatr/random@5.1.18) (2025-09-22)
-
-**Note:** Version bump only for package @alwatr/random
-
-## [5.1.17](https://github.com/Alwatr/nanolib/compare/@alwatr/random@5.1.16...@alwatr/random@5.1.17) (2025-09-21)
-
-**Note:** Version bump only for package @alwatr/random
-
-## [5.1.16](https://github.com/Alwatr/nanolib/compare/@alwatr/random@5.1.15...@alwatr/random@5.1.16) (2025-09-20)
-
-### 🐛 Bug Fixes
-
-* add sideEffects property to package.json files for better tree-shaking ([c7b9e74](https://github.com/Alwatr/nanolib/commit/c7b9e74e1920c8e35b438742de61883ca62da58c))
-* add sideEffects property to package.json files for better tree-shaking ([e8402c4](https://github.com/Alwatr/nanolib/commit/e8402c481a14a1f807a37aaa862a936713d26176))
-* remove unnecessary pure annotations ([adeb916](https://github.com/Alwatr/nanolib/commit/adeb9166f8e911f59269032b76c36cb1888332cf))
-
-### 🧹 Miscellaneous Chores
-
-* remove duplicate sideEffects property from multiple package.json files ([b123f86](https://github.com/Alwatr/nanolib/commit/b123f86be81481de2314aae9bb2eeb629743d24c))
-
-## [5.1.15](https://github.com/Alwatr/nanolib/compare/@alwatr/random@5.1.14...@alwatr/random@5.1.15) (2025-09-19)
-
-**Note:** Version bump only for package @alwatr/random
-
-## [5.1.14](https://github.com/Alwatr/nanolib/compare/@alwatr/random@5.1.13...@alwatr/random@5.1.14) (2025-09-15)
-
-**Note:** Version bump only for package @alwatr/random
-
-## [5.1.13](https://github.com/Alwatr/nanolib/compare/@alwatr/random@5.1.12...@alwatr/random@5.1.13) (2025-09-14)
-
-**Note:** Version bump only for package @alwatr/random
-
-## [5.1.12](https://github.com/Alwatr/nanolib/compare/@alwatr/random@5.1.11...@alwatr/random@5.1.12) (2025-09-13)
-
-**Note:** Version bump only for package @alwatr/random
-
-## [5.1.11](https://github.com/Alwatr/nanolib/compare/@alwatr/random@5.1.10...@alwatr/random@5.1.11) (2025-09-13)
-
-### 🧹 Miscellaneous Chores
-
-* remove package-tracer dependency and related code from fetch package ([96fe4e9](https://github.com/Alwatr/nanolib/commit/96fe4e9552a205f218ceed187c55e4e904a07089))
-
-## [5.1.10](https://github.com/Alwatr/nanolib/compare/@alwatr/random@5.1.9...@alwatr/random@5.1.10) (2025-09-09)
-
-### 🧹 Miscellaneous Chores
-
-* remove trailing newlines from contributing sections in README files ([e8ab1bc](https://github.com/Alwatr/nanolib/commit/e8ab1bc43e0addea5ccd4c897c2cec597cb9e15f))
-
-## [5.1.9](https://github.com/Alwatr/nanolib/compare/@alwatr/random@5.1.8...@alwatr/random@5.1.9) (2025-09-08)
-
-### 🔨 Code Refactoring
-
-* **main:** mark getGlobalThis and hasCrypto as pure for optimization ([8474cc2](https://github.com/Alwatr/nanolib/commit/8474cc247ef0a7df0975c72a5c1ab8240844b810))
-
-## [5.1.8](https://github.com/Alwatr/nanolib/compare/@alwatr/random@5.1.7...@alwatr/random@5.1.8) (2025-09-06)
-
-**Note:** Version bump only for package @alwatr/random
-
-## [5.1.7](https://github.com/Alwatr/nanolib/compare/@alwatr/random@5.1.6...@alwatr/random@5.1.7) (2025-09-05)
-
-### 🔗 Dependencies update
-
-* update jest to version 30.1.3 and @types/node to version 22.18.1 ([754212b](https://github.com/Alwatr/nanolib/commit/754212b1523cfc4cfe26c9e9f6d634aa8311e0b7))
-
-## [5.1.6](https://github.com/Alwatr/nanolib/compare/@alwatr/random@5.1.5...@alwatr/random@5.1.6) (2025-09-01)
-
-### 🔗 Dependencies update
-
-* update lerna-lite dependencies to version 4.7.3 and jest to 30.1.2 ([95d7870](https://github.com/Alwatr/nanolib/commit/95d7870ec7ad1e6ed2688bafddcabf46857f6981))
-
-## [5.1.5](https://github.com/Alwatr/nanolib/compare/@alwatr/random@5.1.4...@alwatr/random@5.1.5) (2025-08-23)
-
-**Note:** Version bump only for package @alwatr/random
-
-## [5.1.4](https://github.com/Alwatr/nanolib/compare/@alwatr/random@5.1.2...@alwatr/random@5.1.4) (2025-08-23)
-
-### 🐛 Bug Fixes
-
-* update license from AGPL-3.0-only to MPL-2.0 ([d20968e](https://github.com/Alwatr/nanolib/commit/d20968e60cc89b1dcdf9b96507178da6ed562f55))
-* update package versions in multiple package.json files ([7638b1c](https://github.com/Alwatr/nanolib/commit/7638b1cafee2b4e0f97db7a89ac9fba6384b9b10))
-
-### 🔨 Code Refactoring
-
-* Updated all package.json files in the project to change dependency version specifiers from "workspace:^" to "workspace:*" for consistency and to allow for more flexible version resolution. ([db6a4f7](https://github.com/Alwatr/nanolib/commit/db6a4f76deec2d1d8039978144e4bc51b6f1a0e3))
-
-### 🧹 Miscellaneous Chores
-
-* reformat all package.json files ([ceda45d](https://github.com/Alwatr/nanolib/commit/ceda45de186667790474f729cb4b161a5148ce19))
-
-### 🔗 Dependencies update
-
-* update TypeScript and Jest versions across all packages to improve compatibility and performance ([31baf36](https://github.com/Alwatr/nanolib/commit/31baf366101e92e27db66a21c849fb101f19be47))
-
-## [5.1.3](https://github.com/Alwatr/nanolib/compare/@alwatr/random@5.1.2...@alwatr/random@5.1.3) (2025-08-23)
-
-### Code Refactoring
-
-* Updated all package.json files in the project to change dependency version specifiers from "workspace:^" to "workspace:*" for consistency and to allow for more flexible version resolution. ([db6a4f7](https://github.com/Alwatr/nanolib/commit/db6a4f76deec2d1d8039978144e4bc51b6f1a0e3)) by @alimd
-
-## <small>5.1.2 (2025-04-15)</small>
-
-**Note:** Version bump only for package @alwatr/random
-
-## [5.1.1](https://github.com/Alwatr/nanolib/compare/@alwatr/random@5.1.0...@alwatr/random@5.1.1) (2025-04-01)
-
-**Note:** Version bump only for package @alwatr/random
-
-## 5.1.0 (2025-03-18)
-
-### Features
-
-* **random:** add hex function to convert Uint8Array to hexadecimal string ([61125e7](https://github.com/Alwatr/nanolib/commit/61125e7cf8b87094e026f578f8141df6ea5153f8)) by @alimd
-* **random:** add package.json for @alwatr/random utility library ([4c02a70](https://github.com/Alwatr/nanolib/commit/4c02a70a46a740ca7480769f8857880db296662a)) by @alimd
-* **random:** add randBoolean function to generate random boolean values with specified probability ([22ceca5](https://github.com/Alwatr/nanolib/commit/22ceca51af9e41bcd179a457a418736548865551)) by @alimd
-* **random:** add randColor function to generate random hex color strings ([1bde087](https://github.com/Alwatr/nanolib/commit/1bde0873459047e3ac9b11fe22a42600780daaca)) by @alimd
-* **random:** add randFloat function to generate a random float between specified min and max values ([1c7862a](https://github.com/Alwatr/nanolib/commit/1c7862af5239eb76589f537184b82bcf098f377b)) by @alimd
-* **random:** add randInteger function to generate a random integer between specified min and max values ([d9bf2c4](https://github.com/Alwatr/nanolib/commit/d9bf2c4c0bfc39030007679e3cf1a8ef90016b09)) by @alimd
-* **random:** add randPick function to select a random item from an array ([b4d9620](https://github.com/Alwatr/nanolib/commit/b4d962021f7cd180e89b4a32f2a7c85367e61cf6)) by @alimd
-* **random:** add randShuffle function to shuffle an array in place ([4124ec5](https://github.com/Alwatr/nanolib/commit/4124ec5e1ba2ec0915a91623333ef3b2d575fe5a)) by @alimd
-* **random:** add randStep function to generate a random integer between min and max with a specified step ([52bddca](https://github.com/Alwatr/nanolib/commit/52bddca00927780d28acb41e56f9558003a71476)) by @alimd
-* **random:** add randString function to generate a random string of specified length ([92fd657](https://github.com/Alwatr/nanolib/commit/92fd65764d370209f7e2115d1bee85e7da753a1f)) by @alimd
-* **random:** add randUuid function to generate random UUIDs (v4) ([805a941](https://github.com/Alwatr/nanolib/commit/805a9413fb9080e9bd90b162cbbbe9907c462d4a)) by @alimd
-* **random:** add randValues function to fill a typed array with cryptographically strong random values ([a3274c6](https://github.com/Alwatr/nanolib/commit/a3274c6c1a532ea05b4c9c0c9d7d98f9b452f37c)) by @alimd
-* **random:** add TypeScript configuration for @alwatr/random package ([6e8c85e](https://github.com/Alwatr/nanolib/commit/6e8c85ee358149ad1db17b432d4135fa38bc1488)) by @alimd
-* **random:** add UUID type alias for UUID string representation ([4f23d80](https://github.com/Alwatr/nanolib/commit/4f23d802672731d8700cf6808dd6bd7b18d3c0c4)) by @alimd
-* **random:** enhance randString function to support custom character sets and update documentation ([f8bc2d7](https://github.com/Alwatr/nanolib/commit/f8bc2d7091338cdccaa08b423c62f7797ffd21ef)) by @alimd
-* **random:** implement randNumber function to generate a random float between 0 and 1 ([6b06f45](https://github.com/Alwatr/nanolib/commit/6b06f4559334fc06d6987f4d76b04b6584c5f9b1)) by @alimd
-
-### Bug Fixes
-
-* downgrade version of hash-string and random packages to 5.0.0 ([176fc5c](https://github.com/Alwatr/nanolib/commit/176fc5c6a5af37d8b7cb7f41336910f0e8fcd0a9)) by @
-* **random:** initialize globalThis variable using getGlobalThis function ([191a827](https://github.com/Alwatr/nanolib/commit/191a827232762a435cc6b87f1cee31c0f1a8fc46)) by @alimd
-
-### Code Refactoring
-
-* **random:** improve randShuffle function to use Fisher-Yates algorithm for better shuffling ([3226a60](https://github.com/Alwatr/nanolib/commit/3226a605ac5b6211f82897e3e691347b30a69efa)) by @alimd
-* **random:** rename hex function to bytesToHex and update documentation for clarity ([3fcb327](https://github.com/Alwatr/nanolib/commit/3fcb327b41a5016cd5e7e7b5945f5b36383b3ab7)) by @alimd
-* **random:** rename randValues to randArray and update documentation for clarity and functionality ([48f8bd4](https://github.com/Alwatr/nanolib/commit/48f8bd469fe48a4db9cd0768cd2897cc6ad4f8a2)) by @alimd
-* **random:** replace randNumber with Math.random for improved clarity and performance ([c6227d5](https://github.com/Alwatr/nanolib/commit/c6227d5ac9217d8fdf89501673f52fa44464ef19)) by @alimd
-* **random:** replace randValues with randArray in randUuid function for consistency ([7b6fb37](https://github.com/Alwatr/nanolib/commit/7b6fb378c7705f8cf1604287638e482a33ae6d5e)) by @alimd
-* **random:** update bytesToHex function to accept number arrays and improve documentation ([6fef474](https://github.com/Alwatr/nanolib/commit/6fef474d3cb5aa6d10adcac37c1fc5256ca62605)) by @alimd
-
-### Miscellaneous Chores
-
-* **random:** add @alwatr/global-this dependency to package.json ([23856a1](https://github.com/Alwatr/nanolib/commit/23856a151b959a237a2e9a011cf6fb08a2f36eb1)) by @alimd

package/dist/main.cjs

@@ -1,3 +0,0 @@
-/** 📦 @alwatr/random v5.1.31 */
-"use strict";var __defProp=Object.defineProperty;var __getOwnPropDesc=Object.getOwnPropertyDescriptor;var __getOwnPropNames=Object.getOwnPropertyNames;var __hasOwnProp=Object.prototype.hasOwnProperty;var __export=(target,all)=>{for(var name in all)__defProp(target,name,{get:all[name],enumerable:true})};var __copyProps=(to,from,except,desc)=>{if(from&&typeof from==="object"||typeof from==="function"){for(let key of __getOwnPropNames(from))if(!__hasOwnProp.call(to,key)&&key!==except)__defProp(to,key,{get:()=>from[key],enumerable:!(desc=__getOwnPropDesc(from,key))||desc.enumerable})}return to};var __toCommonJS=mod=>__copyProps(__defProp({},"__esModule",{value:true}),mod);var main_exports={};__export(main_exports,{bytesToHex:()=>bytesToHex,randArray:()=>randArray,randBoolean:()=>randBoolean,randColor:()=>randColor,randFloat:()=>randFloat,randInteger:()=>randInteger,randNumber:()=>randNumber,randPick:()=>randPick,randShuffle:()=>randShuffle,randStep:()=>randStep,randString:()=>randString,randUuid:()=>randUuid});module.exports=__toCommonJS(main_exports);var import_global_this=require("@alwatr/global-this");var globalThis=(0,import_global_this.getGlobalThis)();var hasCrypto=(()=>typeof globalThis.crypto!=="undefined")();function bytesToHex(bytes){let result="";for(const byte of bytes){const hex=byte.toString(16);result+=hex.length===1?"0"+hex:hex}return result}function randNumber(){return Math.random()}function randFloat(min,max){return Math.random()*(max-min)+min}function randInteger(min,max){return Math.floor(randFloat(min,max+1))}function randString(minLength,maxLength=minLength,chars="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789"){const length=maxLength===minLength?minLength:randInteger(minLength,maxLength);if(length<=0)return"";const charsLength=chars.length;let result="";if(length<=10){for(let i=0;i<length;i++){result+=chars.charAt(Math.floor(Math.random()*charsLength))}return result}const resultArray=new Array(length);for(let i=0;i<length;i++){resultArray[i]=chars.charAt(Math.floor(Math.random()*charsLength))}return resultArray.join("")}function randStep(min,max,step){if(step===0){return min}const steps=Math.floor((max-min)/step);return min+randInteger(0,steps)*step}function randShuffle(array){for(let i=array.length-1;i>0;i--){const j=randInteger(0,i);[array[i],array[j]]=[array[j],array[i]]}return array}function randPick(array){if(array.length===0)throw new Error("Cannot pick from empty array");return array[randInteger(0,array.length-1)]}function randArray(array,min=0,max=255){for(let i=array.length-1;i>=0;i--){array[i]=randInteger(min,max)}return array}function randUuid(){if(hasCrypto&&globalThis.crypto?.randomUUID){return globalThis.crypto.randomUUID()}const bytes=randArray(new Uint8Array(16));bytes[6]=bytes[6]&15|64;bytes[8]=bytes[8]&191|128;return`${bytesToHex(bytes.subarray(0,4))}-${bytesToHex(bytes.subarray(4,6))}-${bytesToHex(bytes.subarray(6,8))}-${bytesToHex(bytes.subarray(8,10))}-${bytesToHex(bytes.subarray(10,16))}`}function randBoolean(probability=.5){return Math.random()<probability}function randColor(){const bytes=randArray(new Array(3));return`#${bytesToHex(bytes)}`}0&&(module.exports={bytesToHex,randArray,randBoolean,randColor,randFloat,randInteger,randNumber,randPick,randShuffle,randStep,randString,randUuid});
-//# sourceMappingURL=main.cjs.map

package/dist/main.cjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/main.ts"],
-  "sourcesContent": ["import {getGlobalThis} from '@alwatr/global-this';\n\nconst globalThis = getGlobalThis();\n\n// Use the native crypto module when available for better randomness\nconst hasCrypto = (() => typeof globalThis.crypto !== 'undefined')();\n\n/**\n * Converts a Uint8Array or number array into a hexadecimal string representation.\n * Each byte is converted to a two-character hex string (padded with a leading zero if necessary)\n * and concatenated together to form a single string.\n *\n * @param bytes - The array of bytes to convert to hexadecimal\n * @returns A hexadecimal string representation of the input bytes\n *\n * @example\n * ```ts\n * // Using with Uint8Array\n * const bytes = new Uint8Array([10, 255, 0, 16]);\n * bytesToHex(bytes); // Returns \"0aff0010\"\n *\n * // Using with number array\n * const array = [171, 205, 3];\n * bytesToHex(array); // Returns \"abcd03\"\n * ```\n */\nexport function bytesToHex(bytes: number[] | Uint8Array): string {\n  let result = '';\n  for (const byte of bytes) {\n    const hex = byte.toString(16);\n    result += hex.length === 1 ? '0' + hex : hex;\n  }\n  return result;\n}\n\n/**\n * Returns a float random number between 0 and 1 (1 not included).\n *\n * Example:\n *\n * ```js\n * console.log(randNumber()); // 0.7124123\n * ```\n */\nexport function randNumber(): number {\n  return Math.random();\n}\n\n/**\n * Generate a random float number between min and max (max not included).\n *\n * Example:\n *\n * ```js\n * console.log(randFloat(1, 10)); // somewhere between 1 and 10 (as float)\n * ```\n */\nexport function randFloat(min: number, max: number): number {\n  return Math.random() * (max - min) + min;\n}\n\n/**\n * Generate a random integer number between min and max (max included).\n *\n * Example:\n *\n * ```js\n * console.log(randInteger(1, 10)); // somewhere between 1 and 10\n * ```\n */\nexport function randInteger(min: number, max: number): number {\n  // Use Math.floor and add 1 to max for better distribution\n  return Math.floor(randFloat(min, max + 1));\n}\n\n/**\n * Generate a random string with specified length.\n * The string will contain only characters from the characters list.\n * The length of the string will be between min and max (max included).\n * If max not specified, the length will be set to min.\n *\n * Example:\n *\n *```js\n * console.log(randString(6)); // something like 'Aab1V2'\n * console.log(randString(3, 6)); // random length between 3 and 6\n * console.log(randString(5, undefined, '01')); // binary string like '10101'\n * ```\n */\nexport function randString(\n  minLength: number,\n  maxLength: number = minLength,\n  chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789',\n): string {\n  const length = maxLength === minLength ? minLength : randInteger(minLength, maxLength);\n  if (length <= 0) return '';\n\n  const charsLength = chars.length;\n\n  let result = '';\n\n  // Small optimization for short strings\n  if (length <= 10) {\n    for (let i = 0; i < length; i++) {\n      result += chars.charAt(Math.floor(Math.random() * charsLength));\n    }\n    return result;\n  }\n  // else\n  // For longer strings, use array join for better performance\n  const resultArray = new Array(length);\n  for (let i = 0; i < length; i++) {\n    resultArray[i] = chars.charAt(Math.floor(Math.random() * charsLength));\n  }\n  return resultArray.join('');\n}\n\n/**\n * Generate a random integer between min and max with a step.\n *\n * Example:\n *\n * ```js\n * console.log(randStep(6, 10, 2)); // 6 or 8 or 10\n * ```\n */\nexport function randStep(min: number, max: number, step: number): number {\n  if (step === 0) {\n    return min; // Return min when step is 0 to avoid division by zero\n  }\n  const steps = Math.floor((max - min) / step);\n  return min + randInteger(0, steps) * step;\n}\n\n/**\n * Shuffle an array in place using Fisher-Yates shuffle algorithm and return it.\n *\n * Example:\n *\n * ```js\n * const array = [1, 2, 3, 4, 5];\n * randShuffle(array);\n * console.log(array); // [2, 4, 3, 1, 5] (randomized)\n * ```\n */\nexport function randShuffle<T>(array: T[]): T[] {\n  for (let i = array.length - 1; i > 0; i--) {\n    const j = randInteger(0, i);\n    [array[i], array[j]] = [array[j], array[i]];\n  }\n  return array;\n}\n\n/**\n * Choose a random item from an array.\n * Throws an error if the array is empty.\n *\n * Example:\n *\n * ```js\n * const array = [1, 2, 3, 4, 5];\n * console.log(randPick(array)); // one random element\n * ```\n */\nexport function randPick<T>(array: T[]): T {\n  if (array.length === 0) throw new Error('Cannot pick from empty array');\n  return array[randInteger(0, array.length - 1)];\n}\n\n/**\n * Fills a typed array with random integer values within the specified range.\n * The array is modified in place and also returned for chaining.\n *\n * @param array - The array to fill with random values (modified in place)\n * @param min - Minimum value (inclusive), defaults to 0\n * @param max - Maximum value (inclusive), defaults to 255\n * @returns The same array that was passed in (for chaining)\n *\n * @example\n * ```ts\n * // Fill a Uint8Array with random values (0-255)\n * randArray(new Uint8Array(10));\n *\n * // Fill with custom range\n * randArray(new Uint16Array(5), 1000, 2000); // Values between 1000-2000\n *\n * // Also works with number arrays\n * randArray(new Array<number>(8), -100, 100); // Values between -100 and 100\n * ```\n */\nexport function randArray<T extends number[] | Uint8Array | Uint16Array | Uint32Array>(array: T, min = 0, max = 255): T {\n  for (let i = array.length - 1; i >= 0; i--) {\n    array[i] = randInteger(min, max);\n  }\n  return array;\n}\n\n/**\n * Type alias for a UUID string.\n */\nexport type UUID = `${string}-${string}-${string}-${string}-${string}`;\n\n/**\n * Generate a random UUID (v4).\n *\n * Example:\n *\n * ```js\n * console.log(randUuid()); // \"a1b2c3d4-e5f6-47a8-b9c0-d1e2f3a4b5c6\"\n * ```\n */\nexport function randUuid(): UUID {\n  if (hasCrypto && globalThis.crypto?.randomUUID) {\n    return globalThis.crypto.randomUUID() as UUID;\n  }\n\n  // Fallback implementation\n  const bytes = randArray(new Uint8Array(16));\n  bytes[6] = (bytes[6] & 0x0f) | 0x40; // version 4\n  bytes[8] = (bytes[8] & 0xbf) | 0x80; // variant RFC4122\n\n  // prettier-ignore\n  return `${\n    bytesToHex(bytes.subarray(0, 4))\n  }-${\n    bytesToHex(bytes.subarray(4, 6))\n  }-${\n    bytesToHex(bytes.subarray(6, 8))\n  }-${\n    bytesToHex(bytes.subarray(8, 10))\n  }-${\n    bytesToHex(bytes.subarray(10, 16))\n  }` as UUID;\n}\n\n/**\n * Generate a random boolean with specified probability of being true.\n *\n * Example:\n *\n * ```js\n * console.log(randBoolean()); // 50% chance of true\n * console.log(randBoolean(0.8)); // 80% chance of true\n * ```\n */\nexport function randBoolean(probability = 0.5): boolean {\n  return Math.random() < probability;\n}\n\n/**\n * Generate a random hex color string.\n *\n * Example:\n *\n * ```js\n * console.log(randColor()); // \"#a1b2c3\"\n * ```\n */\nexport function randColor(): string {\n  const bytes = randArray(new Array<number>(3));\n  return `#${bytesToHex(bytes)}`;\n}\n"],
-  "mappings": "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",
-  "names": []
-}

package/dist/main.mjs

@@ -1,3 +0,0 @@
-/** 📦 @alwatr/random v5.1.31 */
-import{getGlobalThis}from"@alwatr/global-this";var globalThis=getGlobalThis();var hasCrypto=(()=>typeof globalThis.crypto!=="undefined")();function bytesToHex(bytes){let result="";for(const byte of bytes){const hex=byte.toString(16);result+=hex.length===1?"0"+hex:hex}return result}function randNumber(){return Math.random()}function randFloat(min,max){return Math.random()*(max-min)+min}function randInteger(min,max){return Math.floor(randFloat(min,max+1))}function randString(minLength,maxLength=minLength,chars="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789"){const length=maxLength===minLength?minLength:randInteger(minLength,maxLength);if(length<=0)return"";const charsLength=chars.length;let result="";if(length<=10){for(let i=0;i<length;i++){result+=chars.charAt(Math.floor(Math.random()*charsLength))}return result}const resultArray=new Array(length);for(let i=0;i<length;i++){resultArray[i]=chars.charAt(Math.floor(Math.random()*charsLength))}return resultArray.join("")}function randStep(min,max,step){if(step===0){return min}const steps=Math.floor((max-min)/step);return min+randInteger(0,steps)*step}function randShuffle(array){for(let i=array.length-1;i>0;i--){const j=randInteger(0,i);[array[i],array[j]]=[array[j],array[i]]}return array}function randPick(array){if(array.length===0)throw new Error("Cannot pick from empty array");return array[randInteger(0,array.length-1)]}function randArray(array,min=0,max=255){for(let i=array.length-1;i>=0;i--){array[i]=randInteger(min,max)}return array}function randUuid(){if(hasCrypto&&globalThis.crypto?.randomUUID){return globalThis.crypto.randomUUID()}const bytes=randArray(new Uint8Array(16));bytes[6]=bytes[6]&15|64;bytes[8]=bytes[8]&191|128;return`${bytesToHex(bytes.subarray(0,4))}-${bytesToHex(bytes.subarray(4,6))}-${bytesToHex(bytes.subarray(6,8))}-${bytesToHex(bytes.subarray(8,10))}-${bytesToHex(bytes.subarray(10,16))}`}function randBoolean(probability=.5){return Math.random()<probability}function randColor(){const bytes=randArray(new Array(3));return`#${bytesToHex(bytes)}`}export{bytesToHex,randArray,randBoolean,randColor,randFloat,randInteger,randNumber,randPick,randShuffle,randStep,randString,randUuid};
-//# sourceMappingURL=main.mjs.map

package/dist/main.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/main.ts"],
-  "sourcesContent": ["import {getGlobalThis} from '@alwatr/global-this';\n\nconst globalThis = getGlobalThis();\n\n// Use the native crypto module when available for better randomness\nconst hasCrypto = (() => typeof globalThis.crypto !== 'undefined')();\n\n/**\n * Converts a Uint8Array or number array into a hexadecimal string representation.\n * Each byte is converted to a two-character hex string (padded with a leading zero if necessary)\n * and concatenated together to form a single string.\n *\n * @param bytes - The array of bytes to convert to hexadecimal\n * @returns A hexadecimal string representation of the input bytes\n *\n * @example\n * ```ts\n * // Using with Uint8Array\n * const bytes = new Uint8Array([10, 255, 0, 16]);\n * bytesToHex(bytes); // Returns \"0aff0010\"\n *\n * // Using with number array\n * const array = [171, 205, 3];\n * bytesToHex(array); // Returns \"abcd03\"\n * ```\n */\nexport function bytesToHex(bytes: number[] | Uint8Array): string {\n  let result = '';\n  for (const byte of bytes) {\n    const hex = byte.toString(16);\n    result += hex.length === 1 ? '0' + hex : hex;\n  }\n  return result;\n}\n\n/**\n * Returns a float random number between 0 and 1 (1 not included).\n *\n * Example:\n *\n * ```js\n * console.log(randNumber()); // 0.7124123\n * ```\n */\nexport function randNumber(): number {\n  return Math.random();\n}\n\n/**\n * Generate a random float number between min and max (max not included).\n *\n * Example:\n *\n * ```js\n * console.log(randFloat(1, 10)); // somewhere between 1 and 10 (as float)\n * ```\n */\nexport function randFloat(min: number, max: number): number {\n  return Math.random() * (max - min) + min;\n}\n\n/**\n * Generate a random integer number between min and max (max included).\n *\n * Example:\n *\n * ```js\n * console.log(randInteger(1, 10)); // somewhere between 1 and 10\n * ```\n */\nexport function randInteger(min: number, max: number): number {\n  // Use Math.floor and add 1 to max for better distribution\n  return Math.floor(randFloat(min, max + 1));\n}\n\n/**\n * Generate a random string with specified length.\n * The string will contain only characters from the characters list.\n * The length of the string will be between min and max (max included).\n * If max not specified, the length will be set to min.\n *\n * Example:\n *\n *```js\n * console.log(randString(6)); // something like 'Aab1V2'\n * console.log(randString(3, 6)); // random length between 3 and 6\n * console.log(randString(5, undefined, '01')); // binary string like '10101'\n * ```\n */\nexport function randString(\n  minLength: number,\n  maxLength: number = minLength,\n  chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789',\n): string {\n  const length = maxLength === minLength ? minLength : randInteger(minLength, maxLength);\n  if (length <= 0) return '';\n\n  const charsLength = chars.length;\n\n  let result = '';\n\n  // Small optimization for short strings\n  if (length <= 10) {\n    for (let i = 0; i < length; i++) {\n      result += chars.charAt(Math.floor(Math.random() * charsLength));\n    }\n    return result;\n  }\n  // else\n  // For longer strings, use array join for better performance\n  const resultArray = new Array(length);\n  for (let i = 0; i < length; i++) {\n    resultArray[i] = chars.charAt(Math.floor(Math.random() * charsLength));\n  }\n  return resultArray.join('');\n}\n\n/**\n * Generate a random integer between min and max with a step.\n *\n * Example:\n *\n * ```js\n * console.log(randStep(6, 10, 2)); // 6 or 8 or 10\n * ```\n */\nexport function randStep(min: number, max: number, step: number): number {\n  if (step === 0) {\n    return min; // Return min when step is 0 to avoid division by zero\n  }\n  const steps = Math.floor((max - min) / step);\n  return min + randInteger(0, steps) * step;\n}\n\n/**\n * Shuffle an array in place using Fisher-Yates shuffle algorithm and return it.\n *\n * Example:\n *\n * ```js\n * const array = [1, 2, 3, 4, 5];\n * randShuffle(array);\n * console.log(array); // [2, 4, 3, 1, 5] (randomized)\n * ```\n */\nexport function randShuffle<T>(array: T[]): T[] {\n  for (let i = array.length - 1; i > 0; i--) {\n    const j = randInteger(0, i);\n    [array[i], array[j]] = [array[j], array[i]];\n  }\n  return array;\n}\n\n/**\n * Choose a random item from an array.\n * Throws an error if the array is empty.\n *\n * Example:\n *\n * ```js\n * const array = [1, 2, 3, 4, 5];\n * console.log(randPick(array)); // one random element\n * ```\n */\nexport function randPick<T>(array: T[]): T {\n  if (array.length === 0) throw new Error('Cannot pick from empty array');\n  return array[randInteger(0, array.length - 1)];\n}\n\n/**\n * Fills a typed array with random integer values within the specified range.\n * The array is modified in place and also returned for chaining.\n *\n * @param array - The array to fill with random values (modified in place)\n * @param min - Minimum value (inclusive), defaults to 0\n * @param max - Maximum value (inclusive), defaults to 255\n * @returns The same array that was passed in (for chaining)\n *\n * @example\n * ```ts\n * // Fill a Uint8Array with random values (0-255)\n * randArray(new Uint8Array(10));\n *\n * // Fill with custom range\n * randArray(new Uint16Array(5), 1000, 2000); // Values between 1000-2000\n *\n * // Also works with number arrays\n * randArray(new Array<number>(8), -100, 100); // Values between -100 and 100\n * ```\n */\nexport function randArray<T extends number[] | Uint8Array | Uint16Array | Uint32Array>(array: T, min = 0, max = 255): T {\n  for (let i = array.length - 1; i >= 0; i--) {\n    array[i] = randInteger(min, max);\n  }\n  return array;\n}\n\n/**\n * Type alias for a UUID string.\n */\nexport type UUID = `${string}-${string}-${string}-${string}-${string}`;\n\n/**\n * Generate a random UUID (v4).\n *\n * Example:\n *\n * ```js\n * console.log(randUuid()); // \"a1b2c3d4-e5f6-47a8-b9c0-d1e2f3a4b5c6\"\n * ```\n */\nexport function randUuid(): UUID {\n  if (hasCrypto && globalThis.crypto?.randomUUID) {\n    return globalThis.crypto.randomUUID() as UUID;\n  }\n\n  // Fallback implementation\n  const bytes = randArray(new Uint8Array(16));\n  bytes[6] = (bytes[6] & 0x0f) | 0x40; // version 4\n  bytes[8] = (bytes[8] & 0xbf) | 0x80; // variant RFC4122\n\n  // prettier-ignore\n  return `${\n    bytesToHex(bytes.subarray(0, 4))\n  }-${\n    bytesToHex(bytes.subarray(4, 6))\n  }-${\n    bytesToHex(bytes.subarray(6, 8))\n  }-${\n    bytesToHex(bytes.subarray(8, 10))\n  }-${\n    bytesToHex(bytes.subarray(10, 16))\n  }` as UUID;\n}\n\n/**\n * Generate a random boolean with specified probability of being true.\n *\n * Example:\n *\n * ```js\n * console.log(randBoolean()); // 50% chance of true\n * console.log(randBoolean(0.8)); // 80% chance of true\n * ```\n */\nexport function randBoolean(probability = 0.5): boolean {\n  return Math.random() < probability;\n}\n\n/**\n * Generate a random hex color string.\n *\n * Example:\n *\n * ```js\n * console.log(randColor()); // \"#a1b2c3\"\n * ```\n */\nexport function randColor(): string {\n  const bytes = randArray(new Array<number>(3));\n  return `#${bytesToHex(bytes)}`;\n}\n"],
-  "mappings": "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",
-  "names": []
-}