inray 0.0.6 → 0.0.8

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"}

package/dist/random/sample.d.ts

@@ -0,0 +1,58 @@
+/**
+ * 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 };
+/**
+ * Options for {@linkcode sample}.
+ *
+ * @experimental **UNSTABLE**: New API, yet to be vetted.
+ */
+export type SampleOptions = RandomOptions & {
+    /**
+     * An array of weights corresponding to each item in the input array.
+     * If supplied, this is used to determine the probability of each item being
+     * selected.
+     */
+    weights?: ArrayLike<number>;
+};
+/**
+ * Returns a random element from the given array.
+ *
+ * @experimental **UNSTABLE**: New API, yet to be vetted.
+ *
+ * @typeParam T The type of the elements in the array.
+ * @typeParam O The type of the accumulator.
+ *
+ * @param array The array to sample from.
+ * @param options Options modifying the sampling behavior.
+ *
+ * @returns A random element from the given array, or `undefined` if the array
+ * is empty.
+ *
+ * @example Basic usage
+ * ```ts
+ * import { sample } from "inray/random";
+ *
+ * const numbers = [1, 2, 3, 4];
+ * const sampled = sample(numbers); // numbers includes all sampled
+ *
+ * ```
+ *
+ * @example Using `weights` option
+ * ```ts
+ * import { sample } from "inray/random";
+ *
+ * const values = ["a", "b", "c"];
+ * const weights = [5, 3, 2];
+ * const result = sample(values, { weights });
+ * // gives "a" 50% of the time, "b" 30% of the time, and "c" 20% of the time
+ * ```
+ */
+export declare function sample<T>(array: ArrayLike<T>, options?: SampleOptions): T | undefined;
+//# sourceMappingURL=sample.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sample.d.ts","sourceRoot":"","sources":["../../src/random/sample.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;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG;IAC1C;;;;OAIG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;CAC7B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,CAAC,GAAG,SAAS,CAkCrF"}

package/dist/random/sample.js

@@ -0,0 +1,69 @@
+/**
+ * Original library: denoland/@std
+ * - Copyright (c) 2018-2026 the Deno authors. MIT license.
+ *
+ * Modified and integrated in "Inray":
+ * - Evgeniy Bushin
+ */
+/***/
+import { randomIntegerBetween } from "./integer_between.js";
+/**
+ * Returns a random element from the given array.
+ *
+ * @experimental **UNSTABLE**: New API, yet to be vetted.
+ *
+ * @typeParam T The type of the elements in the array.
+ * @typeParam O The type of the accumulator.
+ *
+ * @param array The array to sample from.
+ * @param options Options modifying the sampling behavior.
+ *
+ * @returns A random element from the given array, or `undefined` if the array
+ * is empty.
+ *
+ * @example Basic usage
+ * ```ts
+ * import { sample } from "inray/random";
+ *
+ * const numbers = [1, 2, 3, 4];
+ * const sampled = sample(numbers); // numbers includes all sampled
+ *
+ * ```
+ *
+ * @example Using `weights` option
+ * ```ts
+ * import { sample } from "inray/random";
+ *
+ * const values = ["a", "b", "c"];
+ * const weights = [5, 3, 2];
+ * const result = sample(values, { weights });
+ * // gives "a" 50% of the time, "b" 30% of the time, and "c" 20% of the time
+ * ```
+ */
+export function sample(array, options) {
+    const { weights } = { ...options };
+    if (weights) {
+        if (weights.length !== array.length) {
+            throw new RangeError('Cannot sample an item: The length of the weights array must match the length of the input array');
+        }
+        if (!array.length)
+            return undefined;
+        const total = Object.values(weights).reduce((sum, n) => sum + n, 0);
+        if (total <= 0) {
+            throw new RangeError('Cannot sample an item: Total weight must be greater than 0');
+        }
+        const rand = (options?.prng ?? Math.random)() * total;
+        let current = 0;
+        for (let i = 0; i < array.length; ++i) {
+            current += weights[i];
+            if (rand < current) {
+                return array[i];
+            }
+        }
+        // this line should never be hit, but in case of rounding errors etc.
+        return array[0];
+    }
+    const length = array.length;
+    return length ? array[randomIntegerBetween(0, length - 1, options)] : undefined;
+}
+//# sourceMappingURL=sample.js.map

