inray 0.0.7 → 0.0.9

package/dist/random/_test_utils.js

@@ -0,0 +1,92 @@
+/**
+ * Original library: denoland/@std
+ * - Copyright (c) 2018-2026 the Deno authors. MIT license.
+ *
+ * Modified and integrated in "Inray":
+ * - Evgeniy Bushin
+ */
+/***/
+import { platform } from "./_platform.js";
+import { disposableStack } from "./internal/_testing.js";
+/**
+ * ```ts
+ * type _NumberType = { [K in keyof DataView]: K extends `get${infer T}` ? T : never }
+ * type NumberTypeName = _NumberType[keyof _NumberType]
+ * ```
+ */
+const numberTypes = [
+    'Int8',
+    'Int16',
+    'Int32',
+    'BigInt64',
+    'Uint8',
+    'Uint16',
+    'Uint32',
+    'BigUint64',
+    'Float16',
+    'Float32',
+    'Float64'
+];
+export function mockLittleEndian(littleEndian) {
+    // partial `DisposableStack` polyfill
+    const stack = disposableStack();
+    const originalLittleEndian = platform.littleEndian;
+    stack.defer(() => {
+        platform.littleEndian = originalLittleEndian;
+    });
+    for (const type of numberTypes) {
+        const TypedArray = globalThis[`${type}Array`];
+        const MockTypedArray = class extends TypedArray {
+            // @ts-ignore missing super() call
+            constructor(...args) {
+                const target = new TypedArray(...args);
+                const dv = new DataView(target.buffer, target.byteOffset, target.byteLength);
+                const proxy = new Proxy(target, {
+                    get(target, prop) {
+                        if (prop === Symbol.iterator) {
+                            return Array.prototype[Symbol.iterator];
+                        }
+                        if (typeof prop === 'symbol' || /\D/.test(prop)) {
+                            const val = Reflect.get(target, prop, target);
+                            if (typeof val === 'function') {
+                                return val.bind(target);
+                            }
+                            return val;
+                        }
+                        const i = Number(prop);
+                        return dv[`get${type}`](i * target.BYTES_PER_ELEMENT, littleEndian);
+                    },
+                    set(target, prop, val) {
+                        if (typeof prop === 'symbol' || /\D/.test(prop)) {
+                            return Reflect.set(target, prop, val, target);
+                        }
+                        const i = Number(prop);
+                        dv[`set${type}`](i * target.BYTES_PER_ELEMENT, val, littleEndian);
+                        return true;
+                    }
+                });
+                proxy[Symbol.for('nodejs.util.inspect.custom')] = (_, args, inspect) => {
+                    return `${littleEndian ? 'LE' : 'BE'}_${TypedArray.name}(${proxy.length}) ${inspect([...proxy], args)}`;
+                };
+                if (typeof args[0] === 'object' && (Symbol.iterator in args[0] || 'length' in args[0])) {
+                    for (let i = 0; i < target.length; ++i) {
+                        proxy[i] = target[i];
+                    }
+                }
+                return proxy;
+            }
+            static from(args) {
+                return new this(Array.from(args));
+            }
+        };
+        // @ts-ignore mock
+        globalThis[`${type}Array`] = MockTypedArray;
+        stack.defer(() => {
+            // @ts-ignore restore mock
+            globalThis[`${type}Array`] = TypedArray;
+        });
+    }
+    platform.littleEndian = littleEndian;
+    return stack;
+}
+//# sourceMappingURL=_test_utils.js.map

package/dist/random/_test_utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_test_utils.js","sourceRoot":"","sources":["../../src/random/_test_utils.ts"],"names":[],"mappings":"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"}

