qznt 1.0.1 → 1.0.21

package/dist/index.d.mts

@@ -178,6 +178,20 @@ 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 RndStrOptions {
     casing?: AlphaCasing;
@@ -607,7 +621,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;
@@ -759,7 +773,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 +787,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;
@@ -880,7 +897,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 +911,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 +962,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 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

@@ -178,6 +178,20 @@ 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 RndStrOptions {
     casing?: AlphaCasing;
@@ -607,7 +621,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;
@@ -759,7 +773,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 +787,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;
@@ -880,7 +897,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 +911,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 +962,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 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

@@ -463,6 +463,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 +578,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 +811,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 +831,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 +1049,7 @@ var qznt = {
   ...fn_exports,
   ...date_exports,
   ...format_exports,
+  ...fs_exports,
   ...is_exports,
   ...math_exports,
   ...obj_exports,
@@ -1038,6 +1076,7 @@ export {
   index_default as default,
   fn,
   format,
+  fs,
   is,
   math,
   obj,