package/dist/random/sample.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sample.js","sourceRoot":"","sources":["../../src/random/sample.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,KAAK;AAIL,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAiB5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,UAAU,MAAM,CAAI,KAAmB,EAAE,OAAuB;IACpE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;IAEnC,IAAI,OAAO,EAAE,CAAC;QACZ,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;YACpC,MAAM,IAAI,UAAU,CAClB,iGAAiG,CAClG,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QAEpC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QAEpE,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YACf,MAAM,IAAI,UAAU,CAAC,4DAA4D,CAAC,CAAC;QACrF,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,CAAC;QACtD,IAAI,OAAO,GAAG,CAAC,CAAC;QAEhB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;YACtC,OAAO,IAAI,OAAO,CAAC,CAAC,CAAE,CAAC;YACvB,IAAI,IAAI,GAAG,OAAO,EAAE,CAAC;gBACnB,OAAO,KAAK,CAAC,CAAC,CAAE,CAAC;YACnB,CAAC;QACH,CAAC;QAED,qEAAqE;QACrE,OAAO,KAAK,CAAC,CAAC,CAAE,CAAC;IACnB,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC5B,OAAO,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAClF,CAAC"}

package/dist/random/seeded.d.ts

@@ -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 type { Prng } from './_types.ts';
+export type { Prng } from './_types.ts';
+/**
+ * Creates a pseudo-random number generator that generates random numbers in
+ * the range `[0, 1)`, based on the given seed, with 32 bits of entropy.
+ * 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 number generator function, which will generate
+ * different random numbers on each call.
+ *
+ * @example Usage
+ * ```ts
+ * import { randomSeeded } from "inray/random";
+ *
+ * const prng = randomSeeded(1n);
+ *
+ * prng() // 0.20176767697557807
+ * prng() // 0.4911644416861236
+ * prng() // 0.7924694607499987
+ * ```
+ */
+export declare function randomSeeded(seed: bigint): Prng;
+//# sourceMappingURL=seeded.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"seeded.d.ts","sourceRoot":"","sources":["../../src/random/seeded.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,KAAK;AAIL,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAG/C"}

package/dist/random/seeded.js

@@ -0,0 +1,37 @@
+/**
+ * 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 number generator that generates random numbers in
+ * the range `[0, 1)`, based on the given seed, with 32 bits of entropy.
+ * 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 number generator function, which will generate
+ * different random numbers on each call.
+ *
+ * @example Usage
+ * ```ts
+ * import { randomSeeded } from "inray/random";
+ *
+ * const prng = randomSeeded(1n);
+ *
+ * prng() // 0.20176767697557807
+ * prng() // 0.4911644416861236
+ * prng() // 0.7924694607499987
+ * ```
+ */
+export function randomSeeded(seed) {
+    const pcg = new Pcg32(seed);
+    return () => pcg.nextUint32() / 2 ** 32;
+}
+//# sourceMappingURL=seeded.js.map

package/dist/random/seeded.js.map

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

package/dist/random/shuffle.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 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 };
+/**
+ * Shuffles the provided array, returning a copy and without modifying the original array.
+ *
+ * @experimental **UNSTABLE**: New API, yet to be vetted.
+ *
+ * @typeParam T The type of the items in the array
+ * @param items The items to shuffle
+ * @param options The options for the random number generator
+ * @returns A shuffled copy of the provided items
+ *
+ * @example Usage
+ * ```ts
+ * import { shuffle } from "inray/random";
+ *
+ * const items = [1, 2, 3, 4, 5];
+ *
+ * shuffle(items); // [2, 5, 1, 4, 3]
+ * shuffle(items); // [3, 4, 5, 1, 2]
+ * shuffle(items); // [5, 2, 4, 3, 1]
+ *
+ * items; // [1, 2, 3, 4, 5] (original array is unchanged)
+ * ```
+ */
+export declare function shuffle<T>(items: readonly T[], options?: RandomOptions): T[];
+//# sourceMappingURL=shuffle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shuffle.d.ts","sourceRoot":"","sources":["../../src/random/shuffle.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;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,CAAC,EAAE,CAiB5E"}

