qznt 1.0.0 → 1.0.2

package/README.md

@@ -37,6 +37,7 @@ const timeRemaining = $.date.duration(Date.now() + 5000); // "5 seconds"
 - **`qznt.date` (Time)**: Shorthand parsing (`"1h 30m"`), `duration` (digital/hms), and `eta`
 - **`qznt.fn` (Functions)**: `memoize` with TTL and custom resolvers
 - **`qznt.format` (Strings)**: `currency`, `memory` (bytes), `ordinal`, and `compactNumber`
+- **`$.fs` (File System)**: Efficient recursive directory scanning with `readDir`
 - **`qznt.is` (Predicates)**: Type guards: `is.today`, `is.empty`, `is.object`, and `is.sorted`
 - **`qznt.math` (Calculations)**: `lerp`, `invLerp`, `remap`, `percent`, and `sum`
 - **`qznt.num` (Numbers)**: Essential logic like `clamp` and range handling

package/dist/index.cjs

@@ -30,6 +30,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  $: () => $,
   Cache: () => Cache,
   Loop: () => Loop,
   Pipe: () => Pipe,
@@ -40,11 +41,10 @@ __export(index_exports, {
   default: () => index_default,
   fn: () => fn,
   format: () => format,
+  fs: () => fs,
   is: () => is,
   math: () => math,
-  num: () => num,
   obj: () => obj,
-  qznt: () => qznt,
   rnd: () => rnd,
   str: () => str2,
   timing: () => timing,
@@ -334,8 +334,16 @@ async function retry(fn2, retries = 3, delay = 500) {
     return await new Promise((resolve) => setTimeout(resolve, delay + jitter));
   }
 }
+function wait(ms2) {
+  return new Promise(
+    (resolve) => setTimeout(() => {
+      resolve(true);
+    }, ms2)
+  );
+}
 var async = {
-  retry
+  retry,
+  wait
 };
 
 // src/fn.ts
@@ -456,17 +464,17 @@ var format_exports = {};
 __export(format_exports, {
   format: () => format
 });
-function currency(num2, options = {}) {
+function currency(num, options = {}) {
   return new Intl.NumberFormat(options.locale, {
     style: "currency",
     currency: options.currency
-  }).format(num2);
+  }).format(num);
 }
