@valkyriestudios/utils 12.22.0 → 12.24.0

package/README.md

@@ -787,7 +787,7 @@ isFormData(new FormData()); // TRUE
 isFormData({hi: 'there'}); // FALSE
 ```
 
-### formdata/toObject(val:FormData, {raw?:string[]} = {})
+### formdata/toObject(val:FormData, {raw?:string[]|true;single?:string[]} = {})
 Converts an instance of FormData to an object
 ```typescript
 import toObject from '@valkyriestudios/utils/formdata/toObject';
@@ -840,6 +840,19 @@ toObject(form, {raw: ['pincode']}); /* {
 } */
 ```
 
+Take Note: Set raw to `true` to do no normalization
+
+Allows passing a 'single' list that tells the system to NEVER turn a particular value into an array of values:
+```typescript
+const formData = new FormData();
+formData.append('status', 'active');
+formData.append('status', 'inactive');
+formData.append('action', 'save');
+formData.append('action', 'reset');
+
+toObject(formData, { single: ['status', 'action'] }) /* {status: 'inactive', action: 'reset'} */
+```
+
 ### hash/guid()
 Generate a unique identifier (guid) according to RFC4122
 ```typescript
@@ -1239,4 +1252,4 @@ humanizeNumber(47328748923747923479); // '47,328.75q'
 
 ## Contributors
 - [Peter Vermeulen](https://www.linkedin.com/in/petervermeulen1/)
-- [Xander Berkein](https://github.com/xanderberkein)
+- [Xander Berkein](https://github.com/xanderberkein)

package/array/join.js

@@ -4,7 +4,7 @@ exports.join = join;
 exports.default = join;
 const round_1 = require("../number/round");
 const isIntegerAboveOrEqual_1 = require("../number/isIntegerAboveOrEqual");
-const SPACE_RGX = /(\s){2,}/g;
+const SPACE_RGX = /(\s)+/g;
 function join(val, opts) {
     if (!Array.isArray(val) || !val.length)
         return '';
@@ -17,9 +17,12 @@ function join(val, opts) {
     let hasVal = false;
     for (let i = 0; i < val.length; i++) {
         const el = val[i];
-        if (typeof el === 'string' && el.trim().length) {
-            const trimmed = VALTRIM ? el.trim() : el;
-            result = result + (hasVal ? DELIM : '') + (INNERTRIM ? trimmed.replace(SPACE_RGX, ' ') : trimmed);
+        if (typeof el === 'string') {
+            const trimmed = el.trim();
+            if (!trimmed)
+                continue;
+            const n_el = VALTRIM ? trimmed : el;
+            result = result + (hasVal ? DELIM : '') + (INNERTRIM ? n_el.replace(SPACE_RGX, ' ') : n_el);
             hasVal = true;
         }
         else if (Number.isFinite(el)) {

package/array/mapPrimitive.js

@@ -17,11 +17,11 @@ function mapPrimitive(arr, opts = {}) {
         const el = arr[i];
         if (typeof el === 'string') {
             const trimmed = el.trim();
-            if (!trimmed.length)
+            if (!trimmed)
                 continue;
             map[trimmed] = VALTRIM ? trimmed : el;
         }
-        else if (typeof el === 'number' && Number.isFinite(el)) {
+        else if (Number.isFinite(el)) {
             map[`${KEYROUND ? Math.round(el) : el}`] = VALROUND === false
                 ? el
                 : VALROUND === true

package/date/addUTC.d.ts

@@ -2,9 +2,9 @@ export type AddUTCKey = 'years' | 'year' | 'months' | 'month' | 'days' | 'day' |
 /**
  * Adds the provided amount of a specific key to the provided date
  *
- * @param {Date} val - Date to set to end of
+ * @param {Date|string} val - Date to set to end of
  * @param {number} amount - (default=0) Amount of key to add
  * @param {AddUTCKey} key - (default='millisecond') Key to set
  */
-declare function addUTC(val: Date, amt?: number, key?: AddUTCKey): Date;
+declare function addUTC(val: Date | string, amt?: number, key?: AddUTCKey): Date;
 export { addUTC, addUTC as default };

package/date/addUTC.js

@@ -2,19 +2,20 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.addUTC = addUTC;
 exports.default = addUTC;
-const is_1 = require("./is");
+const convertToDate_1 = require("./convertToDate");
 function addUTC(val, amt = 0, key = 'millisecond') {
-    if (!(0, is_1.isDate)(val))
-        throw new TypeError('addUTC requires a date object');
     if (!Number.isInteger(amt))
         throw new TypeError('Amount needs to be an integer');
-    const year = val.getUTCFullYear();
-    const month = val.getUTCMonth();
-    const date = val.getUTCDate();
-    const hour = val.getUTCHours();
-    const min = val.getUTCMinutes();
-    const sec = val.getUTCSeconds();
-    const ms = val.getUTCMilliseconds();
+    const n_val = (0, convertToDate_1.convertToDate)(val);
+    if (n_val === null)
+        throw new TypeError('addUTC requires a date object');
+    const year = n_val.getUTCFullYear();
+    const month = n_val.getUTCMonth();
+    const date = n_val.getUTCDate();
+    const hour = n_val.getUTCHours();
+    const min = n_val.getUTCMinutes();
+    const sec = n_val.getUTCSeconds();
+    const ms = n_val.getUTCMilliseconds();
     switch (key) {
         case 'years':
         case 'year':

package/date/convertToDate.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Convert a value to a Date object if possible, handles Date objects and strings
+ *
+ * @param {Date|string} val - Value to convert
+ */
+declare function convertToDate(val: Date | string | number): Date | null;
+export { convertToDate, convertToDate as default };

package/date/convertToDate.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertToDate = convertToDate;
+exports.default = convertToDate;
+const is_1 = require("./is");
+function convertToDate(val) {
+    if ((0, is_1.isDate)(val)) {
+        return val;
+    }
+    else if (typeof val === 'string') {
+        const date = new Date(val);
+        return Number.isNaN(date.getTime()) ? null : date;
+    }
+    return null;
+}

package/date/diff.d.ts

@@ -2,9 +2,9 @@ export type DiffKey = 'week' | 'weeks' | 'day' | 'days' | 'hour' | 'hours' | 'mi
 /**
  * Compute the diff between two dates in the provided key
  *
- * @param {Date} val_a - Date to diff against
- * @param {Date} val_b - Date to diff with
+ * @param {Date|string} val_a - Date to diff against
+ * @param {Date|string} val_b - Date to diff with
  * @param {DiffKey} key - (default='millisecond') Key to diff in
  */
-declare function diff(val_a: Date, val_b: Date, key?: DiffKey): number;
+declare function diff(val_a: Date | string, val_b: Date | string, key?: DiffKey): number;
 export { diff, diff as default };

package/date/diff.js

@@ -2,17 +2,19 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.diff = diff;
 exports.default = diff;
-const is_1 = require("./is");
+const convertToDate_1 = require("./convertToDate");
 const SECOND_IN_MILLISECONDS = 1000;
 const MINUTE_IN_MILLISECONDS = SECOND_IN_MILLISECONDS * 60;
 const HOUR_IN_MILLISECONDS = MINUTE_IN_MILLISECONDS * 60;
 const DAY_IN_MILLISECONDS = HOUR_IN_MILLISECONDS * 24;
 const WEEK_IN_MILLISECONDS = DAY_IN_MILLISECONDS * 7;
 function diff(val_a, val_b, key = 'millisecond') {
-    if (!(0, is_1.isDate)(val_a) ||
-        !(0, is_1.isDate)(val_b))
+    const n_val_a = (0, convertToDate_1.convertToDate)(val_a);
+    const n_val_b = (0, convertToDate_1.convertToDate)(val_b);
+    if (n_val_a === null ||
+        n_val_b === null)
         throw new TypeError('Diff requires date objects for both values');
-    const diff_in_ms = val_a.valueOf() - val_b.valueOf();
+    const diff_in_ms = n_val_a.valueOf() - n_val_b.valueOf();
     switch (key) {
         case 'week':
         case 'weeks':

package/date/endOfUTC.d.ts

@@ -2,8 +2,8 @@ export type EndOfUTCKey = 'year' | 'quarter' | 'month' | 'week' | 'week_sun' | '
 /**
  * Sets the provided date to end of UTC of provided key
  *
- * @param {Date} val - Date to set to end of
+ * @param {Date|string} val - Date to set to end of
  * @param {EndOfUTCKey} key - (default='millisecond') Key to set
  */
-declare function endOfUTC(val: Date, key?: EndOfUTCKey): Date;
+declare function endOfUTC(val: Date | string, key?: EndOfUTCKey): Date;
 export { endOfUTC, endOfUTC as default };

package/date/endOfUTC.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.endOfUTC = endOfUTC;
 exports.default = endOfUTC;
-const is_1 = require("./is");
+const convertToDate_1 = require("./convertToDate");
 const WEEK_END = new Map([
     ['week', 0],
     ['week_sun', 6],
@@ -14,17 +14,19 @@ const WEEK_END = new Map([
     ['week_sat', 5],
 ]);
 function endOfUTC(val, key = 'millisecond') {
-    if (!(0, is_1.isDate)(val))
+    const n_val = (0, convertToDate_1.convertToDate)(val);
+    if (n_val === null)
         throw new TypeError('endOfUTC requires a date object');
+    const year = n_val.getUTCFullYear();
     switch (key) {
         case 'year':
-            return new Date(Date.UTC(val.getUTCFullYear(), 11, 31, 23, 59, 59, 999));
+            return new Date(Date.UTC(year, 11, 31, 23, 59, 59, 999));
         case 'quarter': {
-            const UTC_MONTH = val.getUTCMonth();
-            return new Date(Date.UTC(val.getUTCFullYear(), (UTC_MONTH - (UTC_MONTH % 3)) + 3, 0, 23, 59, 59, 999));
+            const UTC_MONTH = n_val.getUTCMonth();
+            return new Date(Date.UTC(year, (UTC_MONTH - (UTC_MONTH % 3)) + 3, 0, 23, 59, 59, 999));
         }
         case 'month':
-            return new Date(Date.UTC(val.getUTCFullYear(), val.getUTCMonth() + 1, 0, 23, 59, 59, 999));
+            return new Date(Date.UTC(year, n_val.getUTCMonth() + 1, 0, 23, 59, 59, 999));
         case 'week':
         case 'week_sun':
         case 'week_mon':
@@ -33,19 +35,19 @@ function endOfUTC(val, key = 'millisecond') {
         case 'week_thu':
         case 'week_fri':
         case 'week_sat': {
-            const UTC_DAY = val.getUTCDay();
+            const UTC_DAY = n_val.getUTCDay();
             const UTC_EOD = WEEK_END.get(key);
-            return new Date(Date.UTC(val.getUTCFullYear(), val.getUTCMonth(), val.getUTCDate() + (UTC_DAY <= UTC_EOD ? UTC_EOD - UTC_DAY : (7 - UTC_DAY) + UTC_EOD), 23, 59, 59, 999));
+            return new Date(Date.UTC(year, n_val.getUTCMonth(), n_val.getUTCDate() + (UTC_DAY <= UTC_EOD ? UTC_EOD - UTC_DAY : (7 - UTC_DAY) + UTC_EOD), 23, 59, 59, 999));
         }
         case 'day':
-            return new Date(Date.UTC(val.getUTCFullYear(), val.getUTCMonth(), val.getUTCDate(), 23, 59, 59, 999));
+            return new Date(Date.UTC(year, n_val.getUTCMonth(), n_val.getUTCDate(), 23, 59, 59, 999));
         case 'hour':
-            return new Date(Date.UTC(val.getUTCFullYear(), val.getUTCMonth(), val.getUTCDate(), val.getUTCHours(), 59, 59, 999));
+            return new Date(Date.UTC(year, n_val.getUTCMonth(), n_val.getUTCDate(), n_val.getUTCHours(), 59, 59, 999));
         case 'minute':
-            return new Date(Date.UTC(val.getUTCFullYear(), val.getUTCMonth(), val.getUTCDate(), val.getUTCHours(), val.getUTCMinutes(), 59, 999));
+            return new Date(Date.UTC(year, n_val.getUTCMonth(), n_val.getUTCDate(), n_val.getUTCHours(), n_val.getUTCMinutes(), 59, 999));
         case 'second':
-            return new Date(Date.UTC(val.getUTCFullYear(), val.getUTCMonth(), val.getUTCDate(), val.getUTCHours(), val.getUTCMinutes(), val.getUTCSeconds(), 999));
+            return new Date(Date.UTC(year, n_val.getUTCMonth(), n_val.getUTCDate(), n_val.getUTCHours(), n_val.getUTCMinutes(), n_val.getUTCSeconds(), 999));
         default:
-            return new Date(Date.UTC(val.getUTCFullYear(), val.getUTCMonth(), val.getUTCDate(), val.getUTCHours(), val.getUTCMinutes(), val.getUTCSeconds(), val.getUTCMilliseconds()));
+            return new Date(Date.UTC(year, n_val.getUTCMonth(), n_val.getUTCDate(), n_val.getUTCHours(), n_val.getUTCMinutes(), n_val.getUTCSeconds(), n_val.getUTCMilliseconds()));
     }
 }

package/date/format.d.ts

@@ -7,14 +7,14 @@ export type WEEK_START = keyof typeof WEEK_STARTS;
 /**
  * Formats the provided date according to a specific spec
  *
- * @param {Date} val - Date to format
+ * @param {Date|string} val - Date to format
  * @param {string} spec - Spec to format the date to
  * @param {string} locale - Locale to format the date in (only used in certain tokens such as dddd and MMMM)
  * @param {string} zone - (default=current timezone) Pass the timezone to convert into. If not passed no conversion will happen
  * @param {string} sow - (default='mon') Start of week (only useful when working with the 'W' and 'w' tokens for week numbers
  * @throws {TypeError} When provided invalid payload
  */
-declare function format(val: Date, spec: string, locale?: string, zone?: string, sow?: WEEK_START): string;
+declare function format(val: Date | string, spec: string, locale?: string, zone?: string, sow?: WEEK_START): string;
 declare namespace format {
     var getLocale: () => string;
     var setLocale: (locale: string) => void;

package/date/format.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.format = format;
 exports.default = format;
-const is_1 = require("./is");
+const convertToDate_1 = require("./convertToDate");
 const WEEK_STARTS = {
     mon: 'mon',
     sun: 'sun',
@@ -14,7 +14,7 @@ let DEFAULT_SOW = 'mon';
 try {
     DEFAULT_TZ = Intl.DateTimeFormat().resolvedOptions().timeZone;
 }
-catch (err) {
+catch {
 }
 finally {
     if (typeof DEFAULT_TZ !== 'string')
@@ -25,17 +25,17 @@ const intl_formatters = Object.create(null);
 const spec_cache = Object.create(null);
 const zone_offset_cache = Object.create(null);
 function WeekNr(d, sow) {
-    const date = new Date(d.valueOf());
     switch (sow) {
         case 'sun':
         case 'sat': {
             const OFFSET = sow === 'sat' ? 1 : 0;
-            const jan1 = new Date(Date.UTC(date.getUTCFullYear(), 0, 1));
-            const near = new Date(date.getTime() - (((date.getDay() + OFFSET) % 7) * 86400000));
+            const jan1 = new Date(Date.UTC(d.getUTCFullYear(), 0, 1));
+            const near = new Date(d.getTime() - (((d.getDay() + OFFSET) % 7) * 86400000));
             const first = new Date(jan1.getTime() - (((jan1.getDay() + OFFSET) % 7) * 86400000));
             return 1 + Math.floor((near.valueOf() - first.valueOf()) / 604800000);
         }
         default: {
+            const date = new Date(d.valueOf());
             date.setDate(date.getDate() - ((d.getDay() + 6) % 7) + 3);
             const date_thu = date.valueOf();
             date.setMonth(0, 1);
@@ -61,7 +61,7 @@ function toZone(d, zone) {
     try {
         zone_time = new Date(d.toLocaleString(DEFAULT_LOCALE, { timeZone: zone })).getTime();
     }
-    catch (err) {
+    catch {
         throw new Error(`format: Invalid zone passed - ${zone}`);
     }
     const offset = zone_time - time;
@@ -76,7 +76,7 @@ function runIntl(loc, token, props, val) {
             formatter = new Intl.DateTimeFormat(loc, props);
             intl_formatters[hash] = formatter;
         }
-        catch (err) {
+        catch {
             throw new Error(`format: Failed to run conversion for ${token} with locale ${loc}`);
         }
     }
@@ -176,7 +176,8 @@ function getSpecChain(spec) {
     return result;
 }
 function format(val, spec, locale = DEFAULT_LOCALE, zone = DEFAULT_TZ, sow = DEFAULT_SOW) {
-    if (!(0, is_1.isDate)(val))
+    const n_val = (0, convertToDate_1.convertToDate)(val);
+    if (n_val === null)
         throw new TypeError('format: val must be a Date');
     if (typeof spec !== 'string')
         throw new TypeError('format: spec must be a string');
@@ -186,8 +187,8 @@ function format(val, spec, locale = DEFAULT_LOCALE, zone = DEFAULT_TZ, sow = DEF
         throw new TypeError('format: zone must be a string');
     const n_spec = getSpecChain(spec);
     if (!n_spec)
-        return val.toISOString();
-    const d = toZone(val, zone);
+        return n_val.toISOString();
+    const d = toZone(n_val, zone);
     let base = n_spec.base;
     const { chain_len, chain, repl_len, repl } = n_spec;
     for (let i = 0; i < chain_len; i++) {

package/date/index.d.ts

@@ -1,4 +1,5 @@
 import { addUTC } from './addUTC';
+import { convertToDate } from './convertToDate';
 import { diff } from './diff';
 import { endOfUTC } from './endOfUTC';
 import { format } from './format';
@@ -11,4 +12,4 @@ import { setTimeUTC } from './setTimeUTC';
 import { startOfUTC } from './startOfUTC';
 import { toUnix } from './toUnix';
 import { toUTC } from './toUTC';
-export { addUTC, diff, endOfUTC, format, isDateFormat as isFormat, isDateFormat, isDate, isDate as is, isLeap, nowUnix, nowUnixMs, setTimeUTC, startOfUTC, toUnix, toUTC };
+export { addUTC, convertToDate, diff, endOfUTC, format, isDateFormat as isFormat, isDateFormat, isDate, isDate as is, isLeap, nowUnix, nowUnixMs, setTimeUTC, startOfUTC, toUnix, toUTC };

package/date/index.js

@@ -1,8 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.toUTC = exports.toUnix = exports.startOfUTC = exports.setTimeUTC = exports.nowUnixMs = exports.nowUnix = exports.isLeap = exports.is = exports.isDate = exports.isDateFormat = exports.isFormat = exports.format = exports.endOfUTC = exports.diff = exports.addUTC = void 0;
+exports.toUTC = exports.toUnix = exports.startOfUTC = exports.setTimeUTC = exports.nowUnixMs = exports.nowUnix = exports.isLeap = exports.is = exports.isDate = exports.isDateFormat = exports.isFormat = exports.format = exports.endOfUTC = exports.diff = exports.convertToDate = exports.addUTC = void 0;
 const addUTC_1 = require("./addUTC");
 Object.defineProperty(exports, "addUTC", { enumerable: true, get: function () { return addUTC_1.addUTC; } });
+const convertToDate_1 = require("./convertToDate");
+Object.defineProperty(exports, "convertToDate", { enumerable: true, get: function () { return convertToDate_1.convertToDate; } });
 const diff_1 = require("./diff");
 Object.defineProperty(exports, "diff", { enumerable: true, get: function () { return diff_1.diff; } });
 const endOfUTC_1 = require("./endOfUTC");

package/date/isLeap.d.ts

@@ -1,7 +1,7 @@
 /**
  * Check whether or not a provided value is a leap year
  *
- * @param {Date} val - Value to verify
+ * @param {Date|string} val - Value to verify
  */
-declare function isLeap(val: Date): boolean;
+declare function isLeap(val: Date | string): boolean;
 export { isLeap, isLeap as default };

package/date/isLeap.js

@@ -2,10 +2,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isLeap = isLeap;
 exports.default = isLeap;
-const is_1 = require("./is");
+const convertToDate_1 = require("./convertToDate");
 function isLeap(val) {
-    if (!(0, is_1.isDate)(val))
+    const n_val = (0, convertToDate_1.convertToDate)(val);
+    if (n_val === null)
         return false;
-    const year = val.getUTCFullYear();
-    return (((year % 4) === 0) && ((year % 100) !== 0)) || ((year % 400) === 0);
+    const year = n_val.getUTCFullYear();
+    return (year % 4 === 0 && year % 100 !== 0) || year % 400 === 0;
 }

package/date/setTimeUTC.d.ts

@@ -7,8 +7,8 @@ export type TimeProps = {
 /**
  * Sets the time on a provided date object and returns it
  *
- * @param {Date} val - Date to set the time for
+ * @param {Date|string} val - Date to set the time for
  * @param {TimeProps} props - Time props to set the time to
  */
-declare function setTimeUTC(val: Date, props: TimeProps): Date;
+declare function setTimeUTC(val: Date | string, props: TimeProps): Date;
 export { setTimeUTC, setTimeUTC as default };

package/date/setTimeUTC.js

@@ -2,10 +2,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.setTimeUTC = setTimeUTC;
 exports.default = setTimeUTC;
-const is_1 = require("./is");
+const convertToDate_1 = require("./convertToDate");
 const isIntegerBetween_1 = require("../number/isIntegerBetween");
 function setTimeUTC(val, props) {
-    if (!(0, is_1.isDate)(val))
+    const n_val = (0, convertToDate_1.convertToDate)(val);
+    if (n_val === null)
         throw new TypeError('setTimeUTC requires a date object');
-    return new Date(Date.UTC(val.getUTCFullYear(), val.getUTCMonth(), val.getUTCDate(), (0, isIntegerBetween_1.isIntegerBetween)(props?.hour, 0, 23) ? props.hour : val.getUTCHours(), (0, isIntegerBetween_1.isIntegerBetween)(props?.minute, 0, 59) ? props?.minute : val.getUTCMinutes(), (0, isIntegerBetween_1.isIntegerBetween)(props?.second, 0, 59) ? props?.second : val.getUTCSeconds(), (0, isIntegerBetween_1.isIntegerBetween)(props?.millisecond, 0, 999) ? props?.millisecond : val.getUTCMilliseconds()));
+    const { hour, minute, second, millisecond } = props || {};
+    return new Date(Date.UTC(n_val.getUTCFullYear(), n_val.getUTCMonth(), n_val.getUTCDate(), (0, isIntegerBetween_1.isIntegerBetween)(hour, 0, 23) ? hour : n_val.getUTCHours(), (0, isIntegerBetween_1.isIntegerBetween)(minute, 0, 59) ? minute : n_val.getUTCMinutes(), (0, isIntegerBetween_1.isIntegerBetween)(second, 0, 59) ? second : n_val.getUTCSeconds(), (0, isIntegerBetween_1.isIntegerBetween)(millisecond, 0, 999) ? millisecond : n_val.getUTCMilliseconds()));
 }

package/date/startOfUTC.d.ts

@@ -2,8 +2,8 @@ export type StartOfUTCKey = 'year' | 'quarter' | 'month' | 'week' | 'week_sun' |
 /**
  * Sets the provided date to start of UTC of provided key
  *
- * @param {Date} val - Date to set to start of
+ * @param {Date|string} val - Date to set to start of
  * @param {StartOfUTCKey} key - (default='millisecond') Key to set
  */
-declare function startOfUTC(val: Date, key?: StartOfUTCKey): Date;
+declare function startOfUTC(val: Date | string, key?: StartOfUTCKey): Date;
 export { startOfUTC, startOfUTC as default };

package/date/startOfUTC.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.startOfUTC = startOfUTC;
 exports.default = startOfUTC;
-const is_1 = require("./is");
+const convertToDate_1 = require("./convertToDate");
 const WEEK_START = new Map([
     ['week', 1],
     ['week_sun', 0],
@@ -14,17 +14,19 @@ const WEEK_START = new Map([
     ['week_sat', 6],
 ]);
 function startOfUTC(val, key = 'millisecond') {
-    if (!(0, is_1.isDate)(val))
+    const n_val = (0, convertToDate_1.convertToDate)(val);
+    if (n_val === null)
         throw new TypeError('startOfUTC requires a date object');
+    const year = n_val.getUTCFullYear();
     switch (key) {
         case 'year':
-            return new Date(Date.UTC(val.getUTCFullYear(), 0, 1, 0, 0, 0, 0));
+            return new Date(Date.UTC(year, 0));
         case 'quarter': {
-            const UTC_MONTH = val.getUTCMonth();
-            return new Date(Date.UTC(val.getUTCFullYear(), UTC_MONTH - (UTC_MONTH % 3), 1, 0, 0, 0, 0));
+            const UTC_MONTH = n_val.getUTCMonth();
+            return new Date(Date.UTC(year, UTC_MONTH - (UTC_MONTH % 3)));
         }
         case 'month':
-            return new Date(Date.UTC(val.getUTCFullYear(), val.getUTCMonth(), 1, 0, 0, 0, 0));
+            return new Date(Date.UTC(year, n_val.getUTCMonth()));
         case 'week':
         case 'week_sun':
         case 'week_mon':
@@ -33,19 +35,19 @@ function startOfUTC(val, key = 'millisecond') {
         case 'week_thu':
         case 'week_fri':
         case 'week_sat': {
-            const UTC_DAY = val.getUTCDay();
+            const UTC_DAY = n_val.getUTCDay();
             const UTC_SOD = WEEK_START.get(key);
-            return new Date(Date.UTC(val.getUTCFullYear(), val.getUTCMonth(), val.getUTCDate() - (UTC_DAY < UTC_SOD ? (7 - UTC_SOD) + UTC_DAY : UTC_DAY - UTC_SOD), 0, 0, 0, 0));
+            return new Date(Date.UTC(year, n_val.getUTCMonth(), n_val.getUTCDate() - (UTC_DAY < UTC_SOD ? (7 - UTC_SOD) + UTC_DAY : UTC_DAY - UTC_SOD)));
         }
         case 'day':
-            return new Date(Date.UTC(val.getUTCFullYear(), val.getUTCMonth(), val.getUTCDate(), 0, 0, 0, 0));
+            return new Date(Date.UTC(year, n_val.getUTCMonth(), n_val.getUTCDate()));
         case 'hour':
-            return new Date(Date.UTC(val.getUTCFullYear(), val.getUTCMonth(), val.getUTCDate(), val.getUTCHours(), 0, 0, 0));
+            return new Date(Date.UTC(year, n_val.getUTCMonth(), n_val.getUTCDate(), n_val.getUTCHours()));
         case 'minute':
-            return new Date(Date.UTC(val.getUTCFullYear(), val.getUTCMonth(), val.getUTCDate(), val.getUTCHours(), val.getUTCMinutes(), 0, 0));
+            return new Date(Date.UTC(year, n_val.getUTCMonth(), n_val.getUTCDate(), n_val.getUTCHours(), n_val.getUTCMinutes()));
         case 'second':
-            return new Date(Date.UTC(val.getUTCFullYear(), val.getUTCMonth(), val.getUTCDate(), val.getUTCHours(), val.getUTCMinutes(), val.getUTCSeconds(), 0));
+            return new Date(Date.UTC(year, n_val.getUTCMonth(), n_val.getUTCDate(), n_val.getUTCHours(), n_val.getUTCMinutes(), n_val.getUTCSeconds()));
         default:
-            return new Date(Date.UTC(val.getUTCFullYear(), val.getUTCMonth(), val.getUTCDate(), val.getUTCHours(), val.getUTCMinutes(), val.getUTCSeconds(), val.getUTCMilliseconds()));
+            return new Date(Date.UTC(year, n_val.getUTCMonth(), n_val.getUTCDate(), n_val.getUTCHours(), n_val.getUTCMinutes(), n_val.getUTCSeconds(), n_val.getUTCMilliseconds()));
     }
 }

package/formdata/toObject.d.ts

@@ -2,7 +2,11 @@ type toObjectConfig = {
     /**
      * Pass array of keys that should not be normalized into number/bool when seen
      */
-    raw?: string[];
+    raw?: string[] | true;
+    /**
+     * Pass array of keys that should only have a single value (e.g., 'action')
+     */
+    single?: string[];
 };
 /**
  * Converts a FormData instance to a json object

package/formdata/toObject.js

@@ -3,13 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.toObject = toObject;
 exports.default = toObject;
 const RGX_CLOSE = /\]/g;
-function assignValue(acc, rawkey, value) {
+function assignValue(acc, rawkey, value, single) {
     let cursor = acc;
     const keys = rawkey.replace(RGX_CLOSE, '').split(/\[|\./);
     for (let i = 0; i < keys.length; i++) {
         const key = keys[i];
         if (i === keys.length - 1) {
-            if (cursor[key] !== undefined) {
+            if (cursor[key] !== undefined && (!single || !single.has(key))) {
                 if (Array.isArray(cursor[key])) {
                     cursor[key].push(value);
                 }
@@ -38,11 +38,12 @@ function assignValue(acc, rawkey, value) {
 function toObject(form, config) {
     if (!(form instanceof FormData))
         throw new Error('formdata/toObject: Value is not an instance of FormData');
-    const set = new Set(Array.isArray(config?.raw) ? config.raw : []);
+    const set = config?.raw === true ? true : new Set(Array.isArray(config?.raw) ? config?.raw : []);
+    const single = Array.isArray(config?.single) && config?.single.length ? new Set(config.single) : null;
     const acc = {};
     form.forEach((value, key) => {
         let normalizedValue = value;
-        if (typeof value === 'string' && !set.has(key)) {
+        if (set !== true && typeof value === 'string' && !set.has(key)) {
             const lower = value.toLowerCase();
             normalizedValue = (lower === 'true'
                 ? true
@@ -52,7 +53,7 @@ function toObject(form, config) {
                         ? Number(value)
                         : value);
         }
-        assignValue(acc, key, normalizedValue);
+        assignValue(acc, key, normalizedValue, single);
     });
     return acc;
 }

package/hash/fnv1A.d.ts

@@ -1,3 +1,5 @@
+export declare const FNV_32 = 2166136261;
+export declare const FNV_64 = 1099511628211;
 /**
  * Convert a provided value into a Fowler-Noll-Vo 1A hash
  * For more info: https://tools.ietf.org/html/draft-eastlake-fnv-03

package/hash/fnv1A.js

@@ -1,14 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.FNV_64 = exports.FNV_32 = void 0;
 exports.fnv1A = fnv1A;
 exports.default = fnv1A;
-const FNV_32 = 2166136261;
+exports.FNV_32 = 2166136261;
+exports.FNV_64 = 1099511628211;
 const REPL_NAN = 'nan';
 const REPL_TRUE = 'true';
 const REPL_FALSE = 'false';
 const REPL_UNDEF = 'undefined';
 const REPL_NULL = 'null';
-function fnv1A(data, offset = FNV_32) {
+function fnv1A(data, offset = exports.FNV_32) {
     let hash = offset;
     let sanitized;
     switch (typeof data) {

package/index.d.ts

@@ -66,7 +66,7 @@ declare module "array/mapPrimitive" {
     export { mapPrimitive, mapPrimitive as default };
 }
 declare module "object/isNotEmpty" {
-    function isNotEmptyObject(val: unknown): val is Record<string, any>;
+    function isNotEmptyObject<T extends Record<string, any>>(val: T | unknown): val is T;
     export { isNotEmptyObject, isNotEmptyObject as default };
 }
 declare module "array/groupBy" {
@@ -86,9 +86,7 @@ declare module "array/split" {
     export { split, split as default };
 }
 declare module "object/is" {
-    function isObject(val: unknown): val is {
-        [key: string]: any;
-    };
+    function isObject<T extends Record<string, any>>(val: T | unknown): val is T;
     export { isObject, isObject as default };
 }
 declare module "array/sort" {
@@ -129,19 +127,23 @@ declare module "date/is" {
     function isDate(val: unknown): val is Date;
     export { isDate, isDate as default };
 }
+declare module "date/convertToDate" {
+    function convertToDate(val: Date | string | number): Date | null;
+    export { convertToDate, convertToDate as default };
+}
 declare module "date/addUTC" {
     export type AddUTCKey = 'years' | 'year' | 'months' | 'month' | 'days' | 'day' | 'hours' | 'hour' | 'minutes' | 'minute' | 'seconds' | 'second' | 'milliseconds' | 'millisecond';
-    function addUTC(val: Date, amt?: number, key?: AddUTCKey): Date;
+    function addUTC(val: Date | string, amt?: number, key?: AddUTCKey): Date;
     export { addUTC, addUTC as default };
 }
 declare module "date/diff" {
     export type DiffKey = 'week' | 'weeks' | 'day' | 'days' | 'hour' | 'hours' | 'minute' | 'minutes' | 'second' | 'seconds' | 'millisecond' | 'milliseconds';
-    function diff(val_a: Date, val_b: Date, key?: DiffKey): number;
+    function diff(val_a: Date | string, val_b: Date | string, key?: DiffKey): number;
     export { diff, diff as default };
 }
 declare module "date/endOfUTC" {
     export type EndOfUTCKey = 'year' | 'quarter' | 'month' | 'week' | 'week_sun' | 'week_mon' | 'week_tue' | 'week_wed' | 'week_thu' | 'week_fri' | 'week_sat' | 'day' | 'hour' | 'minute' | 'second' | 'millisecond';
-    function endOfUTC(val: Date, key?: EndOfUTCKey): Date;
+    function endOfUTC(val: Date | string, key?: EndOfUTCKey): Date;
     export { endOfUTC, endOfUTC as default };
 }
 declare module "date/format" {
@@ -151,7 +153,7 @@ declare module "date/format" {
         readonly sat: "sat";
     };
     export type WEEK_START = keyof typeof WEEK_STARTS;
-    function format(val: Date, spec: string, locale?: string, zone?: string, sow?: WEEK_START): string;
+    function format(val: Date | string, spec: string, locale?: string, zone?: string, sow?: WEEK_START): string;
     namespace format {
         var getLocale: () => string;
         var setLocale: (locale: string) => void;
@@ -167,7 +169,7 @@ declare module "date/isFormat" {
     export { isDateFormat, isDateFormat as default };
 }
 declare module "date/isLeap" {
-    function isLeap(val: Date): boolean;
+    function isLeap(val: Date | string): boolean;
     export { isLeap, isLeap as default };
 }
 declare module "date/nowUnix" {
@@ -189,12 +191,12 @@ declare module "date/setTimeUTC" {
         second?: number;
         millisecond?: number;
     };
-    function setTimeUTC(val: Date, props: TimeProps): Date;
+    function setTimeUTC(val: Date | string, props: TimeProps): Date;
     export { setTimeUTC, setTimeUTC as default };
 }
 declare module "date/startOfUTC" {
     export type StartOfUTCKey = 'year' | 'quarter' | 'month' | 'week' | 'week_sun' | 'week_mon' | 'week_tue' | 'week_wed' | 'week_thu' | 'week_fri' | 'week_sat' | 'day' | 'hour' | 'minute' | 'second' | 'millisecond';
-    function startOfUTC(val: Date, key?: StartOfUTCKey): Date;
+    function startOfUTC(val: Date | string, key?: StartOfUTCKey): Date;
     export { startOfUTC, startOfUTC as default };
 }
 declare module "date/toUnix" {
@@ -207,6 +209,7 @@ declare module "date/toUTC" {
 }
 declare module "date/index" {
     import { addUTC } from "date/addUTC";
+    import { convertToDate } from "date/convertToDate";
     import { diff } from "date/diff";
     import { endOfUTC } from "date/endOfUTC";
     import { format } from "date/format";
@@ -219,7 +222,7 @@ declare module "date/index" {
     import { startOfUTC } from "date/startOfUTC";
     import { toUnix } from "date/toUnix";
     import { toUTC } from "date/toUTC";
-    export { addUTC, diff, endOfUTC, format, isDateFormat as isFormat, isDateFormat, isDate, isDate as is, isLeap, nowUnix, nowUnixMs, setTimeUTC, startOfUTC, toUnix, toUTC };
+    export { addUTC, convertToDate, diff, endOfUTC, format, isDateFormat as isFormat, isDateFormat, isDate, isDate as is, isLeap, nowUnix, nowUnixMs, setTimeUTC, startOfUTC, toUnix, toUTC };
 }
 declare module "formdata/is" {
     function isFormData(val: unknown): val is FormData;
@@ -227,7 +230,8 @@ declare module "formdata/is" {
 }
 declare module "formdata/toObject" {
     type toObjectConfig = {
-        raw?: string[];
+        raw?: string[] | true;
+        single?: string[];
     };
     function toObject<T extends Record<string, unknown>>(form: FormData, config?: toObjectConfig): T;
     export { toObject, toObject as default };
@@ -328,9 +332,13 @@ declare module "object/pick" {
     type DottedKeys<T> = (T extends ObjectType ? {
         [K in keyof T & string]: T[K] extends ObjectType ? K | `${K}.${DottedKeys<T[K]>}` : K;
     }[keyof T & string] : string) & string;
-    function pick<T extends Record<string, any>, K extends DottedKeys<T>>(obj: T, keys: K[]): {
-        [key: string]: any;
-    };
+    type PickFromObject<T, K extends string> = K extends `${infer Key}.${infer Rest}` ? Key extends keyof T ? T[Key] extends ObjectType ? {
+        [P in Key]: PickFromObject<T[Key], Rest>;
+    } : object : object : K extends keyof T ? {
+        [P in K]: T[K];
+    } : object;
+    type UnionToIntersection<U> = (U extends any ? (k: U) => void : object) extends (k: infer I) => void ? I : object;
+    function pick<T extends Record<string, any>, K extends readonly DottedKeys<T>[]>(obj: T, keys: K): UnionToIntersection<PickFromObject<T, K[number]>>;
     export { pick, pick as default };
 }
 declare module "object/index" {
@@ -569,6 +577,8 @@ declare module "deep/index" {
     export { deepFreeze as freeze, deepFreeze, deepGet as get, deepGet, deepSeal as seal, deepSeal, deepSet as set, deepSet };
 }
 declare module "hash/fnv1A" {
+    export const FNV_32 = 2166136261;
+    export const FNV_64 = 1099511628211;
     function fnv1A(data: unknown, offset?: number): number;
     export { fnv1A, fnv1A as default };
 }

package/object/is.d.ts

@@ -3,7 +3,5 @@
  *
  * @param {unknown} val - Value to verify
  */
-declare function isObject(val: unknown): val is {
-    [key: string]: any;
-};
+declare function isObject<T extends Record<string, any>>(val: T | unknown): val is T;
 export { isObject, isObject as default };

package/object/isNotEmpty.d.ts

@@ -3,5 +3,5 @@
  *
  * @param {unknown} val - Value to verify
  */
-declare function isNotEmptyObject(val: unknown): val is Record<string, any>;
+declare function isNotEmptyObject<T extends Record<string, any>>(val: T | unknown): val is T;
 export { isNotEmptyObject, isNotEmptyObject as default };

package/object/pick.d.ts

@@ -4,13 +4,17 @@ type ObjectType = {
 type DottedKeys<T> = (T extends ObjectType ? {
     [K in keyof T & string]: T[K] extends ObjectType ? K | `${K}.${DottedKeys<T[K]>}` : K;
 }[keyof T & string] : string) & string;
+type PickFromObject<T, K extends string> = K extends `${infer Key}.${infer Rest}` ? Key extends keyof T ? T[Key] extends ObjectType ? {
+    [P in Key]: PickFromObject<T[Key], Rest>;
+} : object : object : K extends keyof T ? {
+    [P in K]: T[K];
+} : object;
+type UnionToIntersection<U> = (U extends any ? (k: U) => void : object) extends (k: infer I) => void ? I : object;
 /**
  * Returns a new object with the keys picked from the passed object
  *
  * @param obj - Object to pick from
  * @param keys - Array of keys to pick from object
  */
-declare function pick<T extends Record<string, any>, K extends DottedKeys<T>>(obj: T, keys: K[]): {
-    [key: string]: any;
-};
+declare function pick<T extends Record<string, any>, K extends readonly DottedKeys<T>[]>(obj: T, keys: K): UnionToIntersection<PickFromObject<T, K[number]>>;
 export { pick, pick as default };

package/object/pick.js

@@ -16,24 +16,24 @@ function pick(obj, keys) {
         if (typeof key !== 'string')
             continue;
         sanitized = key.trim();
-        if (!sanitized.length)
+        if (!sanitized)
             continue;
         if (sanitized.indexOf('.') >= 0) {
             val = (0, get_1.deepGet)(obj, sanitized);
             if (val === undefined)
                 continue;
-            const parts = key.split('.');
+            const parts = sanitized.split('.');
             const parts_len = parts.length;
             let cursor = map;
             for (let y = 0; y < parts_len - 1; y++) {
                 const part = parts[y].trim();
-                if (!cursor[part])
+                if (!(part in cursor))
                     cursor[part] = {};
                 cursor = cursor[part];
             }
             cursor[parts[parts_len - 1].trim()] = val;
         }
-        else if (obj[sanitized] !== undefined) {
+        else if (sanitized in obj) {
             map[sanitized] = obj[sanitized];
         }
     }

package/package.json

@@ -1 +1 @@
-{ "name": "@valkyriestudios/utils", "version": "12.22.0", "description": "A collection of single-function utilities for common tasks", "author": { "name": "Peter Vermeulen", "url": "https://www.linkedin.com/in/petervermeulen1/" }, "keywords": [ "utility", "library", "javascript", "js", "node", "bun" ], "license": "MIT", "repository": { "type": "git", "url": "git+https://github.com/ValkyrieStudios/utils.git" }, "bugs": { "url": "https://github.com/ValkyrieStudios/utils/issues" }, "homepage": "https://github.com/ValkyrieStudios/utils#readme", "types": "index.d.ts" }
+{ "name": "@valkyriestudios/utils", "version": "12.24.0", "description": "A collection of single-function utilities for common tasks", "author": { "name": "Peter Vermeulen", "url": "https://www.linkedin.com/in/petervermeulen1/" }, "keywords": [ "utility", "library", "javascript", "js", "node", "bun" ], "license": "MIT", "repository": { "type": "git", "url": "git+https://github.com/ValkyrieStudios/utils.git" }, "bugs": { "url": "https://github.com/ValkyrieStudios/utils/issues" }, "homepage": "https://github.com/ValkyrieStudios/utils#readme", "types": "index.d.ts" }