package/dist/random/_types.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Original library: denoland/@std
+ * - Copyright (c) 2018-2026 the Deno authors. MIT license.
+ *
+ * Modified and integrated in "Inray":
+ * - Evgeniy Bushin
+ */
+/***/
+/**
+ * Proxy type of {@code Uint8Array<ArrayBuffer>} or {@code Uint8Array} in TypeScript 5.7 or below respectively.
+ *
+ * This type is internal utility type and should not be used directly.
+ *
+ * @internal @private
+ */
+export type Uint8Array_ = ReturnType<Uint8Array['slice']>;
+/**
+ * A pseudo-random number generator implementing the same contract as
+ * `Math.random`, i.e. taking zero arguments and returning a random number in
+ * the range `[0, 1)`. The behavior of a function that accepts a `Prng` an
+ * option may be customized by passing a `Prng` with different behavior from
+ * `Math.random`, for example it may be seeded.
+ *
+ * @experimental **UNSTABLE**: New API, yet to be vetted.
+ */
+export type Prng = typeof Math.random;
+/** An integer typed array */
+export type IntegerTypedArray = ReturnType<Int8Array['slice']> | ReturnType<Int16Array['slice']> | ReturnType<Int32Array['slice']> | ReturnType<Uint8Array['slice']> | ReturnType<Uint16Array['slice']> | ReturnType<Uint32Array['slice']> | ReturnType<Uint8ClampedArray['slice']> | ReturnType<BigInt64Array['slice']> | ReturnType<BigUint64Array['slice']>;
+/**
+ * A pseudo-random number generator implementing the same contract as
+ * `crypto.getRandomValues`, i.e. taking a typed array and mutating it by
+ * filling it with random bytes, returning the mutated typed array instance.
+ *
+ * @experimental **UNSTABLE**: New API, yet to be vetted.
+ */
+export type RandomValueGenerator = <T extends IntegerTypedArray>(array: T) => T;
+/**
+ * Options for random number generation.
+ *
+ * @experimental **UNSTABLE**: New API, yet to be vetted.
+ */
+export type RandomOptions = {
+    /**
+     * A pseudo-random number generator returning a random number in the range
+     * `[0, 1)`, used for randomization.
+     * @default {Math.random}
+     */
+    prng?: Prng;
+};
+//# sourceMappingURL=_types.d.ts.map

package/dist/random/_types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_types.d.ts","sourceRoot":"","sources":["../../src/random/_types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,KAAK;AAIL;;;;;;GAMG;AAEH,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;AAE1D;;;;;;;;GAQG;AACH,MAAM,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,MAAM,CAAC;AAEtC,6BAA6B;AAC7B,MAAM,MAAM,iBAAiB,GACzB,UAAU,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,GAC9B,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,GAC/B,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,GAC/B,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,GAC/B,UAAU,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,GAChC,UAAU,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,GAChC,UAAU,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,GACtC,UAAU,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,GAClC,UAAU,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;AAExC;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,SAAS,iBAAiB,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC;AAEhF;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B;;;;OAIG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC;CACb,CAAC"}

package/dist/random/_types.js

@@ -0,0 +1,10 @@
+/**
+ * Original library: denoland/@std
+ * - Copyright (c) 2018-2026 the Deno authors. MIT license.
+ *
+ * Modified and integrated in "Inray":
+ * - Evgeniy Bushin
+ */
+/***/
+export {};
+//# sourceMappingURL=_types.js.map

package/dist/random/_types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_types.js","sourceRoot":"","sources":["../../src/random/_types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,KAAK"}

package/dist/random/between.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Original library: denoland/@std
+ * - Copyright (c) 2018-2026 the Deno authors. MIT license.
+ *
+ * Modified and integrated in "Inray":
+ * - Evgeniy Bushin
+ */
+/***/
+import type { Prng, RandomOptions } from './_types.ts';
+export type { Prng, RandomOptions };
+/**
+ * Generates a random number between the provided minimum and maximum values.
+ *
+ * The number is in the range `[min, max)`, i.e. `min` is included but `max` is excluded.
+ *
+ * @experimental **UNSTABLE**: New API, yet to be vetted.
+ *
+ * @param min The minimum value (inclusive)
+ * @param max The maximum value (exclusive)
+ * @param options The options for the random number generator
+ * @returns A random number between the provided minimum and maximum values
+ *
+ * @example Usage
+ * ```ts no-assert
+ * import { randomBetween } from "inray/random";
+ *
+ * randomBetween(1, 10); // 6.688009464410508
+ * randomBetween(1, 10); // 3.6267118101712006
+ * randomBetween(1, 10); // 7.853320239013774
+ * ```
+ */
+export declare function randomBetween(min: number, max: number, options?: RandomOptions): number;
+//# sourceMappingURL=between.d.ts.map

