@wavy/fn 0.0.6 → 0.0.8

package/dist/main.cjs

@@ -87,7 +87,6 @@ __export(main_exports, {
   takeWhile: () => takeWhile,
   timeDuration: () => timeDuration,
   toNumber: () => toNumber,
-  toObject: () => toObject,
   trimString: () => trimString,
   undefinedIfEmpty: () => undefinedIfEmpty,
   upperFirst: () => upperFirst,
@@ -95,6 +94,187 @@ __export(main_exports, {
 });
 module.exports = __toCommonJS(main_exports);
 
+// src/helper-functions/HelperFunctions.ts
+var import_types2 = require("@wavy/types");
+
+// src/helper-functions/components/formatter/number/NumberFormatter.ts
+var NumberFormatter = class _NumberFormatter {
+  static format(value, format2, options) {
+    switch (format2) {
+      case "money":
+        return _NumberFormatter.toMoney(value, options);
+      default:
+        return value.toLocaleString("en-us");
+    }
+  }
+  static toMoney(amount, options) {
+    const dollarSign = options?.excludeDollarSign ? "" : "$";
+    if (!amount) return dollarSign + (options?.dropDecimals ? "0" : "0.00");
+    if (options?.truncate) {
+      const strAmt = takeWhile(
+        `${amount}`.split(""),
+        (char) => char !== "."
+      ).join("");
+      const fmtMoney = (value, decimal) => {
+        const getTruncatedSuffix = () => {
+          if (strAmt.length <= 3) return "";
+          if (range(4, 7).includes(strAmt.length)) return "k";
+          if (range(7, 10).includes(strAmt.length)) return "m";
+          if (range(10, 13).includes(strAmt.length)) return "b";
+          if (range(13, 16).includes(strAmt.length)) return "t";
+        };
+        const fmtValue = parseInt(decimal) > 0 ? `${value}.${decimal}` : value;
+        return dollarSign + fmtValue + getTruncatedSuffix();
+      };
+      if (strAmt.length <= 3) return fmtMoney(strAmt, "0");
+      else {
+        const relevantDigits = takeLast(
+          windowed([...strAmt.split("")].reverse(), 3).map(
+            (arr) => arr.reverse()
+          ),
+          2
+        ).reverse();
+        return fmtMoney(relevantDigits[0].join(""), relevantDigits[1][0]);
+      }
+    }
+    return (amount < 0 ? "-" : options?.showSigns ? "+" : "") + dollarSign + amount.toLocaleString("en-US", {
+      minimumFractionDigits: options?.dropDecimals ? 0 : 2,
+      currency: "USD",
+      currencyDisplay: "symbol",
+      currencySign: "accounting",
+      signDisplay: "never"
+    });
+  }
+};
+var NumberFormatter_default = NumberFormatter;
+
+// src/helper-functions/components/formatter/object/ObjectFormatter.ts
+var ObjectFormatter = class {
+  static toString = {
+    name: (name) => name ? `${name.first} ${name.last}`.trim() : "no_name",
+    phoneNumber: (phoneNumber) => {
+      if (!phoneNumber) return "no_phone_number";
+      return `${phoneNumber.countryCode} (${phoneNumber.areaCode}) ${insertAt(
+        phoneNumber.localNumber.split(""),
+        3,
+        "-"
+      ).join("")}`;
+    },
+    address: (address, inline) => {
+      if (address === void 0) return "no_address";
+      const addressKeys = Object.keys(address).map((k) => k);
+      const delimiter = (isLast) => !isLast ? "," + (!inline ? "\n" : "") : "";
+      return addressKeys.map(
+        (key, idx) => address[key] + delimiter(idx === lastIndex(addressKeys))
+      ).join("") || "no_address";
+    }
+  };
+};
+var ObjectFormatter_default = ObjectFormatter;
+
+// src/helper-functions/components/input/InputManager.ts
+var InputManager = class {
+  static manualValidators = {
+    percent: (value) => StringFormatter_default.toNumber(value) <= 100 && run(value.split(".")?.[1], (dec) => dec ? dec.length <= 2 : true)
+  };
+  static formatters = {
+    money: {
+      format: (value) => take(
+        value.split(".").map(
+          (sect, idx) => idx === 0 ? `${NumberFormatter_default.format(StringFormatter_default.toNumber(sect))}` : take(sect.split(""), 2).join("")
+        ),
+        2
+      ).join("."),
+      unformat: (value) => `${StringFormatter_default.toNumber(value)}`
+    }
+  };
+  static separateNumbersFormatter(options = {
+    numbersPerGroup: 3,
+    separator: "-"
+  }) {
+    return {
+      format: (value) => {
+        let groupedValues = windowed(
+          value.split(""),
+          options.numbersPerGroup
+        ).map((v) => v.join(""));
+        if (options.groupCount) {
+          groupedValues = [
+            ...take(groupedValues, options.groupCount),
+            drop(groupedValues, options.groupCount).join("").replace(options.separator, "")
+          ].filter((v) => !isEmpty(v));
+        }
+        return groupedValues.join(options.separator);
+      },
+      unformat: (value) => {
+        const unformatted = value.replaceAll(options.separator, "");
+        return unformatted;
+      }
+    };
+  }
+};
+var InputManager_default = InputManager;
+
+// src/helper-functions/components/formatter/string/StringFormatter.ts
+var VOWELS = "aeiouy";
+var StringFormatter = class _StringFormatter {
+  static vowels = VOWELS;
+  static caseConverter = {
+    camelToLetter: (camelCase) => {
+      return camelCase.split("").map(
+        (char, charIdx) => charIdx === 0 ? char.toUpperCase() : char === char.toUpperCase() && char !== char.toLowerCase() ? ` ${char}` : char
+      ).join("");
+    }
+  };
+  static extract = {
+    capitalLetters: (value, count2) => {
+      return value.split("", count2).filter(
+        (char) => char === char.toUpperCase() && char !== char.toLowerCase()
+      );
+    }
+  };
+  static trimString(value, trim) {
+    let newValue = value;
+    while (newValue.endsWith(trim)) {
+      newValue = value.split("").reverse().join("").replace(trim, "").split("").reverse().join("");
+    }
+    return newValue;
+  }
+  static pluralize(value) {
+    return value[value.length - 1] === "s" ? value + "es" : value + "s";
+  }
+  static addArticle(value, article) {
+    let fmtArticle = "";
+    switch (article) {
+      case "a/an":
+        fmtArticle = VOWELS.includes(value?.[0].toLowerCase()) ? "An" : "A";
+        break;
+      default:
+        return article;
+    }
+    return `${fmtArticle.toLowerCase()} ${value}`;
+  }
+  static toSearch(from) {
+    return from.split("").filter((char) => char !== " ").join("").toLowerCase().trim();
+  }
+  static toMoney(from, options) {
+    return NumberFormatter_default.toMoney(_StringFormatter.toNumber(from), options);
+  }
+  static toTRN(from) {
+    return InputManager_default.separateNumbersFormatter().format(from);
+  }
+  static toNumber(value) {
+    const potentialNumber = take(value.split("."), 2).join(".").split("").map(
+      (char, idx) => idx === 0 && char === "-" ? char : "0123456789.".includes(char) ? char : ""
+    ).join("");
+    return isEmpty(potentialNumber.trim()) ? 0 : parseFloat(potentialNumber);
+  }
+  static upperFirst(value) {
+    return value.split("").map((char, idx) => idx === 0 ? char.toUpperCase() : char).join("");
+  }
+};
+var StringFormatter_default = StringFormatter;
+
 // src/helper-functions/components/time/TimeManager.ts
 var TimeManager = class _TimeManager {
   constructor(locale = "en-jm") {
@@ -267,188 +447,61 @@ var TimeManager = class _TimeManager {
 };
 var TimeManager_default = TimeManager;
 
-// src/helper-functions/components/formatter/number/NumberFormatter.ts
-var NumberFormatter = class _NumberFormatter {
-  static format(value, format2, options) {
-    switch (format2) {
-      case "money":
-        return _NumberFormatter.toMoney(value, options);
-      default:
-        return value.toLocaleString("en-us");
-    }
-  }
-  static toMoney(amount, options) {
-    const dollarSign = options?.excludeDollarSign ? "" : "$";
-    if (!amount) return dollarSign + (options?.dropDecimals ? "0" : "0.00");
-    if (options?.truncate) {
-      const strAmt = takeWhile(
-        `${amount}`.split(""),
-        (char) => char !== "."
-      ).join("");
-      const fmtMoney = (value, decimal) => {
-        const getTruncatedSuffix = () => {
-          if (strAmt.length <= 3) return "";
-          if (range(4, 7).includes(strAmt.length)) return "k";
-          if (range(7, 10).includes(strAmt.length)) return "m";
-          if (range(10, 13).includes(strAmt.length)) return "b";
-          if (range(13, 16).includes(strAmt.length)) return "t";
-        };
-        const fmtValue = parseInt(decimal) > 0 ? `${value}.${decimal}` : value;
-        return dollarSign + fmtValue + getTruncatedSuffix();
-      };
-      if (strAmt.length <= 3) return fmtMoney(strAmt, "0");
-      else {
-        const relevantDigits = takeLast(
-          windowed([...strAmt.split("")].reverse(), 3).map(
-            (arr) => arr.reverse()
-          ),
-          2
-        ).reverse();
-        return fmtMoney(relevantDigits[0].join(""), relevantDigits[1][0]);
-      }
-    }
-    return (amount < 0 ? "-" : options?.showSigns ? "+" : "") + dollarSign + amount.toLocaleString("en-US", {
-      minimumFractionDigits: options?.dropDecimals ? 0 : 2,
-      currency: "USD",
-      currencyDisplay: "symbol",
-      currencySign: "accounting",
-      signDisplay: "never"
-    });
-  }
-};
-var NumberFormatter_default = NumberFormatter;
-
-// src/helper-functions/components/input/InputManager.ts
-var InputManager = class {
-  static manualValidators = {
-    percent: (value) => StringFormatter_default.toNumber(value) <= 100 && run(value.split(".")?.[1], (dec) => dec ? dec.length <= 2 : true)
-  };
-  static formatters = {
-    money: {
-      format: (value) => take(
-        value.split(".").map(
-          (sect, idx) => idx === 0 ? `${NumberFormatter_default.format(StringFormatter_default.toNumber(sect))}` : take(sect.split(""), 2).join("")
-        ),
-        2
-      ).join("."),
-      unformat: (value) => `${StringFormatter_default.toNumber(value)}`
-    }
-  };
-  static separateNumbersFormatter(options = {
-    numbersPerGroup: 3,
-    separator: "-"
-  }) {
-    return {
-      format: (value) => {
-        let groupedValues = windowed(
-          value.split(""),
-          options.numbersPerGroup
-        ).map((v) => v.join(""));
-        if (options.groupCount) {
-          groupedValues = [
-            ...take(groupedValues, options.groupCount),
-            drop(groupedValues, options.groupCount).join("").replace(options.separator, "")
-          ].filter((v) => !isEmpty(v));
+// src/helper-functions/components/ObjectConverter.ts
+var import_uuid = require("uuid");
+var import_types = require("@wavy/types");
+var import_console = require("console");
+function fileToLocalFile(file, options) {
+  const fileName = (() => {
+    const fileExt = getFileExt(file.name);
+    if (options?.filename && options.filename.includes(fileExt))
+      return options.filename;
+    else if (options?.filename) return options.filename.trim() + fileExt;
+    return file.name;
+  })()?.trim?.();
+  const { name: _, size: __, ..._metadata } = file;
+  return {
+    uid: (0, import_uuid.v4)(),
+    description: options?.description,
+    path: options?.filepath || file?.webkitRelativePath,
+    typeAlias: options?.typeAlias || run(
+      Object.keys(import_types.LOCAL_FILE_MIME_TYPES).find(
+        (key) => import_types.LOCAL_FILE_MIME_TYPES[key].includes(file.type)
+      ),
+      (type) => {
+        if (!type) {
+          (0, import_console.log)("An unknown file type was found ", file.type);
+          return "unknown";
         }
-        return groupedValues.join(options.separator);
-      },
-      unformat: (value) => {
-        const unformatted = value.replaceAll(options.separator, "");
-        return unformatted;
+        return type;
       }
-    };
-  }
-};
-var InputManager_default = InputManager;
-
-// src/helper-functions/components/formatter/string/StringFormatter.ts
-var VOWELS = "aeiouy";
-var StringFormatter = class _StringFormatter {
-  static vowels = VOWELS;
-  static caseConverter = {
-    camelToLetter: (camelCase) => {
-      return camelCase.split("").map(
-        (char, charIdx) => charIdx === 0 ? char.toUpperCase() : char === char.toUpperCase() && char !== char.toLowerCase() ? ` ${char}` : char
-      ).join("");
-    }
+    ),
+    sizeInBytes: file.size,
+    uploadDate: options?.uploadDate === "now" ? Date.now() : options?.uploadDate ?? file?.lastModified,
+    name: fileName,
+    _metadata
   };
-  static extract = {
-    capitalLetters: (value, count2) => {
-      return value.split("", count2).filter(
-        (char) => char === char.toUpperCase() && char !== char.toLowerCase()
-      );
-    }
+}
+function localFileToFile(localFile) {
+  return {
+    name: localFile.name,
+    size: localFile.sizeInBytes,
+    ...localFile._metadata
   };
-  static trimString(value, trim) {
-    let newValue = value;
-    while (newValue.endsWith(trim)) {
-      newValue = value.split("").reverse().join("").replace(trim, "").split("").reverse().join("");
-    }
-    return newValue;
-  }
-  static pluralize(value) {
-    return value[value.length - 1] === "s" ? value + "es" : value + "s";
-  }
-  static addArticle(value, article) {
-    let fmtArticle = "";
-    switch (article) {
-      case "a/an":
-        fmtArticle = VOWELS.includes(value?.[0].toLowerCase()) ? "An" : "A";
-        break;
-      default:
-        return article;
+}
+var Overloader = class {
+  invoke(...args) {
+    if (isFile(args[0])) {
+      return fileToLocalFile(...args);
     }
-    return `${fmtArticle.toLowerCase()} ${value}`;
-  }
-  static toSearch(from) {
-    return from.split("").filter((char) => char !== " ").join("").toLowerCase().trim();
-  }
-  static toMoney(from, options) {
-    return NumberFormatter_default.toMoney(_StringFormatter.toNumber(from), options);
-  }
-  static toTRN(from) {
-    return InputManager_default.separateNumbersFormatter().format(from);
-  }
-  static toNumber(value) {
-    const potentialNumber = take(value.split("."), 2).join(".").split("").map(
-      (char, idx) => idx === 0 && char === "-" ? char : "0123456789.".includes(char) ? char : ""
-    ).join("");
-    return isEmpty(potentialNumber.trim()) ? 0 : parseFloat(potentialNumber);
-  }
-  static upperFirst(value) {
-    return value.split("").map((char, idx) => idx === 0 ? char.toUpperCase() : char).join("");
+    if (isLocalFile(args[0])) {
+      return localFileToFile(...args);
+    } else throw new Error(`The arguments supplied are insufficient.`);
   }
 };
-var StringFormatter_default = StringFormatter;
-
-// src/helper-functions/components/formatter/object/ObjectFormatter.ts
-var ObjectFormatter = class {
-  static toString = {
-    name: (name) => name ? `${name.first} ${name.last}`.trim() : "no_name",
-    phoneNumber: (phoneNumber) => {
-      if (!phoneNumber) return "no_phone_number";
-      return `${phoneNumber.countryCode} (${phoneNumber.areaCode}) ${insertAt(
-        phoneNumber.localNumber.split(""),
-        3,
-        "-"
-      ).join("")}`;
-    },
-    address: (address, inline) => {
-      if (address === void 0) return "no_address";
-      const addressKeys = Object.keys(address).map((k) => k);
-      const delimiter = (isLast) => !isLast ? "," + (!inline ? "\n" : "") : "";
-      return addressKeys.map(
-        (key, idx) => address[key] + delimiter(idx === lastIndex(addressKeys))
-      ).join("") || "no_address";
-    }
-  };
-};
-var ObjectFormatter_default = ObjectFormatter;
+var toObject = new Overloader().invoke;
 
 // src/helper-functions/HelperFunctions.ts
-var import_uuid = require("uuid");
-var import_types = require("@wavy/types");
-var import_console = require("console");
 var dateFormat = new TimeManager_default().format;
 var timeDuration = new TimeManager_default().getDuration;
 var upperFirst = StringFormatter_default.upperFirst;
@@ -506,7 +559,7 @@ function isLocalFile(value) {
     uploadDate: 0,
     _metadata: void 0
   };
-  const optionalKeys = ["description", "_metadata"];
+  const optionalKeys = ["description"];
   const requiredKeys = Object.keys(dummyLocalFile).filter((key) => !optionalKeys.includes(key));
   const allKeys = [requiredKeys, optionalKeys].flat();
   if (value && typeof value === "object" && requiredKeys.every((key) => key in value) && Object.keys(value).every((key) => allKeys.includes(key))) {
@@ -514,68 +567,8 @@ function isLocalFile(value) {
   }
   return false;
 }
-var toObject = new class T {
-  fileToLocalFile(file, options) {
-    const fileName = (() => {
-      const fileExt = getFileExt(file.name);
-      if (options?.filename && options.filename.includes(fileExt))
-        return options.filename;
-      else if (options?.filename) return options.filename.trim() + fileExt;
-      return file.name;
-    })()?.trim?.();
-    const { name: _, size: __, ..._metadata } = file;
-    return {
-      uid: (0, import_uuid.v4)(),
-      description: options?.description,
-      path: options?.filepath || file.webkitRelativePath,
-      typeAlias: options?.typeAlias || run(
-        Object.keys(import_types.LOCAL_FILE_MIME_TYPES).find(
-          (key) => import_types.LOCAL_FILE_MIME_TYPES[key].includes(file.type)
-        ),
-        (type) => {
-          if (!type) {
-            (0, import_console.log)("An unknown file type was found ", file.type);
-            return "unknown";
-          }
-          return type;
-        }
-      ),
-      sizeInBytes: file.size,
-      uploadDate: options?.uploadDate === "now" ? Date.now() : options?.uploadDate ?? file.lastModified,
-      name: fileName,
-      _metadata
-    };
-  }
-  localFileToFile(localFile) {
-    if ("_metadata" in localFile) {
-      return {
-        name: localFile.name,
-        size: localFile.sizeInBytes,
-        ...localFile._metadata
-      };
-    }
-    return {
-      name: localFile.name,
-      size: localFile.sizeInBytes,
-      webkitRelativePath: localFile.path,
-      lastModified: localFile.uploadDate
-    };
-  }
-  invoke(...args) {
-    if (isFile(args[0])) {
-      return this.fileToLocalFile(
-        ...args
-      );
-    }
-    if (isLocalFile(args[0])) {
-      return this.localFileToFile(
-        ...args
-      );
-    } else throw new Error(`The arguments supplied are insufficient.`);
-  }
-}().invoke;
 function getMimeTypes(typeAliases) {
-  return distinct(strictArray(typeAliases)).map((alias) => import_types.LOCAL_FILE_MIME_TYPES[alias]).flat();
+  return distinct(strictArray(typeAliases)).map((alias) => import_types2.LOCAL_FILE_MIME_TYPES[alias]).flat();
 }
 function classNameResolver(baseClassName) {
   return (className) => {
@@ -845,7 +838,7 @@ function getFileExt(filePath) {
 async function copyToClipboard(text) {
   try {
     await navigator.clipboard.writeText(text);
-    return { data: "success" };
+    return { response: "success" };
   } catch (err) {
     console.error("Failed to copy text: ", err);
     if (err instanceof Error) {
@@ -869,7 +862,7 @@ async function copyToClipboard(text) {
 async function readClipboardText() {
   try {
     const text = await navigator.clipboard.readText();
-    return { data: { text: text.trim() } };
+    return { response: { text: text.trim() } };
   } catch (err) {
     console.error("Failed to read clipboard contents: ", err);
     return {
@@ -888,7 +881,7 @@ function arrayWithConst(array) {
 }
 
 // src/server-adapters/ServerAdapters.ts
-var import_types2 = require("@wavy/types");
+var import_types3 = require("@wavy/types");
 var iiKeys = Object.keys({
   name: null,
   address: null,
@@ -1143,7 +1136,6 @@ var serverDataAdapter = new ServerDataAdapter().invoke;
   takeWhile,
   timeDuration,
   toNumber,
-  toObject,
   trimString,
   undefinedIfEmpty,
   upperFirst,

package/dist/main.d.cts

@@ -51,16 +51,6 @@ declare const toMoney: (value: string | number, options?: NumberFormatterTypes["
 declare function format<Event extends "date" | "money" | "name" | "phone-number" | "address">(event: Event, ...args: Event extends "date" ? Parameters<typeof dateFormat> : Event extends "money" ? Parameters<typeof toMoney> : Event extends "name" ? Parameters<typeof nameToString> : Event extends "phone-number" ? Parameters<typeof phoneNoToString> : Event extends "address" ? Parameters<typeof addressToString> : never): Event extends "date" ? ReturnType<typeof dateFormat> : Event extends "money" ? ReturnType<typeof toMoney> : Event extends "name" ? ReturnType<typeof nameToString> : Event extends "phone-number" ? ReturnType<typeof phoneNoToString> : Event extends "address" ? ReturnType<typeof addressToString> : never;
 declare function isFile(value: unknown): value is File;
 declare function isLocalFile(value: unknown): value is LocalFile;
-declare const toObject: {
-    (file: File, options?: Partial<{
-        uploadDate: number | "now";
-        description: string;
-        filepath: string;
-        filename: string;
-        typeAlias: LocalFile["typeAlias"];
-    }> | undefined): LocalFile;
-    (localFile: LocalFile | SanitizeLocalType<LocalFile>): File;
-};
 declare function getMimeTypes(typeAliases: KnownFileTypeAlias[]): string[];
 declare function classNameResolver(baseClassName: string): (className: string) => string;
 declare function classNameExt(rootClassName: string): (className: string) => string;
@@ -177,4 +167,4 @@ declare const serverDataAdapter: {
     }>(event: "unzip", data: DataType): NormalizeFromServer<DataType>;
 };
 
-export { addArticle, arrayWithConst, asyncRun, averageOf, blankSpaces, buildArray, camelCaseToLetter, classNameExt, classNameResolver, coerceIn, copyToClipboard, count, dataSearcher, distinct, drop, dropLast, dropLastWhile, dropWhile, format, formatGCTRegNo, formatInvoiceNo, getCaps, getFileExt, getMimeTypes, group, hasIndex, ifDefined, ifEmpty, inRange, indexOf, indices, inferFilename, insertAt, isEmpty, isFile, isLetter, isLocalFile, isNumber, lastIndex, map, mapToArray, maxOf, minOf, negate, ordinalIndicator, overwrite, pluralize, poll, random, range, readClipboardText, removeAll, repeat, run, serverDataAdapter, someValuesEmpty, sort, strictArray, stringToSearch, subObjectList, sumOf, take, takeLast, takeLastWhile, takeWhile, timeDuration, toNumber, toObject, trimString, undefinedIfEmpty, upperFirst, windowed };
+export { addArticle, arrayWithConst, asyncRun, averageOf, blankSpaces, buildArray, camelCaseToLetter, classNameExt, classNameResolver, coerceIn, copyToClipboard, count, dataSearcher, distinct, drop, dropLast, dropLastWhile, dropWhile, format, formatGCTRegNo, formatInvoiceNo, getCaps, getFileExt, getMimeTypes, group, hasIndex, ifDefined, ifEmpty, inRange, indexOf, indices, inferFilename, insertAt, isEmpty, isFile, isLetter, isLocalFile, isNumber, lastIndex, map, mapToArray, maxOf, minOf, negate, ordinalIndicator, overwrite, pluralize, poll, random, range, readClipboardText, removeAll, repeat, run, serverDataAdapter, someValuesEmpty, sort, strictArray, stringToSearch, subObjectList, sumOf, take, takeLast, takeLastWhile, takeWhile, timeDuration, toNumber, trimString, undefinedIfEmpty, upperFirst, windowed };

package/dist/main.d.ts

@@ -51,16 +51,6 @@ declare const toMoney: (value: string | number, options?: NumberFormatterTypes["
 declare function format<Event extends "date" | "money" | "name" | "phone-number" | "address">(event: Event, ...args: Event extends "date" ? Parameters<typeof dateFormat> : Event extends "money" ? Parameters<typeof toMoney> : Event extends "name" ? Parameters<typeof nameToString> : Event extends "phone-number" ? Parameters<typeof phoneNoToString> : Event extends "address" ? Parameters<typeof addressToString> : never): Event extends "date" ? ReturnType<typeof dateFormat> : Event extends "money" ? ReturnType<typeof toMoney> : Event extends "name" ? ReturnType<typeof nameToString> : Event extends "phone-number" ? ReturnType<typeof phoneNoToString> : Event extends "address" ? ReturnType<typeof addressToString> : never;
 declare function isFile(value: unknown): value is File;
 declare function isLocalFile(value: unknown): value is LocalFile;
-declare const toObject: {
-    (file: File, options?: Partial<{
-        uploadDate: number | "now";
-        description: string;
-        filepath: string;
-        filename: string;
-        typeAlias: LocalFile["typeAlias"];
-    }> | undefined): LocalFile;
-    (localFile: LocalFile | SanitizeLocalType<LocalFile>): File;
-};
 declare function getMimeTypes(typeAliases: KnownFileTypeAlias[]): string[];
 declare function classNameResolver(baseClassName: string): (className: string) => string;
 declare function classNameExt(rootClassName: string): (className: string) => string;
@@ -177,4 +167,4 @@ declare const serverDataAdapter: {
     }>(event: "unzip", data: DataType): NormalizeFromServer<DataType>;
 };
 
-export { addArticle, arrayWithConst, asyncRun, averageOf, blankSpaces, buildArray, camelCaseToLetter, classNameExt, classNameResolver, coerceIn, copyToClipboard, count, dataSearcher, distinct, drop, dropLast, dropLastWhile, dropWhile, format, formatGCTRegNo, formatInvoiceNo, getCaps, getFileExt, getMimeTypes, group, hasIndex, ifDefined, ifEmpty, inRange, indexOf, indices, inferFilename, insertAt, isEmpty, isFile, isLetter, isLocalFile, isNumber, lastIndex, map, mapToArray, maxOf, minOf, negate, ordinalIndicator, overwrite, pluralize, poll, random, range, readClipboardText, removeAll, repeat, run, serverDataAdapter, someValuesEmpty, sort, strictArray, stringToSearch, subObjectList, sumOf, take, takeLast, takeLastWhile, takeWhile, timeDuration, toNumber, toObject, trimString, undefinedIfEmpty, upperFirst, windowed };
+export { addArticle, arrayWithConst, asyncRun, averageOf, blankSpaces, buildArray, camelCaseToLetter, classNameExt, classNameResolver, coerceIn, copyToClipboard, count, dataSearcher, distinct, drop, dropLast, dropLastWhile, dropWhile, format, formatGCTRegNo, formatInvoiceNo, getCaps, getFileExt, getMimeTypes, group, hasIndex, ifDefined, ifEmpty, inRange, indexOf, indices, inferFilename, insertAt, isEmpty, isFile, isLetter, isLocalFile, isNumber, lastIndex, map, mapToArray, maxOf, minOf, negate, ordinalIndicator, overwrite, pluralize, poll, random, range, readClipboardText, removeAll, repeat, run, serverDataAdapter, someValuesEmpty, sort, strictArray, stringToSearch, subObjectList, sumOf, take, takeLast, takeLastWhile, takeWhile, timeDuration, toNumber, trimString, undefinedIfEmpty, upperFirst, windowed };

package/dist/main.js

@@ -1,3 +1,184 @@
+// src/helper-functions/HelperFunctions.ts
+import { LOCAL_FILE_MIME_TYPES as LOCAL_FILE_MIME_TYPES2 } from "@wavy/types";
+
+// src/helper-functions/components/formatter/number/NumberFormatter.ts
+var NumberFormatter = class _NumberFormatter {
+  static format(value, format2, options) {
+    switch (format2) {
+      case "money":
+        return _NumberFormatter.toMoney(value, options);
+      default:
+        return value.toLocaleString("en-us");
+    }
+  }
+  static toMoney(amount, options) {
+    const dollarSign = options?.excludeDollarSign ? "" : "$";
+    if (!amount) return dollarSign + (options?.dropDecimals ? "0" : "0.00");
+    if (options?.truncate) {
+      const strAmt = takeWhile(
+        `${amount}`.split(""),
+        (char) => char !== "."
+      ).join("");
+      const fmtMoney = (value, decimal) => {
+        const getTruncatedSuffix = () => {
+          if (strAmt.length <= 3) return "";
+          if (range(4, 7).includes(strAmt.length)) return "k";
+          if (range(7, 10).includes(strAmt.length)) return "m";
+          if (range(10, 13).includes(strAmt.length)) return "b";
+          if (range(13, 16).includes(strAmt.length)) return "t";
+        };
+        const fmtValue = parseInt(decimal) > 0 ? `${value}.${decimal}` : value;
+        return dollarSign + fmtValue + getTruncatedSuffix();
+      };
+      if (strAmt.length <= 3) return fmtMoney(strAmt, "0");
+      else {
+        const relevantDigits = takeLast(
+          windowed([...strAmt.split("")].reverse(), 3).map(
+            (arr) => arr.reverse()
+          ),
+          2
+        ).reverse();
+        return fmtMoney(relevantDigits[0].join(""), relevantDigits[1][0]);
+      }
+    }
+    return (amount < 0 ? "-" : options?.showSigns ? "+" : "") + dollarSign + amount.toLocaleString("en-US", {
+      minimumFractionDigits: options?.dropDecimals ? 0 : 2,
+      currency: "USD",
+      currencyDisplay: "symbol",
+      currencySign: "accounting",
+      signDisplay: "never"
+    });
+  }
+};
+var NumberFormatter_default = NumberFormatter;
+
+// src/helper-functions/components/formatter/object/ObjectFormatter.ts
+var ObjectFormatter = class {
+  static toString = {
+    name: (name) => name ? `${name.first} ${name.last}`.trim() : "no_name",
+    phoneNumber: (phoneNumber) => {
+      if (!phoneNumber) return "no_phone_number";
+      return `${phoneNumber.countryCode} (${phoneNumber.areaCode}) ${insertAt(
+        phoneNumber.localNumber.split(""),
+        3,
+        "-"
+      ).join("")}`;
+    },
+    address: (address, inline) => {
+      if (address === void 0) return "no_address";
+      const addressKeys = Object.keys(address).map((k) => k);
+      const delimiter = (isLast) => !isLast ? "," + (!inline ? "\n" : "") : "";
+      return addressKeys.map(
+        (key, idx) => address[key] + delimiter(idx === lastIndex(addressKeys))
+      ).join("") || "no_address";
+    }
+  };
+};
+var ObjectFormatter_default = ObjectFormatter;
+
+// src/helper-functions/components/input/InputManager.ts
+var InputManager = class {
+  static manualValidators = {
+    percent: (value) => StringFormatter_default.toNumber(value) <= 100 && run(value.split(".")?.[1], (dec) => dec ? dec.length <= 2 : true)
+  };
+  static formatters = {
+    money: {
+      format: (value) => take(
+        value.split(".").map(
+          (sect, idx) => idx === 0 ? `${NumberFormatter_default.format(StringFormatter_default.toNumber(sect))}` : take(sect.split(""), 2).join("")
+        ),
+        2
+      ).join("."),
+      unformat: (value) => `${StringFormatter_default.toNumber(value)}`
+    }
+  };
+  static separateNumbersFormatter(options = {
+    numbersPerGroup: 3,
+    separator: "-"
+  }) {
+    return {
+      format: (value) => {
+        let groupedValues = windowed(
+          value.split(""),
+          options.numbersPerGroup
+        ).map((v) => v.join(""));
+        if (options.groupCount) {
+          groupedValues = [
+            ...take(groupedValues, options.groupCount),
+            drop(groupedValues, options.groupCount).join("").replace(options.separator, "")
+          ].filter((v) => !isEmpty(v));
+        }
+        return groupedValues.join(options.separator);
+      },
+      unformat: (value) => {
+        const unformatted = value.replaceAll(options.separator, "");
+        return unformatted;
+      }
+    };
+  }
+};
+var InputManager_default = InputManager;
+
+// src/helper-functions/components/formatter/string/StringFormatter.ts
+var VOWELS = "aeiouy";
+var StringFormatter = class _StringFormatter {
+  static vowels = VOWELS;
+  static caseConverter = {
+    camelToLetter: (camelCase) => {
+      return camelCase.split("").map(
+        (char, charIdx) => charIdx === 0 ? char.toUpperCase() : char === char.toUpperCase() && char !== char.toLowerCase() ? ` ${char}` : char
+      ).join("");
+    }
+  };
+  static extract = {
+    capitalLetters: (value, count2) => {
+      return value.split("", count2).filter(
+        (char) => char === char.toUpperCase() && char !== char.toLowerCase()
+      );
+    }
+  };
+  static trimString(value, trim) {
+    let newValue = value;
+    while (newValue.endsWith(trim)) {
+      newValue = value.split("").reverse().join("").replace(trim, "").split("").reverse().join("");
+    }
+    return newValue;
+  }
+  static pluralize(value) {
+    return value[value.length - 1] === "s" ? value + "es" : value + "s";
+  }
+  static addArticle(value, article) {
+    let fmtArticle = "";
+    switch (article) {
+      case "a/an":
+        fmtArticle = VOWELS.includes(value?.[0].toLowerCase()) ? "An" : "A";
+        break;
+      default:
+        return article;
+    }
+    return `${fmtArticle.toLowerCase()} ${value}`;
+  }
+  static toSearch(from) {
+    return from.split("").filter((char) => char !== " ").join("").toLowerCase().trim();
+  }
+  static toMoney(from, options) {
+    return NumberFormatter_default.toMoney(_StringFormatter.toNumber(from), options);
+  }
+  static toTRN(from) {
+    return InputManager_default.separateNumbersFormatter().format(from);
+  }
+  static toNumber(value) {
+    const potentialNumber = take(value.split("."), 2).join(".").split("").map(
+      (char, idx) => idx === 0 && char === "-" ? char : "0123456789.".includes(char) ? char : ""
+    ).join("");
+    return isEmpty(potentialNumber.trim()) ? 0 : parseFloat(potentialNumber);
+  }
+  static upperFirst(value) {
+    return value.split("").map((char, idx) => idx === 0 ? char.toUpperCase() : char).join("");
+  }
+};
+var StringFormatter_default = StringFormatter;
+
 // src/helper-functions/components/time/TimeManager.ts
 var TimeManager = class _TimeManager {
   constructor(locale = "en-jm") {
@@ -170,188 +351,61 @@ var TimeManager = class _TimeManager {
 };
 var TimeManager_default = TimeManager;
 
-// src/helper-functions/components/formatter/number/NumberFormatter.ts
-var NumberFormatter = class _NumberFormatter {
-  static format(value, format2, options) {
-    switch (format2) {
-      case "money":
-        return _NumberFormatter.toMoney(value, options);
-      default:
-        return value.toLocaleString("en-us");
-    }
-  }
-  static toMoney(amount, options) {
-    const dollarSign = options?.excludeDollarSign ? "" : "$";
-    if (!amount) return dollarSign + (options?.dropDecimals ? "0" : "0.00");
-    if (options?.truncate) {
-      const strAmt = takeWhile(
-        `${amount}`.split(""),
-        (char) => char !== "."
-      ).join("");
-      const fmtMoney = (value, decimal) => {
-        const getTruncatedSuffix = () => {
-          if (strAmt.length <= 3) return "";
-          if (range(4, 7).includes(strAmt.length)) return "k";
-          if (range(7, 10).includes(strAmt.length)) return "m";
-          if (range(10, 13).includes(strAmt.length)) return "b";
-          if (range(13, 16).includes(strAmt.length)) return "t";
-        };
-        const fmtValue = parseInt(decimal) > 0 ? `${value}.${decimal}` : value;
-        return dollarSign + fmtValue + getTruncatedSuffix();
-      };
-      if (strAmt.length <= 3) return fmtMoney(strAmt, "0");
-      else {
-        const relevantDigits = takeLast(
-          windowed([...strAmt.split("")].reverse(), 3).map(
-            (arr) => arr.reverse()
-          ),
-          2
-        ).reverse();
-        return fmtMoney(relevantDigits[0].join(""), relevantDigits[1][0]);
-      }
-    }
-    return (amount < 0 ? "-" : options?.showSigns ? "+" : "") + dollarSign + amount.toLocaleString("en-US", {
-      minimumFractionDigits: options?.dropDecimals ? 0 : 2,
-      currency: "USD",
-      currencyDisplay: "symbol",
-      currencySign: "accounting",
-      signDisplay: "never"
-    });
-  }
-};
-var NumberFormatter_default = NumberFormatter;
-
-// src/helper-functions/components/input/InputManager.ts
-var InputManager = class {
-  static manualValidators = {
-    percent: (value) => StringFormatter_default.toNumber(value) <= 100 && run(value.split(".")?.[1], (dec) => dec ? dec.length <= 2 : true)
-  };
-  static formatters = {
-    money: {
-      format: (value) => take(
-        value.split(".").map(
-          (sect, idx) => idx === 0 ? `${NumberFormatter_default.format(StringFormatter_default.toNumber(sect))}` : take(sect.split(""), 2).join("")
-        ),
-        2
-      ).join("."),
-      unformat: (value) => `${StringFormatter_default.toNumber(value)}`
-    }
-  };
-  static separateNumbersFormatter(options = {
-    numbersPerGroup: 3,
-    separator: "-"
-  }) {
-    return {
-      format: (value) => {
-        let groupedValues = windowed(
-          value.split(""),
-          options.numbersPerGroup
-        ).map((v) => v.join(""));
-        if (options.groupCount) {
-          groupedValues = [
-            ...take(groupedValues, options.groupCount),
-            drop(groupedValues, options.groupCount).join("").replace(options.separator, "")
-          ].filter((v) => !isEmpty(v));
+// src/helper-functions/components/ObjectConverter.ts
+import { v4 } from "uuid";
+import { LOCAL_FILE_MIME_TYPES } from "@wavy/types";
+import { log } from "console";
+function fileToLocalFile(file, options) {
+  const fileName = (() => {
+    const fileExt = getFileExt(file.name);
+    if (options?.filename && options.filename.includes(fileExt))
+      return options.filename;
+    else if (options?.filename) return options.filename.trim() + fileExt;
+    return file.name;
+  })()?.trim?.();
+  const { name: _, size: __, ..._metadata } = file;
+  return {
+    uid: v4(),
+    description: options?.description,
+    path: options?.filepath || file?.webkitRelativePath,
+    typeAlias: options?.typeAlias || run(
+      Object.keys(LOCAL_FILE_MIME_TYPES).find(
+        (key) => LOCAL_FILE_MIME_TYPES[key].includes(file.type)
+      ),
+      (type) => {
+        if (!type) {
+          log("An unknown file type was found ", file.type);
+          return "unknown";
         }
-        return groupedValues.join(options.separator);
-      },
-      unformat: (value) => {
-        const unformatted = value.replaceAll(options.separator, "");
-        return unformatted;
+        return type;
       }
-    };
-  }
-};
-var InputManager_default = InputManager;
-
-// src/helper-functions/components/formatter/string/StringFormatter.ts
-var VOWELS = "aeiouy";
-var StringFormatter = class _StringFormatter {
-  static vowels = VOWELS;
-  static caseConverter = {
-    camelToLetter: (camelCase) => {
-      return camelCase.split("").map(
-        (char, charIdx) => charIdx === 0 ? char.toUpperCase() : char === char.toUpperCase() && char !== char.toLowerCase() ? ` ${char}` : char
-      ).join("");
-    }
+    ),
+    sizeInBytes: file.size,
+    uploadDate: options?.uploadDate === "now" ? Date.now() : options?.uploadDate ?? file?.lastModified,
+    name: fileName,
+    _metadata
   };
-  static extract = {
-    capitalLetters: (value, count2) => {
-      return value.split("", count2).filter(
-        (char) => char === char.toUpperCase() && char !== char.toLowerCase()
-      );
-    }
+}
+function localFileToFile(localFile) {
+  return {
+    name: localFile.name,
+    size: localFile.sizeInBytes,
+    ...localFile._metadata
   };
-  static trimString(value, trim) {
-    let newValue = value;
-    while (newValue.endsWith(trim)) {
-      newValue = value.split("").reverse().join("").replace(trim, "").split("").reverse().join("");
-    }
-    return newValue;
-  }
-  static pluralize(value) {
-    return value[value.length - 1] === "s" ? value + "es" : value + "s";
-  }
-  static addArticle(value, article) {
-    let fmtArticle = "";
-    switch (article) {
-      case "a/an":
-        fmtArticle = VOWELS.includes(value?.[0].toLowerCase()) ? "An" : "A";
-        break;
-      default:
-        return article;
+}
+var Overloader = class {
+  invoke(...args) {
+    if (isFile(args[0])) {
+      return fileToLocalFile(...args);
     }
-    return `${fmtArticle.toLowerCase()} ${value}`;
-  }
-  static toSearch(from) {
-    return from.split("").filter((char) => char !== " ").join("").toLowerCase().trim();
-  }
-  static toMoney(from, options) {
-    return NumberFormatter_default.toMoney(_StringFormatter.toNumber(from), options);
-  }
-  static toTRN(from) {
-    return InputManager_default.separateNumbersFormatter().format(from);
-  }
-  static toNumber(value) {
-    const potentialNumber = take(value.split("."), 2).join(".").split("").map(
-      (char, idx) => idx === 0 && char === "-" ? char : "0123456789.".includes(char) ? char : ""
-    ).join("");
-    return isEmpty(potentialNumber.trim()) ? 0 : parseFloat(potentialNumber);
-  }
-  static upperFirst(value) {
-    return value.split("").map((char, idx) => idx === 0 ? char.toUpperCase() : char).join("");
+    if (isLocalFile(args[0])) {
+      return localFileToFile(...args);
+    } else throw new Error(`The arguments supplied are insufficient.`);
   }
 };
-var StringFormatter_default = StringFormatter;
-
-// src/helper-functions/components/formatter/object/ObjectFormatter.ts
-var ObjectFormatter = class {
-  static toString = {
-    name: (name) => name ? `${name.first} ${name.last}`.trim() : "no_name",
-    phoneNumber: (phoneNumber) => {
-      if (!phoneNumber) return "no_phone_number";
-      return `${phoneNumber.countryCode} (${phoneNumber.areaCode}) ${insertAt(
-        phoneNumber.localNumber.split(""),
-        3,
-        "-"
-      ).join("")}`;
-    },
-    address: (address, inline) => {
-      if (address === void 0) return "no_address";
-      const addressKeys = Object.keys(address).map((k) => k);
-      const delimiter = (isLast) => !isLast ? "," + (!inline ? "\n" : "") : "";
-      return addressKeys.map(
-        (key, idx) => address[key] + delimiter(idx === lastIndex(addressKeys))
-      ).join("") || "no_address";
-    }
-  };
-};
-var ObjectFormatter_default = ObjectFormatter;
+var toObject = new Overloader().invoke;
 
 // src/helper-functions/HelperFunctions.ts
-import { v4 } from "uuid";
-import { LOCAL_FILE_MIME_TYPES } from "@wavy/types";
-import { log } from "console";
 var dateFormat = new TimeManager_default().format;
 var timeDuration = new TimeManager_default().getDuration;
 var upperFirst = StringFormatter_default.upperFirst;
@@ -409,7 +463,7 @@ function isLocalFile(value) {
     uploadDate: 0,
     _metadata: void 0
   };
-  const optionalKeys = ["description", "_metadata"];
+  const optionalKeys = ["description"];
   const requiredKeys = Object.keys(dummyLocalFile).filter((key) => !optionalKeys.includes(key));
   const allKeys = [requiredKeys, optionalKeys].flat();
   if (value && typeof value === "object" && requiredKeys.every((key) => key in value) && Object.keys(value).every((key) => allKeys.includes(key))) {
@@ -417,68 +471,8 @@ function isLocalFile(value) {
   }
   return false;
 }
-var toObject = new class T {
-  fileToLocalFile(file, options) {
-    const fileName = (() => {
-      const fileExt = getFileExt(file.name);
-      if (options?.filename && options.filename.includes(fileExt))
-        return options.filename;
-      else if (options?.filename) return options.filename.trim() + fileExt;
-      return file.name;
-    })()?.trim?.();
-    const { name: _, size: __, ..._metadata } = file;
-    return {
-      uid: v4(),
-      description: options?.description,
-      path: options?.filepath || file.webkitRelativePath,
-      typeAlias: options?.typeAlias || run(
-        Object.keys(LOCAL_FILE_MIME_TYPES).find(
-          (key) => LOCAL_FILE_MIME_TYPES[key].includes(file.type)
-        ),
-        (type) => {
-          if (!type) {
-            log("An unknown file type was found ", file.type);
-            return "unknown";
-          }
-          return type;
-        }
-      ),
-      sizeInBytes: file.size,
-      uploadDate: options?.uploadDate === "now" ? Date.now() : options?.uploadDate ?? file.lastModified,
-      name: fileName,
-      _metadata
-    };
-  }
-  localFileToFile(localFile) {
-    if ("_metadata" in localFile) {
-      return {
-        name: localFile.name,
-        size: localFile.sizeInBytes,
-        ...localFile._metadata
-      };
-    }
-    return {
-      name: localFile.name,
-      size: localFile.sizeInBytes,
-      webkitRelativePath: localFile.path,
-      lastModified: localFile.uploadDate
-    };
-  }
-  invoke(...args) {
-    if (isFile(args[0])) {
-      return this.fileToLocalFile(
-        ...args
-      );
-    }
-    if (isLocalFile(args[0])) {
-      return this.localFileToFile(
-        ...args
-      );
-    } else throw new Error(`The arguments supplied are insufficient.`);
-  }
-}().invoke;
 function getMimeTypes(typeAliases) {
-  return distinct(strictArray(typeAliases)).map((alias) => LOCAL_FILE_MIME_TYPES[alias]).flat();
+  return distinct(strictArray(typeAliases)).map((alias) => LOCAL_FILE_MIME_TYPES2[alias]).flat();
 }
 function classNameResolver(baseClassName) {
   return (className) => {
@@ -748,7 +742,7 @@ function getFileExt(filePath) {
 async function copyToClipboard(text) {
   try {
     await navigator.clipboard.writeText(text);
-    return { data: "success" };
+    return { response: "success" };
   } catch (err) {
     console.error("Failed to copy text: ", err);
     if (err instanceof Error) {
@@ -772,7 +766,7 @@ async function copyToClipboard(text) {
 async function readClipboardText() {
   try {
     const text = await navigator.clipboard.readText();
-    return { data: { text: text.trim() } };
+    return { response: { text: text.trim() } };
   } catch (err) {
     console.error("Failed to read clipboard contents: ", err);
     return {
@@ -1045,7 +1039,6 @@ export {
   takeWhile,
   timeDuration,
   toNumber,
-  toObject,
   trimString,
   undefinedIfEmpty,
   upperFirst,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wavy/fn",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "main": "./dist/main.js",
   "module": "./dist/main.cjs",
   "types": "./dist/main.d.ts",
@@ -22,7 +22,7 @@
   "description": "",
   "devDependencies": {
     "@types/node": "^24.5.2",
-    "@wavy/types": "^0.0.26",
+    "@wavy/types": "^0.0.32",
     "tsup": "^8.5.0",
     "typescript": "^5.9.2"
   }