@alwatr/random 5.1.19 → 5.1.21

package/CHANGELOG.md

@@ -3,6 +3,18 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [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

package/dist/main.cjs

@@ -1,4 +1,4 @@
-/** 📦 @alwatr/random v5.1.19 */
-__dev_mode__: console.debug("📦 @alwatr/random v5.1.19");
+/** 📦 @alwatr/random v5.1.21 */
+__dev_mode__: console.debug("📦 @alwatr/random v5.1.21");
 "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.mjs

@@ -1,4 +1,4 @@
-/** 📦 @alwatr/random v5.1.19 */
-__dev_mode__: console.debug("📦 @alwatr/random v5.1.19");
+/** 📦 @alwatr/random v5.1.21 */
+__dev_mode__: console.debug("📦 @alwatr/random v5.1.21");
 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/package.json

@@ -1,18 +1,18 @@
 {
   "name": "@alwatr/random",
   "description": "A lightweight utility library for generating random numbers, strings, UUIDs and more",
-  "version": "5.1.19",
+  "version": "5.1.21",
   "author": "S. Ali Mihandoost <ali.mihandoost@gmail.com>",
   "bugs": "https://github.com/Alwatr/nanolib/issues",
   "dependencies": {
-    "@alwatr/global-this": "5.5.19"
+    "@alwatr/global-this": "5.6.1"
   },
   "devDependencies": {
-    "@alwatr/nano-build": "6.3.3",
-    "@alwatr/prettier-config": "5.0.4",
-    "@alwatr/tsconfig-base": "6.0.2",
-    "jest": "^30.1.3",
-    "typescript": "^5.9.2"
+    "@alwatr/nano-build": "6.3.5",
+    "@alwatr/prettier-config": "5.0.5",
+    "@alwatr/tsconfig-base": "6.0.3",
+    "jest": "^30.2.0",
+    "typescript": "^5.9.3"
   },
   "exports": {
     ".": {
@@ -24,7 +24,8 @@
   "files": [
     "**/*.{js,mjs,cjs,map,d.ts,html,md,LEGAL.txt}",
     "LICENSE",
-    "!demo/**/*"
+    "!demo/**/*",
+    "!**/*.test.js"
   ],
   "homepage": "https://github.com/Alwatr/nanolib/tree/next/packages/random#readme",
   "keywords": [
@@ -88,5 +89,5 @@
   "sideEffects": false,
   "type": "module",
   "types": "./dist/main.d.ts",
-  "gitHead": "a0c8605949969959c8226e54b8c8c0fc7276819a"
+  "gitHead": "b141732f4dab13542e3cc99926a250fd5c74bad3"
 }

package/src/main.test.js

@@ -1,377 +0,0 @@
-import {
-  randNumber,
-  randInteger,
-  randFloat,
-  randString,
-  randStep,
-  randShuffle,
-  randPick,
-  randBoolean,
-  randColor,
-  randUuid,
-  randArray,
-  bytesToHex,
-} from '@alwatr/random';
-
-describe('@alwatr/random', () => {
-  describe('number generation', () => {
-    test('randNumber() returns a number between 0 and 1', () => {
-      const value = randNumber();
-      expect(typeof value).toBe('number');
-      expect(value).toBeGreaterThanOrEqual(0);
-      expect(value).toBeLessThan(1);
-    });
-  });
-
-  describe('integer generation', () => {
-    test('randInteger() returns an integer within the specified range', () => {
-      const min = 5;
-      const max = 10;
-      for (let i = 0; i < 100; i++) {
-        const value = randInteger(min, max);
-        expect(Number.isInteger(value)).toBe(true);
-        expect(value).toBeGreaterThanOrEqual(min);
-        expect(value).toBeLessThanOrEqual(max);
-      }
-    });
-
-    test('randInteger() with min equal to max', () => {
-      const value = randInteger(5, 5);
-      expect(value).toBe(5);
-    });
-
-    test('randInteger() with negative numbers', () => {
-      const min = -10;
-      const max = -5;
-      for (let i = 0; i < 100; i++) {
-        const value = randInteger(min, max);
-        expect(Number.isInteger(value)).toBe(true);
-        expect(value).toBeGreaterThanOrEqual(min);
-        expect(value).toBeLessThanOrEqual(max);
-      }
-    });
-  });
-
-  describe('float generation', () => {
-    test('randFloat() returns a float within the specified range', () => {
-      const min = 5;
-      const max = 10;
-      for (let i = 0; i < 100; i++) {
-        const value = randFloat(min, max);
-        expect(typeof value).toBe('number');
-        expect(value).toBeGreaterThanOrEqual(min);
-        expect(value).toBeLessThan(max);
-      }
-    });
-
-    test('randFloat() with min equal to max', () => {
-      const value = randFloat(5, 5);
-      expect(value).toBe(5);
-    });
-
-    test('randFloat() with negative numbers', () => {
-      const min = -10;
-      const max = -5;
-      for (let i = 0; i < 100; i++) {
-        const value = randFloat(min, max);
-        expect(typeof value).toBe('number');
-        expect(value).toBeGreaterThanOrEqual(min);
-        expect(value).toBeLessThan(max);
-      }
-    });
-  });
-
-  describe('string generation', () => {
-    test('randString() with fixed length', () => {
-      const length = 8;
-      const str = randString(length);
-      expect(str.length).toBe(length);
-      expect(typeof str).toBe('string');
-    });
-
-    test('randString() with variable length', () => {
-      const min = 5;
-      const max = 10;
-      const str = randString(min, max);
-      expect(str.length).toBeGreaterThanOrEqual(min);
-      expect(str.length).toBeLessThanOrEqual(max);
-    });
-
-    test('randString() with min equal to max', () => {
-      const length = 5;
-      const str = randString(length, length);
-      expect(str.length).toBe(length);
-    });
-
-    test('randString() returns empty string when min is 0', () => {
-      const str = randString(0);
-      expect(str.length).toBe(0);
-    });
-
-    test('randString() with custom character set', () => {
-      const length = 10;
-      const chars = '01'; // Binary characters
-      const str = randString(length, undefined, chars);
-
-      expect(str.length).toBe(length);
-      // Verify that only characters from the custom set are used
-      expect(str.split('').every((char) => chars.includes(char))).toBe(true);
-    });
-
-    test('randString() with custom character set and variable length', () => {
-      const min = 5;
-      const max = 10;
-      const chars = 'ABC123';
-      const str = randString(min, max, chars);
-
-      expect(str.length).toBeGreaterThanOrEqual(min);
-      expect(str.length).toBeLessThanOrEqual(max);
-      // Verify that only characters from the custom set are used
-      expect(str.split('').every((char) => chars.includes(char))).toBe(true);
-    });
-
-    test('randString() optimizes for short strings', () => {
-      // This test just ensures the code path for short strings works
-      const str = randString(10);
-      expect(str.length).toBe(10);
-    });
-
-    test('randString() handles longer strings with array join', () => {
-      // This test ensures the code path for longer strings works
-      const str = randString(20);
-      expect(str.length).toBe(20);
-    });
-  });
-
-  describe('step generation', () => {
-    test('randStep() returns a value with the correct step', () => {
-      const min = 0;
-      const max = 10;
-      const step = 2;
-      const validValues = [0, 2, 4, 6, 8, 10];
-
-      for (let i = 0; i < 100; i++) {
-        const value = randStep(min, max, step);
-        expect(validValues).toContain(value);
-      }
-    });
-
-    test('randStep() with min equal to max', () => {
-      const value = randStep(5, 5, 2);
-      expect(value).toBe(5);
-    });
-
-    test('randStep() with step 0', () => {
-      const value = randStep(5, 10, 0);
-      expect(value).toBe(5);
-    });
-
-    test('randStep() with negative numbers', () => {
-      const min = -10;
-      const max = -2;
-      const step = 2;
-      const validValues = [-10, -8, -6, -4, -2];
-
-      for (let i = 0; i < 100; i++) {
-        const value = randStep(min, max, step);
-        expect(validValues).toContain(value);
-      }
-    });
-  });
-
-  describe('array manipulation', () => {
-    test('randShuffle() shuffles an array', () => {
-      const original = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
-      const shuffled = [...original];
-      randShuffle(shuffled);
-
-      // Test the arrays are not identical (with very high probability)
-      // Note: there's a tiny chance this could fail even if randShuffle works correctly
-      let isDifferent = false;
-      for (let i = 0; i < original.length; i++) {
-        if (original[i] !== shuffled[i]) {
-          isDifferent = true;
-          break;
-        }
-      }
-      expect(isDifferent).toBe(true);
-
-      // Make sure it contains all the same elements
-      expect(original.sort()).toEqual(shuffled.sort());
-    });
-
-    test('randShuffle() does not modify an empty array', () => {
-      const original = [];
-      const shuffled = [...original];
-      randShuffle(shuffled);
-      expect(shuffled).toEqual(original);
-    });
-
-    test('randShuffle() returns the same array reference for chaining', () => {
-      const array = [1, 2, 3, 4, 5];
-      const result = randShuffle(array);
-      expect(result).toBe(array); // Same reference
-    });
-
-    test('randPick() selects a valid array element', () => {
-      const array = [1, 2, 3, 4, 5];
-      for (let i = 0; i < 100; i++) {
-        expect(array).toContain(randPick(array));
-      }
-    });
-
-    test('randPick() throws on empty array', () => {
-      expect(() => randPick([])).toThrow();
-    });
-  });
-
-  describe('uuid generation', () => {
-    test('randUuid() returns a valid UUID string', () => {
-      const uuid = randUuid();
-      const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
-      expect(uuidRegex.test(uuid)).toBe(true);
-    });
-
-    test('randUuid() creates properly formatted UUID v4', () => {
-      const uuid = randUuid();
-      const parts = uuid.split('-');
-
-      expect(parts.length).toBe(5);
-      expect(parts[0].length).toBe(8);
-      expect(parts[1].length).toBe(4);
-      expect(parts[2].length).toBe(4);
-      expect(parts[3].length).toBe(4);
-      expect(parts[4].length).toBe(12);
-
-      // Version 4 UUID has the 13th character as '4'
-      expect(uuid.charAt(14)).toBe('4');
-
-      // Variant should be binary 10xx (8, 9, a, or b)
-      const variantChar = uuid.charAt(19);
-      expect(['8', '9', 'a', 'b', 'A', 'B']).toContain(variantChar);
-    });
-  });
-
-  describe('boolean generation', () => {
-    test('randBoolean() returns a boolean', () => {
-      expect(typeof randBoolean()).toBe('boolean');
-    });
-
-    test('randBoolean() with probability 0', () => {
-      let trueCount = 0;
-      const samples = 20;
-
-      for (let i = 0; i < samples; i++) {
-        if (randBoolean(0)) trueCount++;
-      }
-
-      expect(trueCount).toBe(0);
-    });
-
-    test('randBoolean() with probability 1', () => {
-      let trueCount = 0;
-      const samples = 20;
-
-      for (let i = 0; i < samples; i++) {
-        if (randBoolean(1)) trueCount++;
-      }
-
-      expect(trueCount).toBe(samples);
-    });
-
-    test('randBoolean() with default probability', () => {
-      // This just checks that the function runs with default parameters
-      // Statistical testing would be unreliable in unit tests
-      const result = randBoolean();
-      expect(typeof result).toBe('boolean');
-    });
-  });
-
-  describe('color generation', () => {
-    test('randColor() returns a valid hex color', () => {
-      const color = randColor();
-      const colorRegex = /^#[0-9a-f]{6}$/i;
-      expect(colorRegex.test(color)).toBe(true);
-    });
-  });
-
-  describe('random array filling', () => {
-    test('randArray() fills typed array with random values', () => {
-      const array = new Uint8Array(10);
-      const emptyArray = new Uint8Array(10);
-
-      randArray(array);
-
-      // Extremely unlikely that a randomly filled array would equal an empty one
-      expect(array).not.toEqual(emptyArray);
-    });
-
-    test('randArray() fills different typed arrays', () => {
-      const array8 = new Uint8Array(10);
-      const array16 = new Uint16Array(5);
-      const array32 = new Uint32Array(2);
-
-      randArray(array8);
-      randArray(array16);
-      randArray(array32);
-
-      expect(array8.every(Number.isInteger)).toBe(true);
-      expect(array16.every(Number.isInteger)).toBe(true);
-      expect(array32.every(Number.isInteger)).toBe(true);
-    });
-
-    test('randArray() respects min and max parameters', () => {
-      const array = new Uint8Array(100);
-      const min = 10;
-      const max = 20;
-
-      randArray(array, min, max);
-
-      // Check that all values are in range
-      for (const value of array) {
-        expect(value).toBeGreaterThanOrEqual(min);
-        expect(value).toBeLessThanOrEqual(max);
-      }
-    });
-
-    test('randArray() returns the same array for chaining', () => {
-      const array = new Uint8Array(10);
-      const result = randArray(array);
-      expect(result).toBe(array); // Same reference
-    });
-
-    test('randArray() works with regular number arrays', () => {
-      const array = new Array(5);
-      randArray(array, -10, 10);
-
-      expect(array.length).toBe(5);
-      for (const value of array) {
-        expect(typeof value).toBe('number');
-        expect(value).toBeGreaterThanOrEqual(-10);
-        expect(value).toBeLessThanOrEqual(10);
-      }
-    });
-  });
-
-  describe('bytesToHex', () => {
-    test('converts Uint8Array to hex string', () => {
-      const bytes = new Uint8Array([10, 255, 0, 16]);
-      expect(bytesToHex(bytes)).toBe('0aff0010');
-    });
-
-    test('converts number array to hex string', () => {
-      const array = [171, 205, 3];
-      expect(bytesToHex(array)).toBe('abcd03');
-    });
-
-    test('handles empty array', () => {
-      expect(bytesToHex([])).toBe('');
-      expect(bytesToHex(new Uint8Array(0))).toBe('');
-    });
-
-    test('pads single-digit hex values with leading zero', () => {
-      const bytes = new Uint8Array([0, 1, 2, 3, 10, 15]);
-      expect(bytesToHex(bytes)).toBe('000102030a0f');
-    });
-  });
-});