package/dist/random/between.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"between.d.ts","sourceRoot":"","sources":["../../src/random/between.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,KAAK;AAGL,OAAO,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACvD,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;AAEpC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM,CAgBvF"}

package/dist/random/between.js

@@ -0,0 +1,44 @@
+/**
+ * Original library: denoland/@std
+ * - Copyright (c) 2018-2026 the Deno authors. MIT license.
+ *
+ * Modified and integrated in "Inray":
+ * - Evgeniy Bushin
+ */
+/***/
+/**
+ * Generates a random number between the provided minimum and maximum values.
+ *
+ * The number is in the range `[min, max)`, i.e. `min` is included but `max` is excluded.
+ *
+ * @experimental **UNSTABLE**: New API, yet to be vetted.
+ *
+ * @param min The minimum value (inclusive)
+ * @param max The maximum value (exclusive)
+ * @param options The options for the random number generator
+ * @returns A random number between the provided minimum and maximum values
+ *
+ * @example Usage
+ * ```ts no-assert
+ * import { randomBetween } from "inray/random";
+ *
+ * randomBetween(1, 10); // 6.688009464410508
+ * randomBetween(1, 10); // 3.6267118101712006
+ * randomBetween(1, 10); // 7.853320239013774
+ * ```
+ */
+export function randomBetween(min, max, options) {
+    if (!Number.isFinite(min)) {
+        throw new RangeError(`Cannot generate a random number: min cannot be ${min}`);
+    }
+    if (!Number.isFinite(max)) {
+        throw new RangeError(`Cannot generate a random number: max cannot be ${max}`);
+    }
+    if (max < min) {
+        throw new RangeError(`Cannot generate a random number as max must be greater than or equal to min: max=${max}, min=${min}`);
+    }
+    const x = (options?.prng ?? Math.random)();
+    const y = min * (1 - x) + max * x;
+    return y >= min && y < max ? y : min;
+}
+//# sourceMappingURL=between.js.map

package/dist/random/between.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"between.js","sourceRoot":"","sources":["../../src/random/between.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,KAAK;AAML;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW,EAAE,GAAW,EAAE,OAAuB;IAC7E,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,UAAU,CAAC,kDAAkD,GAAG,EAAE,CAAC,CAAC;IAChF,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,UAAU,CAAC,kDAAkD,GAAG,EAAE,CAAC,CAAC;IAChF,CAAC;IACD,IAAI,GAAG,GAAG,GAAG,EAAE,CAAC;QACd,MAAM,IAAI,UAAU,CAClB,oFAAoF,GAAG,SAAS,GAAG,EAAE,CACtG,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;IAC3C,MAAM,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;IAClC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AACvC,CAAC"}