-function number(num2, options = {}) {
+function number(num, options = {}) {
   return new Intl.NumberFormat(options.locale, {
     minimumFractionDigits: options.precision,
     maximumFractionDigits: options.precision
-  }).format(num2);
+  }).format(num);
 }
 function memory(bytes, decimals = 1, units = ["B", "KB", "MB", "GB", "TB", "PB", "EB", "ZB", "YB"]) {
   if (bytes <= 0) return `0 ${units[0]}`;
@@ -474,8 +482,8 @@ function memory(bytes, decimals = 1, units = ["B", "KB", "MB", "GB", "TB", "PB",
   const val = bytes / Math.pow(1024, i);
   return `${val.toFixed(i === 0 ? 0 : decimals)} ${units[i]}`;
 }
-function ordinal(num2, locale) {
-  const _num = Number(num2);
+function ordinal(num, locale) {
+  const _num = Number(num);
   if (isNaN(_num)) throw new TypeError("Invalid input");
   const pr = new Intl.PluralRules(locale, { type: "ordinal" });
   const rule = pr.select(_num);
@@ -488,12 +496,12 @@ function ordinal(num2, locale) {
   const suffix = suffixes[rule] || "th";
   return _num.toLocaleString(locale) + suffix;
 }
-function compactNumber(num2, locale) {
+function compactNumber(num, locale) {
   return new Intl.NumberFormat(locale, {
     notation: "compact",
     compactDisplay: "short",
     maximumFractionDigits: 1
-  }).format(num2);
+  }).format(num);
 }
 var format = {
   currency,
@@ -503,6 +511,41 @@ var format = {
   compactNumber
 };
 
+// src/fs.ts
+var fs_exports = {};
+__export(fs_exports, {
+  fs: () => fs
+});
+var import_node_fs = __toESM(require("fs"));
+var import_node_path = require("path");
+function readDir(path2, options = {}) {
+  const { recursive = true } = options;
+  if (!import_node_fs.default.existsSync(path2)) return [];
+  if (!recursive) {
+    return import_node_fs.default.readdirSync(path2).filter((fn2) => {
+      return import_node_fs.default.statSync((0, import_node_path.join)(path2, fn2)).isFile();
+    });
+  }
+  const walk = (dir, base = "") => {
+    const results = [];
+    const entries = import_node_fs.default.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      const relativePath = base ? (0, import_node_path.join)(base, entry.name) : entry.name;
+      const fullPath = (0, import_node_path.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, {
@@ -517,11 +560,11 @@ function empty(val) {
   if (object(val)) return Object.keys(val).length === 0;
   return false;
 }
-function inRange(num2, a, b) {
+function inRange(num, a, b) {
   let min = b !== void 0 ? a : 0;
   let max = b !== void 0 ? b : a;
   if (min > max) [min, max] = [max, min];
-  return num2 >= min && num2 <= max;
+  return num >= min && num <= max;
 }
 function object(val) {
   return val !== null && typeof val === "object" && !Array.isArray(val);
@@ -556,6 +599,12 @@ var math_exports = {};
 __export(math_exports, {
   math: () => math
 });
+function clamp(num, a, b) {
+  let min = b !== void 0 ? a : 0;
+  let max = b !== void 0 ? b : a;
+  if (min > max) [min, max] = [max, min];
+  return Math.max(min, Math.min(num, max));
+}
 function invLerp(start, end, value) {
   if (start === end) return 0;
   return (value - start) / (end - start);
@@ -563,8 +612,8 @@ function invLerp(start, end, value) {
 function lerp(start, end, t) {
   return start + (end - start) * t;
 }
-function ms(num2) {
-  return Math.floor(num2 * 1e3);
+function ms(num) {
+  return Math.floor(num * 1e3);
 }
 function percent(a, b, round = true) {
   const result = a / b * 100;
@@ -574,17 +623,20 @@ function remap(value, inMin, inMax, outMin, outMax) {
   const t = invLerp(inMin, inMax, value);
   return lerp(outMin, outMax, t);
 }
-function secs(num2) {
-  return Math.floor(num2 / 1e3);
+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);
 }
 var math = {
+  clamp,
   invLerp,
   lerp,
   ms,
@@ -594,21 +646,6 @@ var math = {
   sum
 };
 
-// src/num.ts
-var num_exports = {};
-__export(num_exports, {
-  num: () => num
-});
-function clamp(num2, a, b) {
-  let min = b !== void 0 ? a : 0;
-  let max = b !== void 0 ? b : a;
-  if (min > max) [min, max] = [max, min];
-  return Math.max(min, Math.min(num2, max));
-}
-var num = {
-  clamp
-};
-
 // src/obj.ts
 var obj_exports = {};
 __export(obj_exports, {
@@ -786,17 +823,9 @@ function throttle(fn2, limit) {
     }
   };
 }
-function wait(ms2) {
-  return new Promise(
-    (resolve) => setTimeout(() => {
-      resolve(true);
-    }, ms2)
-  );
-}
 var timing = {
   debounce,
-  throttle,
-  wait
+  throttle
 };
 
 // src/to.ts
@@ -830,16 +859,16 @@ function Pipe(value, ...fns) {
 }
 
 // src/Storage.ts
-var import_node_fs = __toESM(require("fs"));
-var import_node_path = __toESM(require("path"));
+var import_node_fs2 = __toESM(require("fs"));
+var import_node_path2 = __toESM(require("path"));
 var Storage = class {
   isNode = typeof window === "undefined";
   filePath = null;
   memoryCache = /* @__PURE__ */ new Map();
   loadFromFile() {
-    if (this.filePath && import_node_fs.default.existsSync(this.filePath)) {
+    if (this.filePath && import_node_fs2.default.existsSync(this.filePath)) {
       try {
-        const data = JSON.parse(import_node_fs.default.readFileSync(this.filePath, "utf-8"));
+        const data = JSON.parse(import_node_fs2.default.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);
@@ -850,7 +879,7 @@ var Storage = class {
     if (this.isNode && this.filePath) {
       const out = {};
       this.memoryCache.forEach((v, k) => out[k] = JSON.parse(v));
-      import_node_fs.default.writeFileSync(this.filePath, JSON.stringify(out, null, 2));
+      import_node_fs2.default.writeFileSync(this.filePath, JSON.stringify(out, null, 2));
     }
   }
   /**
@@ -861,7 +890,7 @@ var Storage = class {
    */
   constructor(fileName, directory = process.cwd()) {
     if (this.isNode && fileName) {
-      this.filePath = import_node_path.default.join(directory, fileName.endsWith(".json") ? fileName : `${fileName}.json`);
+      this.filePath = import_node_path2.default.join(directory, fileName.endsWith(".json") ? fileName : `${fileName}.json`);
       this.loadFromFile();
     }
   }
@@ -1062,15 +1091,15 @@ var Loop = class extends TypedEmitterBase {
 };
 
 // src/index.ts
-var $ = {
+var qznt = {
   ...arr_exports,
   ...async_exports,
   ...fn_exports,
   ...date_exports,
   ...format_exports,
+  ...fs_exports,
   ...is_exports,
   ...math_exports,
-  ...num_exports,
   ...obj_exports,
   ...timing_exports,
   ...rnd_exports,
@@ -1081,10 +1110,11 @@ var $ = {
   Cache,
   Loop
 };
-var qznt = $;
-var index_default = $;
+var $ = qznt;
+var index_default = qznt;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  $,
   Cache,
   Loop,
   Pipe,
@@ -1094,11 +1124,10 @@ var index_default = $;
   date,
   fn,
   format,
+  fs,
   is,
   math,
-  num,
   obj,
-  qznt,
   rnd,
   str,
   timing,