qznt 1.0.2 → 1.0.3

package/dist/index.d.mts

@@ -193,10 +193,22 @@ declare const fs: {
 };
 
 type AlphaCasing = "lower" | "upper" | "mixed";
+interface RndArrayOptions {
+    /** Optional seed for RNG. */
+    seed?: number;
+    /** Reroll if the result is equal to this value. */
+    not?: any;
+    /** Maximum number of times to reroll if `not` is specified. [default: 10] */
+    maxRerolls?: number;
+}
 interface RndStrOptions {
-    casing?: AlphaCasing;
+    /** Optional seed for RNG. */
     seed?: number;
+    /** Character casing mode. */
+    casing?: AlphaCasing;
+    /** Custom character pool. */
     customChars?: string;
+    /** Characters to exclude from the pool. */
     exclude?: string | string[];
 }
 /**
@@ -208,9 +220,9 @@ declare function chance(percent?: number, seed?: number): boolean;
 /**
  * Returns a random item from the given array.
  * @param array Array of items to choose from.
- * @param seed Optional seed for RNG.
+ * @param options Options for the choice function.
  */
-declare function choice<T>(array: T[], seed?: number): T;
+declare function choice<T>(array: T[], options?: RndArrayOptions): T;
 /**
  * Returns a random item from the given array based on their corresponding weights.
  * @param array Array of items to choose from.
@@ -250,9 +262,9 @@ declare function float(min: number, max: number, seed?: number): number;
 /**
  * Returns a random index from the given array.
  * @param array The array to generate an index for.
- * @param seed Optional seed for RNG.
+ * @param options Options for the index function.
  */
-declare function index(array: any[], seed?: number): number;
+declare function index(array: any[], options?: RndArrayOptions): number;
 /**
  * Generates a random integer between the given minimum and maximum values.
  * @param min The minimum value (inclusive) for the random integer.
@@ -732,14 +744,14 @@ declare const qznt: {
     };
     rnd: {
         chance: (percent?: number, seed?: number) => boolean;
-        choice: <T>(array: T[], seed?: number) => T;
+        choice: <T>(array: T[], options?: RndArrayOptions) => T;
         weighted: <T>(array: T[], selector: (item: T) => number, seed?: number) => T;
         sampler: <T>(items: T[], selector: (item: T) => number, seed?: number) => {
             pick: (seed?: number) => T | undefined;
         };
         prng: (seed: number) => () => number;
         float: (min: number, max: number, seed?: number) => number;
-        index: (array: any[], seed?: number) => number;
+        index: (array: any[], options?: RndArrayOptions) => number;
         int: (min: number, max: number, seed?: number) => number;
         str: (len: number, mode: "number" | "alpha" | "alphanumeric" | "custom", options?: RndStrOptions) => string;
     };
@@ -856,14 +868,14 @@ declare const $: {
     };
     rnd: {
         chance: (percent?: number, seed?: number) => boolean;
-        choice: <T>(array: T[], seed?: number) => T;
+        choice: <T>(array: T[], options?: RndArrayOptions) => T;
         weighted: <T>(array: T[], selector: (item: T) => number, seed?: number) => T;
         sampler: <T>(items: T[], selector: (item: T) => number, seed?: number) => {
             pick: (seed?: number) => T | undefined;
         };
         prng: (seed: number) => () => number;
         float: (min: number, max: number, seed?: number) => number;
-        index: (array: any[], seed?: number) => number;
+        index: (array: any[], options?: RndArrayOptions) => number;
         int: (min: number, max: number, seed?: number) => number;
         str: (len: number, mode: "number" | "alpha" | "alphanumeric" | "custom", options?: RndStrOptions) => string;
     };
@@ -962,4 +974,4 @@ declare const $: {
     };
 };
 
-export { $, type AlphaCasing, type AnyFunc, Cache, type DateOptions, type DebouncedFunction, type DeepPartial, Loop, type MemoizedFunction, type ParseOptions, Pipe, type ReadDirOptions, type RndStrOptions, type SequentialMapContext, Storage, type ToRecordContext, type TypedEmitter, arr, async, date, qznt as default, fn, format, fs, is, math, obj, rnd, str, timing, to };
+export { $, type AlphaCasing, type AnyFunc, Cache, type DateOptions, type DebouncedFunction, type DeepPartial, Loop, type MemoizedFunction, type ParseOptions, Pipe, type ReadDirOptions, type RndArrayOptions, type RndStrOptions, type SequentialMapContext, Storage, type ToRecordContext, type TypedEmitter, arr, async, date, qznt as default, fn, format, fs, is, math, obj, rnd, str, timing, to };

package/dist/index.d.ts

@@ -193,10 +193,22 @@ declare const fs: {
 };
 
 type AlphaCasing = "lower" | "upper" | "mixed";
+interface RndArrayOptions {
+    /** Optional seed for RNG. */
+    seed?: number;
+    /** Reroll if the result is equal to this value. */
+    not?: any;
+    /** Maximum number of times to reroll if `not` is specified. [default: 10] */
+    maxRerolls?: number;
+}
 interface RndStrOptions {
-    casing?: AlphaCasing;
+    /** Optional seed for RNG. */
     seed?: number;
+    /** Character casing mode. */
+    casing?: AlphaCasing;
+    /** Custom character pool. */
     customChars?: string;
+    /** Characters to exclude from the pool. */
     exclude?: string | string[];
 }
 /**
@@ -208,9 +220,9 @@ declare function chance(percent?: number, seed?: number): boolean;
 /**
  * Returns a random item from the given array.
  * @param array Array of items to choose from.
- * @param seed Optional seed for RNG.
+ * @param options Options for the choice function.
  */