package/dist/random/get_random_values_seeded.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Original library: denoland/@std
+ * - Copyright (c) 2018-2026 the Deno authors. MIT license.
+ *
+ * Modified and integrated in "Inray":
+ * - Evgeniy Bushin
+ */
+/***/
+import type { RandomValueGenerator } from './_types.ts';
+export type { IntegerTypedArray, RandomValueGenerator } from './_types.ts';
+/**
+ * Creates a pseudo-random value generator that populates typed arrays,
+ * based on the given seed. The algorithm used for generation is
+ * {@link https://www.pcg-random.org/download.html | PCG32}.
+ *
+ * @experimental **UNSTABLE**: New API, yet to be vetted.
+ *
+ * @param seed The seed used to initialize the random number generator's state.
+ * @returns A pseudo-random value generator function, which will generate
+ * different values on each call.
+ *
+ * @example Usage
+ * ```ts
+ * import { getRandomValuesSeeded } from "inray/random";
+ *
+ * const getRandomValues = getRandomValuesSeeded(1n);
+ * getRandomValues(new Uint8Array(5)) // equal to new Uint8Array([230, 11, 167, 51, 238])
+ * ```
+ */
+export declare function getRandomValuesSeeded(seed: bigint): RandomValueGenerator;
+//# sourceMappingURL=get_random_values_seeded.d.ts.map

package/dist/random/get_random_values_seeded.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_random_values_seeded.d.ts","sourceRoot":"","sources":["../../src/random/get_random_values_seeded.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,KAAK;AAIL,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxD,YAAY,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAE3E;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,CAGxE"}

package/dist/random/get_random_values_seeded.js

@@ -0,0 +1,34 @@
+/**
+ * Original library: denoland/@std
+ * - Copyright (c) 2018-2026 the Deno authors. MIT license.
+ *
+ * Modified and integrated in "Inray":
+ * - Evgeniy Bushin
+ */
+/***/
+// This module is browser compatible.
+import { Pcg32 } from "./_pcg32.js";
+/**
+ * Creates a pseudo-random value generator that populates typed arrays,
+ * based on the given seed. The algorithm used for generation is
+ * {@link https://www.pcg-random.org/download.html | PCG32}.
+ *
+ * @experimental **UNSTABLE**: New API, yet to be vetted.
+ *
+ * @param seed The seed used to initialize the random number generator's state.
+ * @returns A pseudo-random value generator function, which will generate
+ * different values on each call.
+ *
+ * @example Usage
+ * ```ts
+ * import { getRandomValuesSeeded } from "inray/random";
+ *
+ * const getRandomValues = getRandomValuesSeeded(1n);
+ * getRandomValues(new Uint8Array(5)) // equal to new Uint8Array([230, 11, 167, 51, 238])
+ * ```
+ */
+export function getRandomValuesSeeded(seed) {
+    const pcg = new Pcg32(seed);
+    return pcg.getRandomValues.bind(pcg);
+}
+//# sourceMappingURL=get_random_values_seeded.js.map

package/dist/random/get_random_values_seeded.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_random_values_seeded.js","sourceRoot":"","sources":["../../src/random/get_random_values_seeded.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,KAAK;AAEL,qCAAqC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAIpC;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,OAAO,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACvC,CAAC"}

package/dist/random/integer_between.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Original library: denoland/@std
+ * - Copyright (c) 2018-2026 the Deno authors. MIT license.
+ *
+ * Modified and integrated in "Inray":
+ * - Evgeniy Bushin
+ */
+/***/
+import type { Prng, RandomOptions } from './_types.ts';
+export type { Prng, RandomOptions };
+/**
+ * Generates a random integer between the provided minimum and maximum values.
+ *
+ * The number is in the range `[min, max]`, i.e. both `min` and `max` are included.
+ *
+ * @experimental **UNSTABLE**: New API, yet to be vetted.
+ *
+ * @param min The minimum value (inclusive)
+ * @param max The maximum value (inclusive)
+ * @param options The options for the random number generator
+ * @returns A random integer between the provided minimum and maximum values
+ *
+ * @example Usage
+ * ```ts
+ * import { randomIntegerBetween } from "inray/random";
+ *
+ * randomIntegerBetween(1, 10); // 7
+ * randomIntegerBetween(1, 10); // 9
+ * randomIntegerBetween(1, 10); // 2
+ * ```
+ */
+export declare function randomIntegerBetween(min: number, max: number, options?: RandomOptions): number;
+//# sourceMappingURL=integer_between.d.ts.map

