@xtia/alea-rc 0.0.5 → 0.0.7

package/README.md

@@ -7,7 +7,7 @@ Alea is a utility wrapper for turning random numbers into useful values. Give it
 * Fully typed
 * Crypto-safe and seeded algorithms out-of-the-box
 * No dependencies
-* ~2.3kb minified core
+* ~2.3kb minified core (1.04kb gzipped)
 * Ranged int, array shuffling, dice roll, weighted sampling, phrase generation, UUID, bytes and many more
 
 ## Brief:

package/{browser.js → entry/browser.js}

@@ -1,3 +1,3 @@
-import { createAleaFromByteSource } from "./internal/factories.js";
+import { createAleaFromByteSource } from "../internal/factories.js";
 export * from "./common.js";
 export const cryptoAlea = createAleaFromByteSource(arr => globalThis.crypto.getRandomValues(arr));

package/entry/common.d.ts

@@ -0,0 +1,5 @@
+import { Alea } from "../internal/alea.js";
+export type { Alea };
+export { createAleaFromByteSource, createAleaFromSeed, createAleaFromFunc, } from "../internal/factories.js";
+export { charsets } from "../internal/charsets.js";
+export { alea } from "../internal/mathalea.js";

package/entry/common.js

@@ -0,0 +1,3 @@
+export { createAleaFromByteSource, createAleaFromSeed, createAleaFromFunc, } from "../internal/factories.js";
+export { charsets } from "../internal/charsets.js";
+export { alea } from "../internal/mathalea.js";

package/{node.js → entry/node.js}

@@ -1,4 +1,4 @@
-import { createAleaFromByteSource } from "./internal/factories.js";
+import { createAleaFromByteSource } from "../internal/factories.js";
 import { randomBytes } from 'node:crypto';
 export * from "./common.js";
 export const cryptoAlea = createAleaFromByteSource(arr => {

package/{other.d.ts → entry/other.d.ts}

@@ -1,4 +1,4 @@
-import { Alea } from "./internal/alea.js";
+import { Alea } from "../internal/alea.js";
 export * from "./common.js";
 /**
  * An Alea instance that uses the runtime environment's `crypto` provider as a source

package/{other.js → entry/other.js}

@@ -1,4 +1,4 @@
-import { Alea } from "./internal/alea.js";
+import { Alea } from "../internal/alea.js";
 export * from "./common.js";
 /**
  * An Alea instance that uses the runtime environment's `crypto` provider as a source

package/internal/alea.d.ts

@@ -80,10 +80,16 @@ export declare class Alea {
     };
     /**
      * Generate a sequence of bytes
-     * @param count
+     * @param size Number of bytes to generate
      * @returns Random byte array
      */
-    bytes(count: number): Uint8Array<ArrayBuffer>;
+    bytes(size: number): Uint8Array;
+    /**
+     * Fill a byte buffer with random bytes
+     * @param buffer Any TypedArray or DataView
+     * @returns The same buffer, filled
+     */
+    bytes<T extends ArrayBufferView>(buffer: T): T;
     /**
      * Round a value up or down, according to probability defined by its non-integral part
      * @example

package/internal/alea.js

@@ -80,7 +80,7 @@ export class Alea {
         if (!charset || charset.length === 0)
             throw new RangeError("charset must not be empty");
         const chars = Array.from({ length }, () => charset[Math.floor(this.next() * charset.length)]);
-        return chars.join('');
+        return chars.join("");
     }
     /**
      * Generates a phrase from a table and a root string
@@ -98,17 +98,17 @@ export class Alea {
      * @returns Generated phrase
      */
     phrase(table, root) {
-        return root.replace(/\{([^}]+)\}/g, ((_, key) => {
+        return root.replace(/\{([^}]+)\}/g, (_, key) => {
             if (table[key] === undefined)
                 return `{${key}}`;
             if (typeof table[key] == "function") {
-                return table[key](template => this.phrase(table, template));
+                return table[key]((template) => this.phrase(table, template));
             }
             const source = table[key];
             if (typeof source == "string")
                 return this.phrase(table, source);
             return this.phrase(table, this.sample(source));
-        }));
+        });
     }
     /**
      * Create a factory to pick random items from a biased list
@@ -116,7 +116,7 @@ export class Alea {
      * @returns Random item factory
      */
     createWeightedSampler(table) {
-        const filtered = table.filter(v => Number.isFinite(v[1]) && v[1] > 0);
+        const filtered = table.filter((v) => Number.isFinite(v[1]) && v[1] > 0);
         if (filtered.length === 0) {
             throw new Error("Weighted source has no viable candidates");
         }
@@ -142,16 +142,27 @@ export class Alea {
             },
         };
     }
