@wavy/fn 0.0.25 → 0.0.27

package/dist/main.cjs

@@ -62,6 +62,7 @@ __export(main_exports, {
   isNumber: () => isNumber,
   isPromise: () => isPromise,
   lastIndex: () => lastIndex,
+  limit: () => limit,
   map: () => map,
   mapToArray: () => mapToArray,
   maxOf: () => maxOf,
@@ -71,6 +72,11 @@ __export(main_exports, {
   omitNils: () => omitNils,
   ordinalIndicator: () => ordinalIndicator,
   overwrite: () => overwrite,
+  parseAddress: () => parseAddress,
+  parseDate: () => parseDate,
+  parseFileSize: () => parseFileSize,
+  parseMoney: () => parseMoney,
+  parseName: () => parseName,
   pick: () => pick,
   pluralize: () => pluralize,
   poll: () => poll,
@@ -617,6 +623,60 @@ function isPromise(value) {
   if (value instanceof Promise) return true;
   return !!value && (typeof value === "object" || typeof value === "function") && "then" in value && typeof value.then === "function";
 }
+var parseDate = dateFormat;
+function parseName(value) {
+  if (typeof value === "string") {
+    const [first2 = "", last2 = ""] = (value || "").trim().split(" ");
+    return { first: first2, last: last2 };
+  }
+  const { first = "", last = "" } = value || {};
+  return first.trim() + " " + last.trim();
+}
+function parseMoney(value) {
+  if (typeof value === "string") return StringFormatter_default.toMoney(value);
+  return NumberFormatter_default.toMoney(value);
+}
+function parseAddress(address, ...args) {
+  if (typeof address === "string") {
+    const [
+      options = {
+        delimiter: "|",
+        syntax: ["streetAddress", "city", "parish", "country"]
+      }
+    ] = args;
+    if (typeof options === "boolean") {
+      throw new Error(
+        "Type mismatch. Expected 'object' but 'boolean' was provided."
+      );
+    }
+    const fields = address.split(options.delimiter);
+    return Object.fromEntries(
+      limit(distinct(options.syntax), 4).map((key, i) => {
+        return [key, fields[i]];
+      })
+    );
+  }
+  if (typeof address === "object") {
+    const [inline] = args;
+    return addressToString(
+      address,
+      typeof inline === "boolean" ? inline : void 0
+    );
+  }
+  return null;
+}
+function parseFileSize(bytes) {
+  return new FileSizeFormatter(bytes).format();
+}
+function limit(array, limit2) {
+  const newArray = [];
+  if (!array) return;
+  for (const item of array) {
+    if (newArray.length === limit2) break;
+    newArray.push(item);
+  }
+  return newArray;
+}
 function castArray(value) {
   return Array.isArray(value) ? value : [value];
 }
@@ -652,6 +712,16 @@ function omitNils(value) {
   }
   return result;
 }
+function map(arr, callback) {
+  let ended = false;
+  for (let i = 0; i < arr.length; i++) {
+    if (ended) break;
+    arr[i] = callback(arr[i], i, arr, () => {
+      ended = true;
+    });
+  }
+  return arr;
+}
 function getMimeTypes(typeAliases) {
   return distinct(strictArray(typeAliases)).map((alias) => import_types2.LOCAL_FILE_MIME_TYPES[alias]).flat();
 }
@@ -881,14 +951,6 @@ function distinct(arr) {
   });
   return newArr;
 }
-function map(from, mappedFields) {
-  return Object.fromEntries(
-    Object.keys(mappedFields).map((key) => {
-      const validKey = key;
-      return [mappedFields[validKey], from[validKey]];
-    })
-  );
-}
 function isEmpty(value) {
   const valueLength = typeof value === "string" ? value.trim().length : value.length;
   return valueLength === 0;
@@ -1184,6 +1246,7 @@ var serverDataAdapter = new ServerDataAdapter().invoke;
   isNumber,
   isPromise,
   lastIndex,
+  limit,
   map,
   mapToArray,
   maxOf,
@@ -1193,6 +1256,11 @@ var serverDataAdapter = new ServerDataAdapter().invoke;
   omitNils,
   ordinalIndicator,
   overwrite,
+  parseAddress,
+  parseDate,
+  parseFileSize,
+  parseMoney,
+  parseName,
   pick,
   pluralize,
   poll,

package/dist/main.d.cts

@@ -1,6 +1,5 @@
 import "@wavy/types"
-import * as _wavy_types from '@wavy/types';
-import { LocalFile, SanitizeFile, NonFunction, KnownFileTypeAlias, TaskResult, FromServer, NormalizeFromServer } from '@wavy/types';
+import { LocalFile, Name, Address, SanitizeFile, NonFunction, KnownFileTypeAlias, TaskResult, FromServer, NormalizeFromServer } from '@wavy/types';
 
 type DateFormat = "MMM dd, yyyy" | "MMM dd, yyyy | hh:mm A" | "MMM dd, yyyy at hh:mm A" | "MMMM" | "yyyy" | "MMM yyyy" | "mm/dd/yyyy" | "mm/dd/yyyy hh:mm A" | "hh:mm A" | "hh:mm:ss A";
 
@@ -60,20 +59,42 @@ declare const getCaps: (value: string, count?: number) => string[];
 declare const toNumber: typeof StringFormatter.toNumber;
 declare const addArticle: typeof StringFormatter.addArticle;
 declare const pluralize: typeof StringFormatter.pluralize;
-declare const nameToString: (name: _wavy_types.Name | undefined) => string;
-declare const addressToString: (address: _wavy_types.Address | undefined, inline?: boolean) => string;
+declare const nameToString: (name: Name | undefined) => string;
+declare const addressToString: (address: Address | undefined, inline?: boolean) => string;
 declare const toMoney: (value: string | number, options?: NumberFormatterTypes["options"]["money"]) => string;
+/**
+ * @deprecated Migrate to individual function calls.
+ * @example parseDate, parseMoney, parseName, parseAddress, parseFileSize
+ */
 declare function format<Event extends "date" | "money" | "name" | "address" | "file-size">(event: Event, ...args: Event extends "date" ? Parameters<typeof dateFormat> : Event extends "money" ? Parameters<typeof toMoney> : Event extends "name" ? Parameters<typeof nameToString> : Event extends "address" ? Parameters<typeof addressToString> : Event extends "file-size" ? [bytes: number] : never): Event extends "date" | "money" | "name" | "address" | "file-size" ? string : never;
 declare function sanitizeLocalFile({ _metadata: _, ...file }: LocalFile): SanitizeFile<LocalFile>;
 declare function isFile(value: unknown): value is File;
 declare function isLocalFile(value: unknown): value is LocalFile;
 declare function isIterable<T>(value: unknown): value is Iterable<T>;
 declare function isPromise<T>(value: unknown): value is Promise<T>;
+declare const parseDate: (time: number | Date | "now", format?: DateFormat) => string;
+declare function parseName<Value extends string | Name>(value: Value): Value extends string ? Name : Value extends Name ? string : never;
+declare function parseMoney(value: string | number): string;
+declare function parseAddress<T extends Address | string>(address: T, ...args: T extends string ? [
+    options?: Partial<{
+        /**The value used to separate each field in the string
+         * @default "|"
+         */
+        delimiter?: string;
+        /**The order in which the fields appear
+         * @default ["streetAddress", "city", "parish", "country"]
+         */
+        syntax?: (keyof Address)[];
+    }>
+] : T extends Address ? [inline?: boolean] : []): (T extends Address ? string : T extends string ? Address : never) | null;
+declare function parseFileSize(bytes: number): string;
+declare function limit<T>(array: T[], limit: number): T[] | undefined;
 declare function castArray<T>(value: T | T[]): T[];
 declare function castReturn<T extends NonFunction<any>>(value: T | (() => T)): T;
-declare function pick<O extends object, K extends keyof O>(value: O, keys: K[]): { [Key in K]: O[Key] | null; };
-declare function omit<O extends object, K extends keyof O>(value: O, keys: K[]): { [Key in Exclude<keyof O, K>]: O[Key] | null; };
+declare function pick<O extends object, K extends keyof O = keyof O>(value: O, keys: K[]): { [Key in K]: O[Key] | null; };
+declare function omit<O extends object, K extends keyof O = keyof O>(value: O, keys: K[]): { [Key in Exclude<keyof O, K>]: O[Key] | null; };
 declare function omitNils<O extends object>(value: O): O;
+declare function map<T>(arr: T[], callback: (value: T, index: number, array: T[], end: () => void) => T): T[];
 declare function getMimeTypes(typeAliases: KnownFileTypeAlias[]): string[];
 declare function classNameResolver(baseClassName: string): (className: string) => string;
 declare function classNameExt(rootClassName: string): (className: string) => string;
@@ -161,7 +182,6 @@ declare function mapToArray<K extends string | number | symbol, V>(map: Map<K, V
     [Key in K]: V;
 }[];
 declare function distinct<T>(arr: T[]): T[];
-declare function map<To extends object, From extends object>(from: From, mappedFields: Record<keyof From, keyof To>): To;
 declare function isEmpty(value: string | unknown[]): boolean;
 declare function ifDefined<T, R>(value: T | undefined, cb: (value: T) => R): R | undefined;
 declare function someValuesEmpty<O extends {
@@ -192,4 +212,4 @@ declare const serverDataAdapter: {
     }>(event: "unzip", data: DataType): NormalizeFromServer<DataType>;
 };
 
-export { addArticle, arrayWithConst, asyncRun, averageOf, blankSpaces, buildArray, camelCaseToLetter, castArray, castReturn, classNameExt, classNameResolver, coerceIn, copyToClipboard, count, dataSearcher, distinct, drop, dropLast, dropLastWhile, dropWhile, format, getCaps, getFileExt, getFilename, getMimeTypes, group, hasIndex, ifDefined, ifEmpty, inRange, indexOf, indices, inferFilename, insertAt, isEmpty, isFile, isIterable, isLetter, isLocalFile, isNumber, isPromise, lastIndex, map, mapToArray, maxOf, minOf, negate, omit, omitNils, ordinalIndicator, overwrite, pick, pluralize, poll, random, range, readClipboardText, removeAll, repeat, run, sanitizeLocalFile, 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, castArray, castReturn, classNameExt, classNameResolver, coerceIn, copyToClipboard, count, dataSearcher, distinct, drop, dropLast, dropLastWhile, dropWhile, format, getCaps, getFileExt, getFilename, getMimeTypes, group, hasIndex, ifDefined, ifEmpty, inRange, indexOf, indices, inferFilename, insertAt, isEmpty, isFile, isIterable, isLetter, isLocalFile, isNumber, isPromise, lastIndex, limit, map, mapToArray, maxOf, minOf, negate, omit, omitNils, ordinalIndicator, overwrite, parseAddress, parseDate, parseFileSize, parseMoney, parseName, pick, pluralize, poll, random, range, readClipboardText, removeAll, repeat, run, sanitizeLocalFile, serverDataAdapter, someValuesEmpty, sort, strictArray, stringToSearch, subObjectList, sumOf, take, takeLast, takeLastWhile, takeWhile, timeDuration, toNumber, toObject, trimString, undefinedIfEmpty, upperFirst, windowed };

package/dist/main.d.ts

@@ -1,6 +1,5 @@
 import "@wavy/types"
-import * as _wavy_types from '@wavy/types';
-import { LocalFile, SanitizeFile, NonFunction, KnownFileTypeAlias, TaskResult, FromServer, NormalizeFromServer } from '@wavy/types';
+import { LocalFile, Name, Address, SanitizeFile, NonFunction, KnownFileTypeAlias, TaskResult, FromServer, NormalizeFromServer } from '@wavy/types';
 
 type DateFormat = "MMM dd, yyyy" | "MMM dd, yyyy | hh:mm A" | "MMM dd, yyyy at hh:mm A" | "MMMM" | "yyyy" | "MMM yyyy" | "mm/dd/yyyy" | "mm/dd/yyyy hh:mm A" | "hh:mm A" | "hh:mm:ss A";
 
@@ -60,20 +59,42 @@ declare const getCaps: (value: string, count?: number) => string[];
 declare const toNumber: typeof StringFormatter.toNumber;
 declare const addArticle: typeof StringFormatter.addArticle;
 declare const pluralize: typeof StringFormatter.pluralize;
-declare const nameToString: (name: _wavy_types.Name | undefined) => string;
-declare const addressToString: (address: _wavy_types.Address | undefined, inline?: boolean) => string;
+declare const nameToString: (name: Name | undefined) => string;
+declare const addressToString: (address: Address | undefined, inline?: boolean) => string;
 declare const toMoney: (value: string | number, options?: NumberFormatterTypes["options"]["money"]) => string;
+/**
+ * @deprecated Migrate to individual function calls.
+ * @example parseDate, parseMoney, parseName, parseAddress, parseFileSize
+ */
 declare function format<Event extends "date" | "money" | "name" | "address" | "file-size">(event: Event, ...args: Event extends "date" ? Parameters<typeof dateFormat> : Event extends "money" ? Parameters<typeof toMoney> : Event extends "name" ? Parameters<typeof nameToString> : Event extends "address" ? Parameters<typeof addressToString> : Event extends "file-size" ? [bytes: number] : never): Event extends "date" | "money" | "name" | "address" | "file-size" ? string : never;
 declare function sanitizeLocalFile({ _metadata: _, ...file }: LocalFile): SanitizeFile<LocalFile>;
 declare function isFile(value: unknown): value is File;
 declare function isLocalFile(value: unknown): value is LocalFile;
 declare function isIterable<T>(value: unknown): value is Iterable<T>;
 declare function isPromise<T>(value: unknown): value is Promise<T>;
+declare const parseDate: (time: number | Date | "now", format?: DateFormat) => string;
+declare function parseName<Value extends string | Name>(value: Value): Value extends string ? Name : Value extends Name ? string : never;
+declare function parseMoney(value: string | number): string;
+declare function parseAddress<T extends Address | string>(address: T, ...args: T extends string ? [
+    options?: Partial<{
+        /**The value used to separate each field in the string
+         * @default "|"
+         */
+        delimiter?: string;
+        /**The order in which the fields appear
+         * @default ["streetAddress", "city", "parish", "country"]
+         */
+        syntax?: (keyof Address)[];
+    }>
+] : T extends Address ? [inline?: boolean] : []): (T extends Address ? string : T extends string ? Address : never) | null;
+declare function parseFileSize(bytes: number): string;
+declare function limit<T>(array: T[], limit: number): T[] | undefined;
 declare function castArray<T>(value: T | T[]): T[];
 declare function castReturn<T extends NonFunction<any>>(value: T | (() => T)): T;
-declare function pick<O extends object, K extends keyof O>(value: O, keys: K[]): { [Key in K]: O[Key] | null; };
-declare function omit<O extends object, K extends keyof O>(value: O, keys: K[]): { [Key in Exclude<keyof O, K>]: O[Key] | null; };
+declare function pick<O extends object, K extends keyof O = keyof O>(value: O, keys: K[]): { [Key in K]: O[Key] | null; };
+declare function omit<O extends object, K extends keyof O = keyof O>(value: O, keys: K[]): { [Key in Exclude<keyof O, K>]: O[Key] | null; };
 declare function omitNils<O extends object>(value: O): O;
+declare function map<T>(arr: T[], callback: (value: T, index: number, array: T[], end: () => void) => T): T[];
 declare function getMimeTypes(typeAliases: KnownFileTypeAlias[]): string[];
 declare function classNameResolver(baseClassName: string): (className: string) => string;
 declare function classNameExt(rootClassName: string): (className: string) => string;
@@ -161,7 +182,6 @@ declare function mapToArray<K extends string | number | symbol, V>(map: Map<K, V
     [Key in K]: V;
 }[];
 declare function distinct<T>(arr: T[]): T[];
-declare function map<To extends object, From extends object>(from: From, mappedFields: Record<keyof From, keyof To>): To;
 declare function isEmpty(value: string | unknown[]): boolean;
 declare function ifDefined<T, R>(value: T | undefined, cb: (value: T) => R): R | undefined;
 declare function someValuesEmpty<O extends {
@@ -192,4 +212,4 @@ declare const serverDataAdapter: {
     }>(event: "unzip", data: DataType): NormalizeFromServer<DataType>;
 };
 
-export { addArticle, arrayWithConst, asyncRun, averageOf, blankSpaces, buildArray, camelCaseToLetter, castArray, castReturn, classNameExt, classNameResolver, coerceIn, copyToClipboard, count, dataSearcher, distinct, drop, dropLast, dropLastWhile, dropWhile, format, getCaps, getFileExt, getFilename, getMimeTypes, group, hasIndex, ifDefined, ifEmpty, inRange, indexOf, indices, inferFilename, insertAt, isEmpty, isFile, isIterable, isLetter, isLocalFile, isNumber, isPromise, lastIndex, map, mapToArray, maxOf, minOf, negate, omit, omitNils, ordinalIndicator, overwrite, pick, pluralize, poll, random, range, readClipboardText, removeAll, repeat, run, sanitizeLocalFile, 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, castArray, castReturn, classNameExt, classNameResolver, coerceIn, copyToClipboard, count, dataSearcher, distinct, drop, dropLast, dropLastWhile, dropWhile, format, getCaps, getFileExt, getFilename, getMimeTypes, group, hasIndex, ifDefined, ifEmpty, inRange, indexOf, indices, inferFilename, insertAt, isEmpty, isFile, isIterable, isLetter, isLocalFile, isNumber, isPromise, lastIndex, limit, map, mapToArray, maxOf, minOf, negate, omit, omitNils, ordinalIndicator, overwrite, parseAddress, parseDate, parseFileSize, parseMoney, parseName, pick, pluralize, poll, random, range, readClipboardText, removeAll, repeat, run, sanitizeLocalFile, serverDataAdapter, someValuesEmpty, sort, strictArray, stringToSearch, subObjectList, sumOf, take, takeLast, takeLastWhile, takeWhile, timeDuration, toNumber, toObject, trimString, undefinedIfEmpty, upperFirst, windowed };

package/dist/main.js

@@ -515,6 +515,60 @@ function isPromise(value) {
   if (value instanceof Promise) return true;
   return !!value && (typeof value === "object" || typeof value === "function") && "then" in value && typeof value.then === "function";
 }
+var parseDate = dateFormat;
+function parseName(value) {
+  if (typeof value === "string") {
+    const [first2 = "", last2 = ""] = (value || "").trim().split(" ");
+    return { first: first2, last: last2 };
+  }
+  const { first = "", last = "" } = value || {};
+  return first.trim() + " " + last.trim();
+}
+function parseMoney(value) {
+  if (typeof value === "string") return StringFormatter_default.toMoney(value);
+  return NumberFormatter_default.toMoney(value);
+}
+function parseAddress(address, ...args) {
+  if (typeof address === "string") {
+    const [
+      options = {
+        delimiter: "|",
+        syntax: ["streetAddress", "city", "parish", "country"]
+      }
+    ] = args;
+    if (typeof options === "boolean") {
+      throw new Error(
+        "Type mismatch. Expected 'object' but 'boolean' was provided."
+      );
+    }
+    const fields = address.split(options.delimiter);
+    return Object.fromEntries(
+      limit(distinct(options.syntax), 4).map((key, i) => {
+        return [key, fields[i]];
+      })
+    );
+  }
+  if (typeof address === "object") {
+    const [inline] = args;
+    return addressToString(
+      address,
+      typeof inline === "boolean" ? inline : void 0
+    );
+  }
+  return null;
+}
+function parseFileSize(bytes) {
+  return new FileSizeFormatter(bytes).format();
+}
+function limit(array, limit2) {
+  const newArray = [];
+  if (!array) return;
+  for (const item of array) {
+    if (newArray.length === limit2) break;
+    newArray.push(item);
+  }
+  return newArray;
+}
 function castArray(value) {
   return Array.isArray(value) ? value : [value];
 }
@@ -550,6 +604,16 @@ function omitNils(value) {
   }
   return result;
 }
+function map(arr, callback) {
+  let ended = false;
+  for (let i = 0; i < arr.length; i++) {
+    if (ended) break;
+    arr[i] = callback(arr[i], i, arr, () => {
+      ended = true;
+    });
+  }
+  return arr;
+}
 function getMimeTypes(typeAliases) {
   return distinct(strictArray(typeAliases)).map((alias) => LOCAL_FILE_MIME_TYPES2[alias]).flat();
 }
@@ -779,14 +843,6 @@ function distinct(arr) {
   });
   return newArr;
 }
-function map(from, mappedFields) {
-  return Object.fromEntries(
-    Object.keys(mappedFields).map((key) => {
-      const validKey = key;
-      return [mappedFields[validKey], from[validKey]];
-    })
-  );
-}
 function isEmpty(value) {
   const valueLength = typeof value === "string" ? value.trim().length : value.length;
   return valueLength === 0;
@@ -1081,6 +1137,7 @@ export {
   isNumber,
   isPromise,
   lastIndex,
+  limit,
   map,
   mapToArray,
   maxOf,
@@ -1090,6 +1147,11 @@ export {
   omitNils,
   ordinalIndicator,
   overwrite,
+  parseAddress,
+  parseDate,
+  parseFileSize,
+  parseMoney,
+  parseName,
   pick,
   pluralize,
   poll,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wavy/fn",
-  "version": "0.0.25",
+  "version": "0.0.27",
   "main": "./dist/main.js",
   "module": "./dist/main.cjs",
   "types": "./dist/main.d.ts",