package/dist/random/integer_between.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integer_between.d.ts","sourceRoot":"","sources":["../../src/random/integer_between.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,KAAK;AAGL,OAAO,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEvD,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;AAEpC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM,CAE9F"}

package/dist/random/integer_between.js

@@ -0,0 +1,34 @@
+/**
+ * Original library: denoland/@std
+ * - Copyright (c) 2018-2026 the Deno authors. MIT license.
+ *
+ * Modified and integrated in "Inray":
+ * - Evgeniy Bushin
+ */
+/***/
+import { randomBetween } from "./between.js";
+/**
+ * Generates a random integer between the provided minimum and maximum values.
+ *
+ * The number is in the range `[min, max]`, i.e. both `min` and `max` are included.
+ *
+ * @experimental **UNSTABLE**: New API, yet to be vetted.
+ *
+ * @param min The minimum value (inclusive)
+ * @param max The maximum value (inclusive)
+ * @param options The options for the random number generator
+ * @returns A random integer between the provided minimum and maximum values
+ *
+ * @example Usage
+ * ```ts
+ * import { randomIntegerBetween } from "inray/random";
+ *
+ * randomIntegerBetween(1, 10); // 7
+ * randomIntegerBetween(1, 10); // 9
+ * randomIntegerBetween(1, 10); // 2
+ * ```
+ */
+export function randomIntegerBetween(min, max, options) {
+    return Math.floor(randomBetween(Math.ceil(min), Math.floor(max) + 1, options));
+}
+//# sourceMappingURL=integer_between.js.map

package/dist/random/integer_between.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integer_between.js","sourceRoot":"","sources":["../../src/random/integer_between.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,KAAK;AAIL,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG7C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAW,EAAE,GAAW,EAAE,OAAuB;IACpF,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;AACjF,CAAC"}

package/dist/random/internal/_testing.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Original library: denoland/@std
+ * - Copyright (c) 2018-2026 the Deno authors. MIT license.
+ *
+ * Modified and integrated in "Inray":
+ * - Evgeniy Bushin
+ */
+/***/
+export declare function disposableStack(): {
+    disposables: Disposable[];
+    defer(fn: () => void): void;
+    use(val: Disposable): void;
+    [Symbol.dispose](): void;
+};
+//# sourceMappingURL=_testing.d.ts.map

package/dist/random/internal/_testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_testing.d.ts","sourceRoot":"","sources":["../../../src/random/internal/_testing.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,KAAK;AAIL,wBAAgB,eAAe;iBAER,UAAU,EAAE;cACrB,MAAM,IAAI;aAGX,UAAU;;EAStB"}

package/dist/random/internal/_testing.js

@@ -0,0 +1,27 @@
+/**
+ * Original library: denoland/@std
+ * - Copyright (c) 2018-2026 the Deno authors. MIT license.
+ *
+ * Modified and integrated in "Inray":
+ * - Evgeniy Bushin
+ */
+/***/
+// partial `DisposableStack` polyfill
+// https://github.com/tc39/proposal-explicit-resource-management
+export function disposableStack() {
+    return {
+        disposables: [],
+        defer(fn) {
+            this.disposables.push({ [Symbol.dispose]: fn });
+        },
+        use(val) {
+            this.disposables.push(val);
+        },
+        [Symbol.dispose]() {
+            for (let i = this.disposables.length - 1; i >= 0; --i) {
+                this.disposables[i][Symbol.dispose]();
+            }
+        }
+    };
+}
+//# sourceMappingURL=_testing.js.map