-    /**
-     * Generate a sequence of bytes
-     * @param count
-     * @returns Random byte array
-     */
-    bytes(count) {
-        const arr = new Uint8Array(count);
-        for (let i = 0; i < count; i++)
-            arr[i] = this.int(0, 255);
-        return arr;
+    bytes(sizeOrBuffer) {
+        let byteArray;
+        let result;
+        if (typeof sizeOrBuffer === "number") {
+            byteArray = new Uint8Array(sizeOrBuffer);
+            result = byteArray;
+        }
+        else {
+            byteArray = new Uint8Array(sizeOrBuffer.buffer, sizeOrBuffer.byteOffset, sizeOrBuffer.byteLength);
+            result = sizeOrBuffer;
+        }
+        const len = byteArray.length;
+        const words = Math.floor(len / 4);
+        const view = new DataView(byteArray.buffer, byteArray.byteOffset, byteArray.byteLength);
+        for (let i = 0; i < words; i++) {
+            view.setUint32(i * 4, this.int(0, 0xffffffff));
+        }
+        for (let i = words * 4; i < len; i++) {
+            byteArray[i] = this.int(0, 255);
+        }
+        return result;
     }
     /**
      * Round a value up or down, according to probability defined by its non-integral part
@@ -219,13 +230,13 @@ export class Alea {
         const bytes = this.bytes(16);
         bytes[6] = (bytes[6] & 0x0f) | 0x40;
         bytes[8] = (bytes[8] & 0x3f) | 0x80;
-        const hex = Array.from(bytes, byte => byte.toString(16).padStart(2, '0')).join('');
+        const hex = Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join("");
         return [
             hex.slice(0, 8),
             hex.slice(8, 12),
             hex.slice(12, 16),
             hex.slice(16, 20),
-            hex.slice(20, 32)
-        ].join('-');
+            hex.slice(20, 32),
+        ].join("-");
     }
 }

package/internal/mathalea.d.ts

@@ -0,0 +1,5 @@
+import { Alea } from "./alea.js";
+/**
+ * An Alea instance that uses Math.random() as a source
+ */
+export declare const alea: Alea;

package/internal/mathalea.js

@@ -0,0 +1,5 @@
+import { Alea } from "./alea.js";
+/**
+ * An Alea instance that uses Math.random() as a source
+ */
+export const alea = new Alea(Math.random);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xtia/alea-rc",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "description": "RNG utilities",
   "repository": {
     "url": "https://github.com/tiadrop/alea",
@@ -11,19 +11,20 @@
   "main": "./index.js",
   "exports": {
     ".": {
-      "types": "./other.d.ts",
-      "browser": "./browser.js",
-      "workerd": "./browser.js",
-      "deno": "./browser.js",
-      "node": "./node.js",
-      "bun": "./node.js",
-      "default": "./other.js"
+      "types": "./entry/other.d.ts",
+      "browser": "./entry/browser.js",
+      "workerd": "./entry/browser.js",
+      "deno": "./entry/browser.js",
+      "node": "./entry/node.js",
+      "bun": "./entry/node.js",
+      "default": "./entry/other.js"
     },
     "./prng": {
       "types": "./prng/index.d.ts",
       "default": "./prng/index.js"
     },
-    "./internal/*": null
+    "./internal/*": null,
+    "./entry/*": null
   },
   "scripts": {
     "prepublishOnly": "cp ../README.md .",

package/common.d.ts

@@ -1,8 +0,0 @@
-import { Alea } from "./internal/alea.js";
-export type { Alea };
-export { createAleaFromByteSource, createAleaFromSeed, createAleaFromFunc, } from "./internal/factories.js";
-export { charsets } from "./internal/charsets.js";
-/**
- * An Alea instance that uses Math.random() as a source
- */
-export declare const alea: Alea;

package/common.js

@@ -1,7 +0,0 @@
-import { Alea } from "./internal/alea.js";
-export { createAleaFromByteSource, createAleaFromSeed, createAleaFromFunc, } from "./internal/factories.js";
-export { charsets } from "./internal/charsets.js";
-/**
- * An Alea instance that uses Math.random() as a source
- */
-export const alea = new Alea(Math.random);