-declare function choice<T>(array: T[], seed?: number): T;
+declare function choice<T>(array: T[], options?: RndArrayOptions): T;
 /**
  * Returns a random item from the given array based on their corresponding weights.
  * @param array Array of items to choose from.
@@ -250,9 +262,9 @@ declare function float(min: number, max: number, seed?: number): number;
 /**
  * Returns a random index from the given array.
  * @param array The array to generate an index for.
- * @param seed Optional seed for RNG.
+ * @param options Options for the index function.
  */
-declare function index(array: any[], seed?: number): number;
+declare function index(array: any[], options?: RndArrayOptions): number;
 /**
  * Generates a random integer between the given minimum and maximum values.
  * @param min The minimum value (inclusive) for the random integer.
@@ -732,14 +744,14 @@ declare const qznt: {
     };
     rnd: {
         chance: (percent?: number, seed?: number) => boolean;
-        choice: <T>(array: T[], seed?: number) => T;
+        choice: <T>(array: T[], options?: RndArrayOptions) => T;
         weighted: <T>(array: T[], selector: (item: T) => number, seed?: number) => T;
         sampler: <T>(items: T[], selector: (item: T) => number, seed?: number) => {
             pick: (seed?: number) => T | undefined;
         };
         prng: (seed: number) => () => number;
         float: (min: number, max: number, seed?: number) => number;
-        index: (array: any[], seed?: number) => number;
+        index: (array: any[], options?: RndArrayOptions) => number;
         int: (min: number, max: number, seed?: number) => number;
         str: (len: number, mode: "number" | "alpha" | "alphanumeric" | "custom", options?: RndStrOptions) => string;
     };
@@ -856,14 +868,14 @@ declare const $: {
     };
     rnd: {
         chance: (percent?: number, seed?: number) => boolean;
-        choice: <T>(array: T[], seed?: number) => T;
+        choice: <T>(array: T[], options?: RndArrayOptions) => T;
         weighted: <T>(array: T[], selector: (item: T) => number, seed?: number) => T;
         sampler: <T>(items: T[], selector: (item: T) => number, seed?: number) => {
             pick: (seed?: number) => T | undefined;
         };
         prng: (seed: number) => () => number;
         float: (min: number, max: number, seed?: number) => number;
-        index: (array: any[], seed?: number) => number;
+        index: (array: any[], options?: RndArrayOptions) => number;
         int: (min: number, max: number, seed?: number) => number;
         str: (len: number, mode: "number" | "alpha" | "alphanumeric" | "custom", options?: RndStrOptions) => string;
     };
@@ -962,4 +974,4 @@ declare const $: {
     };
 };
 
-export { $, type AlphaCasing, type AnyFunc, Cache, type DateOptions, type DebouncedFunction, type DeepPartial, Loop, type MemoizedFunction, type ParseOptions, Pipe, type ReadDirOptions, type RndStrOptions, type SequentialMapContext, Storage, type ToRecordContext, type TypedEmitter, arr, async, date, qznt as default, fn, format, fs, is, math, obj, rnd, str, timing, to };
+export { $, type AlphaCasing, type AnyFunc, Cache, type DateOptions, type DebouncedFunction, type DeepPartial, Loop, type MemoizedFunction, type ParseOptions, Pipe, type ReadDirOptions, type RndArrayOptions, type RndStrOptions, type SequentialMapContext, Storage, type ToRecordContext, type TypedEmitter, arr, async, date, qznt as default, fn, format, fs, is, math, obj, rnd, str, timing, to };

package/dist/index.js

@@ -24,9 +24,19 @@ function chance(percent2 = 0.5, seed) {
   const random = seed !== void 0 ? prng(seed) : Math.random;
   return random() < percent2;
 }
-function choice(array, seed) {
+function choice(array, options = {}) {
+  const { seed, not, maxRerolls = 10 } = options;
   const random = seed !== void 0 ? prng(seed) : Math.random;
-  return array[Math.floor(random() * array.length)];
+  const rnd2 = () => array[Math.floor(random() * array.length)];
+  let result = rnd2();
+  if (seed !== void 0 && array.length > 1) {
+    let rerolls = 0;
+    while (not !== void 0 && result === not && rerolls < maxRerolls) {
+      result = rnd2();
+      rerolls++;
+    }
+  }
+  return result;
 }
 function weighted(array, selector, seed) {
   const random = seed !== void 0 ? prng(seed) : Math.random;
@@ -38,9 +48,9 @@ function weighted(array, selector, seed) {
     cumulativeWeights.push(currentSum);
   }
   const decider = random() * currentSum;
-  let index2 = cumulativeWeights.findIndex((w) => w >= decider);
+  let index2;
   if (array.length < 20) {
-    cumulativeWeights.findIndex((w) => w >= decider);
+    index2 = cumulativeWeights.findIndex((w) => w >= decider);
   } else {
     let low = 0;
     let high = cumulativeWeights.length - 1;
@@ -101,9 +111,19 @@ function float(min, max, seed) {
   const random = seed !== void 0 ? prng(seed) : Math.random;
   return random() * (max - min) + min;
 }
-function index(array, seed) {
+function index(array, options = {}) {
+  const { seed, not, maxRerolls = 10 } = options;
   const random = seed !== void 0 ? prng(seed) : Math.random;
-  return Math.floor(random() * array.length);
+  const rnd2 = () => Math.floor(random() * array.length);
+  let result = rnd2();
+  if (seed !== void 0 && array.length > 1) {
+    let rerolls = 0;
+    while (not !== void 0 && result === not && rerolls < maxRerolls) {
+      result = rnd2();
+      rerolls++;
+    }
+  }
+  return result;
 }
 function int(min, max, seed) {
   const random = seed !== void 0 ? prng(seed) : Math.random;