package/dist/random/internal/_testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_testing.js","sourceRoot":"","sources":["../../../src/random/internal/_testing.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,KAAK;AAEL,qCAAqC;AACrC,gEAAgE;AAChE,MAAM,UAAU,eAAe;IAC7B,OAAO;QACL,WAAW,EAAE,EAAkB;QAC/B,KAAK,CAAC,EAAc;YAClB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAClD,CAAC;QACD,GAAG,CAAC,GAAe;YACjB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC;QACD,CAAC,MAAM,CAAC,OAAO,CAAC;YACd,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;gBACtD,IAAI,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YACzC,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/random/mod.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Original library: denoland/@std
+ * - Copyright (c) 2018-2026 the Deno authors. MIT license.
+ *
+ * Modified and integrated in "Inray":
+ * - Evgeniy Bushin
+ */
+/***/
+/**
+ * Utilities for generating random numbers.
+ *
+ * Example of generating a random integer with fixed seed number:
+ *
+ * ```ts
+ * import { randomIntegerBetween } from "inray/random";
+ * import { randomSeeded } from "inray/random";
+ *
+ * const prng = randomSeeded(1n);
+ *
+ * randomIntegerBetween(1, 10, { prng }) // 3
+ * ```
+ *
+ * Example of generating a random integer between two values:
+ *
+ * ```ts
+ * import { randomIntegerBetween } from "inray/random";
+ * import { randomSeeded } from "inray/random";
+ *
+ * const prng = randomSeeded(BigInt(crypto.getRandomValues(new Uint32Array(1))[0]!));
+ *
+ * const randomInteger = randomIntegerBetween(1, 10, { prng });
+ * ```
+ *
+ * @experimental **UNSTABLE**: New API, yet to be vetted.
+ *
+ * @module
+ */
+export * from './between.ts';
+export * from './integer_between.ts';
+export * from './get_random_values_seeded.ts';
+export * from './next_float_64.ts';
+export * from './sample.ts';
+export * from './seeded.ts';
+export * from './shuffle.ts';
+//# sourceMappingURL=mod.d.ts.map

package/dist/random/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/random/mod.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,KAAK;AAIL;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC"}

package/dist/random/mod.js

@@ -0,0 +1,46 @@
+/**
+ * Original library: denoland/@std
+ * - Copyright (c) 2018-2026 the Deno authors. MIT license.
+ *
+ * Modified and integrated in "Inray":
+ * - Evgeniy Bushin
+ */
+/***/
+// This module is browser compatible.
+/**
+ * Utilities for generating random numbers.
+ *
+ * Example of generating a random integer with fixed seed number:
+ *
+ * ```ts
+ * import { randomIntegerBetween } from "inray/random";
+ * import { randomSeeded } from "inray/random";
+ *
+ * const prng = randomSeeded(1n);
+ *
+ * randomIntegerBetween(1, 10, { prng }) // 3
+ * ```
+ *
+ * Example of generating a random integer between two values:
+ *
+ * ```ts
+ * import { randomIntegerBetween } from "inray/random";
+ * import { randomSeeded } from "inray/random";
+ *
+ * const prng = randomSeeded(BigInt(crypto.getRandomValues(new Uint32Array(1))[0]!));
+ *
+ * const randomInteger = randomIntegerBetween(1, 10, { prng });
+ * ```
+ *
+ * @experimental **UNSTABLE**: New API, yet to be vetted.
+ *
+ * @module
+ */
+export * from "./between.js";
+export * from "./integer_between.js";
+export * from "./get_random_values_seeded.js";
+export * from "./next_float_64.js";
+export * from "./sample.js";
+export * from "./seeded.js";
+export * from "./shuffle.js";
+//# sourceMappingURL=mod.js.map

package/dist/random/mod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../src/random/mod.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,KAAK;AAEL,qCAAqC;AAErC;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC"}

