qznt 1.0.1 → 1.0.3

package/dist/index.d.ts

@@ -178,11 +178,37 @@ declare const date: {
     parse: typeof parse;
 };
 
+interface ReadDirOptions {
+    /** Whether to scan subdirectories. [default: true] */
+    recursive?: boolean;
+}
+/**
+ * Recursively (or shallowly) scans a directory and returns an array of relative file paths.
+ * @param path The path to the directory.
+ * @param options Options for the readDir function.
+ */
+declare function readDir(path: string, options?: ReadDirOptions): string[];
+declare const fs: {
+    readDir: typeof readDir;
+};
+
 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[];
 }
 /**
@@ -194,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.
@@ -236,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.
@@ -607,7 +633,7 @@ declare function secs(num: number): number;
  * @param selector Function that selects the item's weight.
  * @param ignoreNaN If true, NaN values will not throw an error.
  */
-declare function sum<T>(array: T[], selector: (item: T) => number, ignoreNaN?: boolean): number;
+declare function sum<T>(array: T[], selector?: (item: T) => number): number;
 declare const math: {
     clamp: typeof clamp;
     invLerp: typeof invLerp;
@@ -718,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;
     };
@@ -759,7 +785,7 @@ declare const qznt: {
         percent: (a: number, b: number, round?: boolean) => number;
         remap: (value: number, inMin: number, inMax: number, outMin: number, outMax: number) => number;
         secs: (num: number) => number;
-        sum: <T>(array: T[], selector: (item: T) => number, ignoreNaN?: boolean) => number;
+        sum: <T>(array: T[], selector?: (item: T) => number) => number;
     };
     is: {
         defined: <T>(val: T | undefined | null) => val is T;
@@ -773,6 +799,9 @@ declare const qznt: {
         string: (val: unknown) => val is string;
         today: (date: number | Date) => boolean;
     };
+    fs: {
+        readDir: (path: string, options?: ReadDirOptions) => string[];
+    };
     format: {
         currency: (num: number, options?: {
             currency?: string;
@@ -839,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;
     };
@@ -880,7 +909,7 @@ declare const $: {
         percent: (a: number, b: number, round?: boolean) => number;
         remap: (value: number, inMin: number, inMax: number, outMin: number, outMax: number) => number;
         secs: (num: number) => number;
-        sum: <T>(array: T[], selector: (item: T) => number, ignoreNaN?: boolean) => number;
+        sum: <T>(array: T[], selector?: (item: T) => number) => number;
     };
     is: {
         defined: <T>(val: T | undefined | null) => val is T;
@@ -894,6 +923,9 @@ declare const $: {
         string: (val: unknown) => val is string;
         today: (date: number | Date) => boolean;
     };
+    fs: {
+        readDir: (path: string, options?: ReadDirOptions) => string[];
+    };
     format: {
         currency: (num: number, options?: {
             currency?: string;
@@ -942,4 +974,4 @@ declare const $: {
     };
 };
 
-export { $, type AlphaCasing, type AnyFunc, Cache, type DateOptions, type DebouncedFunction, type DeepPartial, Loop, type MemoizedFunction, type ParseOptions, Pipe, type RndStrOptions, type SequentialMapContext, Storage, type ToRecordContext, type TypedEmitter, arr, async, date, qznt as default, fn, format, 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;
@@ -463,6 +483,41 @@ var format = {
   compactNumber
 };
 
+// src/fs.ts
+var fs_exports = {};
+__export(fs_exports, {
+  fs: () => fs
+});
+import _fs from "fs";
+import { join } from "path";
+function readDir(path2, options = {}) {
+  const { recursive = true } = options;
+  if (!_fs.existsSync(path2)) return [];
+  if (!recursive) {
+    return _fs.readdirSync(path2).filter((fn2) => {
+      return _fs.statSync(join(path2, fn2)).isFile();
+    });
+  }
+  const walk = (dir, base = "") => {
+    const results = [];
+    const entries = _fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      const relativePath = base ? join(base, entry.name) : entry.name;
+      const fullPath = join(dir, entry.name);
+      if (entry.isDirectory()) {
+        results.push(...walk(fullPath, relativePath));
+      } else if (entry.isFile()) {
+        results.push(relativePath);
+      }
+    }
+    return results;
+  };
+  return walk(path2);
+}
+var fs = {
+  readDir
+};
+
 // src/is.ts
 var is_exports = {};
 __export(is_exports, {
@@ -543,10 +598,12 @@ function remap(value, inMin, inMax, outMin, outMax) {
 function secs(num) {
   return Math.floor(num / 1e3);
 }
-function sum(array, selector, ignoreNaN) {
-  return array.map(selector).reduce((a, b) => {
-    const invalid = isNaN(b) && !ignoreNaN;
-    if (invalid) throw new TypeError(`sum: '${b}' is not a valid number.`);
+function sum(array, selector) {
+  const _array = selector ? array.map(selector) : array;
+  if (!_array.every((v) => typeof v === "number")) {
+    throw new TypeError(`sum: Array must only contain numbers.`);
+  }
+  return _array.reduce((a, b) => {
     return (isNaN(b) ? 0 : b) < 0 ? a - -b : a + (b || 0);
   }, 0);
 }
@@ -774,16 +831,16 @@ function Pipe(value, ...fns) {
 }
 
 // src/Storage.ts
-import fs from "fs";
+import fs2 from "fs";
 import path from "path";
 var Storage = class {
   isNode = typeof window === "undefined";
   filePath = null;
   memoryCache = /* @__PURE__ */ new Map();
   loadFromFile() {
-    if (this.filePath && fs.existsSync(this.filePath)) {
+    if (this.filePath && fs2.existsSync(this.filePath)) {
       try {
-        const data = JSON.parse(fs.readFileSync(this.filePath, "utf-8"));
+        const data = JSON.parse(fs2.readFileSync(this.filePath, "utf-8"));
         Object.entries(data).forEach(([k, v]) => this.memoryCache.set(k, JSON.stringify(v)));
       } catch (err) {
         console.error(`Store: Failed to load file '${this.filePath}'`, err);
@@ -794,7 +851,7 @@ var Storage = class {
     if (this.isNode && this.filePath) {
       const out = {};
       this.memoryCache.forEach((v, k) => out[k] = JSON.parse(v));
-      fs.writeFileSync(this.filePath, JSON.stringify(out, null, 2));
+      fs2.writeFileSync(this.filePath, JSON.stringify(out, null, 2));
     }
   }
   /**
@@ -1012,6 +1069,7 @@ var qznt = {
   ...fn_exports,
   ...date_exports,
   ...format_exports,
+  ...fs_exports,
   ...is_exports,
   ...math_exports,
   ...obj_exports,
@@ -1038,6 +1096,7 @@ export {
   index_default as default,
   fn,
   format,
+  fs,
   is,
   math,
   obj,