package/dist/random/shuffle.js

@@ -0,0 +1,48 @@
+/**
+ * Original library: denoland/@std
+ * - Copyright (c) 2018-2026 the Deno authors. MIT license.
+ *
+ * Modified and integrated in "Inray":
+ * - Evgeniy Bushin
+ */
+/***/
+/**
+ * Shuffles the provided array, returning a copy and without modifying the original array.
+ *
+ * @experimental **UNSTABLE**: New API, yet to be vetted.
+ *
+ * @typeParam T The type of the items in the array
+ * @param items The items to shuffle
+ * @param options The options for the random number generator
+ * @returns A shuffled copy of the provided items
+ *
+ * @example Usage
+ * ```ts
+ * import { shuffle } from "inray/random";
+ *
+ * const items = [1, 2, 3, 4, 5];
+ *
+ * shuffle(items); // [2, 5, 1, 4, 3]
+ * shuffle(items); // [3, 4, 5, 1, 2]
+ * shuffle(items); // [5, 2, 4, 3, 1]
+ *
+ * items; // [1, 2, 3, 4, 5] (original array is unchanged)
+ * ```
+ */
+export function shuffle(items, options) {
+    const result = [...items];
+    const prng = options?.prng ?? Math.random;
+    // https://en.wikipedia.org/wiki/Fisher–Yates_shuffle#The_modern_algorithm
+    // -- To shuffle an array a of n elements (indices 0..n-1):
+    // for i from n−1 down to 1 do
+    for (let i = result.length - 1; i >= 1; --i) {
+        // j ← random integer such that 0 ≤ j ≤ i
+        const j = Math.floor(prng() * (i + 1));
+        // exchange a[j] and a[i]
+        const temp = result[i];
+        result[i] = result[j];
+        result[j] = temp;
+    }
+    return result;
+}
+//# sourceMappingURL=shuffle.js.map

package/dist/random/shuffle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shuffle.js","sourceRoot":"","sources":["../../src/random/shuffle.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,KAAK;AAML;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,OAAO,CAAI,KAAmB,EAAE,OAAuB;IACrE,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IAC1B,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC;IAE1C,0EAA0E;IAC1E,2DAA2D;IAC3D,8BAA8B;IAC9B,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;QAC5C,yCAAyC;QACzC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACvC,yBAAyB;QACzB,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACvB,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;QACvB,MAAM,CAAC,CAAC,CAAC,GAAG,IAAK,CAAC;IACpB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/semver/_constants.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Original library: denoland/@std
+ * - Copyright (c) 2018-2026 the Deno authors. MIT license.
+ *
+ * Modified and integrated in "Inray":
+ * - Evgeniy Bushin
+ */
+/***/
+import type { Comparator, SemVer } from './types.ts';
+/**
+ * ANY is a sentinel value used by some range calculations. It is not a valid
+ * SemVer object and should not be used directly.
+ */
+export declare const ANY: SemVer;
+/**
+ * A comparator which will span all valid semantic versions
+ */
+export declare const ALL: Comparator;
+export declare const OPERATORS: readonly [undefined, "=", "!=", ">", ">=", "<", "<="];
+//# sourceMappingURL=_constants.d.ts.map

package/dist/semver/_constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_constants.d.ts","sourceRoot":"","sources":["../../src/semver/_constants.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,KAAK;AAEL,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAErD;;;GAGG;AACH,eAAO,MAAM,GAAG,EAAE,MAMjB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,GAAG,EAAE,UAGjB,CAAC;AAEF,eAAO,MAAM,SAAS,uDAAwD,CAAC"}