package/dist/random/next_float_64.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Original library: denoland/@std
+ * - Copyright (c) 2018-2026 the Deno authors. MIT license.
+ *
+ * Modified and integrated in "Inray":
+ * - Evgeniy Bushin
+ */
+/***/
+import type { RandomValueGenerator } from './_types.ts';
+/**
+ * Get a float64 in the range `[0, 1)` from a random value generator.
+ *
+ * @experimental **UNSTABLE**: New API, yet to be vetted.
+ *
+ * @param getRandomValues A function that fills a typed array with random values.
+ * @returns A float64 in the range `[0, 1)`.
+ *
+ * @example With a seeded value generator
+ * ```ts
+ * import { nextFloat64, getRandomValuesSeeded } from "inray/random";
+ *
+ * const getRandomValues = getRandomValuesSeeded(1n);
+ * nextFloat64(getRandomValues); // 0.49116444173310125
+ * nextFloat64(getRandomValues); // 0.06903754193160427
+ * nextFloat64(getRandomValues); // 0.16063206851777034
+ * ```
+ *
+ * @example With an arbitrary value generator
+ * ```ts
+ * import { nextFloat64 } from "inray/random";
+ *
+ * const val = nextFloat64(crypto.getRandomValues.bind(crypto)); // example: 0.8928746327842533
+ * // val >= 0
+ * // val < 1
+ * ```
+ */
+export declare function nextFloat64(getRandomValues: RandomValueGenerator): number;
+//# sourceMappingURL=next_float_64.d.ts.map

package/dist/random/next_float_64.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next_float_64.d.ts","sourceRoot":"","sources":["../../src/random/next_float_64.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,KAAK;AAGL,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AASxD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,WAAW,CAAC,eAAe,EAAE,oBAAoB,GAAG,MAAM,CAKzE"}

package/dist/random/next_float_64.js

@@ -0,0 +1,47 @@
+/**
+ * Original library: denoland/@std
+ * - Copyright (c) 2018-2026 the Deno authors. MIT license.
+ *
+ * Modified and integrated in "Inray":
+ * - Evgeniy Bushin
+ */
+/***/
+const b8 = new Uint8Array(8);
+const dv8 = new DataView(b8.buffer);
+// 0x1.0p-53
+const FLOAT_64_MULTIPLIER = 2 ** -53;
+// assert(1 / FLOAT_64_MULTIPLIER === Number.MAX_SAFE_INTEGER + 1)
+/**
+ * Get a float64 in the range `[0, 1)` from a random value generator.
+ *
+ * @experimental **UNSTABLE**: New API, yet to be vetted.
+ *
+ * @param getRandomValues A function that fills a typed array with random values.
+ * @returns A float64 in the range `[0, 1)`.
+ *
+ * @example With a seeded value generator
+ * ```ts
+ * import { nextFloat64, getRandomValuesSeeded } from "inray/random";
+ *
+ * const getRandomValues = getRandomValuesSeeded(1n);
+ * nextFloat64(getRandomValues); // 0.49116444173310125
+ * nextFloat64(getRandomValues); // 0.06903754193160427
+ * nextFloat64(getRandomValues); // 0.16063206851777034
+ * ```
+ *
+ * @example With an arbitrary value generator
+ * ```ts
+ * import { nextFloat64 } from "inray/random";
+ *
+ * const val = nextFloat64(crypto.getRandomValues.bind(crypto)); // example: 0.8928746327842533
+ * // val >= 0
+ * // val < 1
+ * ```
+ */
+export function nextFloat64(getRandomValues) {
+    getRandomValues(b8);
+    const int53 = Number(dv8.getBigUint64(0, true) >> 11n);
+    // assert(int53 <= Number.MAX_SAFE_INTEGER)
+    return int53 * FLOAT_64_MULTIPLIER;
+}
+//# sourceMappingURL=next_float_64.js.map

package/dist/random/next_float_64.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next_float_64.js","sourceRoot":"","sources":["../../src/random/next_float_64.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,KAAK;AAKL,MAAM,EAAE,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;AAC7B,MAAM,GAAG,GAAG,IAAI,QAAQ,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;AAEpC,YAAY;AACZ,MAAM,mBAAmB,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;AACrC,kEAAkE;AAElE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,WAAW,CAAC,eAAqC;IAC/D,eAAe,CAAC,EAAE,CAAC,CAAC;IACpB,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;IACvD,2CAA2C;IAC3C,OAAO,KAAK,GAAG,mBAAmB,CAAC;AACrC,CAAC"}