@splendidlabz/utils 1.6.0 → 1.8.1

package/dist/esm/lib/date/index.js

@@ -0,0 +1,173 @@
+// src/lib/date/days.js
+var DAYS = [
+  { short: "Sun", long: "Sunday", numeric: 1 },
+  { short: "Mon", long: "Monday", numeric: 2 },
+  { short: "Tue", long: "Tuesday", numeric: 3 },
+  { short: "Wed", long: "Wednesday", numeric: 4 },
+  { short: "Thu", long: "Thursday", numeric: 5 },
+  { short: "Fri", long: "Friday", numeric: 6 },
+  { short: "Sat", long: "Saturday", numeric: 7 }
+];
+
+// src/lib/date/months.js
+var MONTHS = [
+  {
+    long: "January",
+    short: "jan",
+    numeric: 1,
+    lastDay: { default: 31, leapYear: 31 }
+  },
+  {
+    long: "February",
+    short: "feb",
+    numeric: 2,
+    lastDay: { default: 28, leapYear: 29 }
+  },
+  {
+    long: "March",
+    short: "mar",
+    numeric: 3,
+    lastDay: { default: 31, leapYear: 31 }
+  },
+  {
+    long: "April",
+    short: "apr",
+    numeric: 4,
+    lastDay: { default: 30, leapYear: 30 }
+  },
+  {
+    long: "May",
+    short: "may",
+    numeric: 5,
+    lastDay: { default: 31, leapYear: 31 }
+  },
+  {
+    long: "June",
+    short: "jun",
+    numeric: 6,
+    lastDay: { default: 30, leapYear: 30 }
+  },
+  {
+    long: "July",
+    short: "jul",
+    numeric: 7,
+    lastDay: { default: 31, leapYear: 31 }
+  },
+  {
+    long: "August",
+    short: "aug",
+    numeric: 8,
+    lastDay: { default: 31, leapYear: 31 }
+  },
+  {
+    long: "September",
+    short: "sep",
+    numeric: 9,
+    lastDay: { default: 30, leapYear: 30 }
+  },
+  {
+    long: "October",
+    short: "oct",
+    numeric: 10,
+    lastDay: { default: 31, leapYear: 31 }
+  },
+  {
+    long: "November",
+    short: "nov",
+    numeric: 11,
+    lastDay: { default: 30, leapYear: 30 }
+  },
+  {
+    long: "December",
+    short: "dec",
+    numeric: 12,
+    lastDay: { default: 31, leapYear: 31 }
+  }
+];
+
+// src/lib/numbers/index.js
+function splitUnit(string) {
+  if (typeof string === "number") return [string, null];
+  const regex = /(-?\d*\.?\d+)\s*([a-z]+)/i;
+  const match = string.match(regex);
+  if (match) return [parseFloat(match[1]), match[2]];
+  return [parseFloat(string), null];
+}
+
+// src/lib/date/time.js
+function ms(arg) {
+  const [value, unit] = splitUnit(arg);
+  if (unit === "d") return getTimeInMs(value, "days");
+  if (unit === "day") return getTimeInMs(value, "days");
+  if (unit === "days") return getTimeInMs(value, "days");
+  if (unit === "h") return getTimeInMs(value, "hours");
+  if (unit === "hr") return getTimeInMs(value, "hours");
+  if (unit === "hour") return getTimeInMs(value, "hours");
+  if (unit === "hours") return getTimeInMs(value, "hours");
+  if (unit === "m") return getTimeInMs(value, "minutes");
+  if (unit === "min") return getTimeInMs(value, "minutes");
+  if (unit === "mins") return getTimeInMs(value, "minutes");
+  if (unit === "minute") return getTimeInMs(value, "minutes");
+  if (unit === "minutes") return getTimeInMs(value, "minutes");
+  if (unit === "s") return getTimeInMs(value, "seconds");
+  if (unit === "sec") return getTimeInMs(value, "seconds");
+  if (unit === "secs") return getTimeInMs(value, "seconds");
+  if (unit === "second") return getTimeInMs(value, "seconds");
+  if (unit === "seconds") return getTimeInMs(value, "seconds");
+  return value;
+}
+function getTimeInMs(value, unit = "ms") {
+  switch (unit) {
+    case "ms":
+      return value;
+    case "seconds":
+      return value * 1e3;
+    case "minutes":
+      return value * 1e3 * 60;
+    case "hours":
+      return value * 1e3 * 60 * 60;
+    case "days":
+      return value * 1e3 * 60 * 60 * 24;
+    case "weeks":
+      return value * 1e3 * 60 * 60 * 24 * 7;
+  }
+}
+function toWeeks(ms2) {
+  return ms2 / 1e3 / 60 / 60 / 24 / 7;
+}
+function toDays(ms2) {
+  return ms2 / 1e3 / 60 / 60 / 24;
+}
+function toHours(ms2) {
+  return ms2 / 1e3 / 60 / 60;
+}
+function toMinutes(ms2) {
+  return ms2 / 1e3 / 60;
+}
+function toSeconds(ms2) {
+  return ms2 / 1e3;
+}
+function toReadableTime(ms2) {
+  const weekMs = 1e3 * 60 * 60 * 24 * 7;
+  const dayMs = 1e3 * 60 * 60 * 24;
+  const hourMs = 1e3 * 60 * 60;
+  const minuteMs = 1e3 * 60;
+  const weeks = Math.floor(ms2 / weekMs);
+  const days = Math.floor(ms2 % weekMs / dayMs);
+  const hours = Math.floor(ms2 % dayMs / hourMs);
+  const minutes = Math.floor(ms2 % hourMs / minuteMs);
+  const seconds = Math.floor(ms2 % minuteMs / 1e3);
+  return { weeks, days, hours, minutes, seconds };
+}
+export {
+  DAYS,
+  MONTHS,
+  getTimeInMs,
+  ms,
+  toDays,
+  toHours,
+  toMinutes,
+  toReadableTime,
+  toSeconds,
+  toWeeks
+};

package/dist/esm/lib/date/months.js

@@ -0,0 +1,78 @@
+// src/lib/date/months.js
+var MONTHS = [
+  {
+    long: "January",
+    short: "jan",
+    numeric: 1,
+    lastDay: { default: 31, leapYear: 31 }
+  },
+  {
+    long: "February",
+    short: "feb",
+    numeric: 2,
+    lastDay: { default: 28, leapYear: 29 }
+  },
+  {
+    long: "March",
+    short: "mar",
+    numeric: 3,
+    lastDay: { default: 31, leapYear: 31 }
+  },
+  {
+    long: "April",
+    short: "apr",
+    numeric: 4,
+    lastDay: { default: 30, leapYear: 30 }
+  },
+  {
+    long: "May",
+    short: "may",
+    numeric: 5,
+    lastDay: { default: 31, leapYear: 31 }
+  },
+  {
+    long: "June",
+    short: "jun",
+    numeric: 6,
+    lastDay: { default: 30, leapYear: 30 }
+  },
+  {
+    long: "July",
+    short: "jul",
+    numeric: 7,
+    lastDay: { default: 31, leapYear: 31 }
+  },
+  {
+    long: "August",
+    short: "aug",
+    numeric: 8,
+    lastDay: { default: 31, leapYear: 31 }
+  },
+  {
+    long: "September",
+    short: "sep",
+    numeric: 9,
+    lastDay: { default: 30, leapYear: 30 }
+  },
+  {
+    long: "October",
+    short: "oct",
+    numeric: 10,
+    lastDay: { default: 31, leapYear: 31 }
+  },
+  {
+    long: "November",
+    short: "nov",
+    numeric: 11,
+    lastDay: { default: 30, leapYear: 30 }
+  },
+  {
+    long: "December",
+    short: "dec",
+    numeric: 12,
+    lastDay: { default: 31, leapYear: 31 }
+  }
+];
+export {
+  MONTHS
+};

package/dist/esm/lib/date/time.js

@@ -0,0 +1,84 @@
+// src/lib/numbers/index.js
+function splitUnit(string) {
+  if (typeof string === "number") return [string, null];
+  const regex = /(-?\d*\.?\d+)\s*([a-z]+)/i;
+  const match = string.match(regex);
+  if (match) return [parseFloat(match[1]), match[2]];
+  return [parseFloat(string), null];
+}
+
+// src/lib/date/time.js
+function ms(arg) {
+  const [value, unit] = splitUnit(arg);
+  if (unit === "d") return getTimeInMs(value, "days");
+  if (unit === "day") return getTimeInMs(value, "days");
+  if (unit === "days") return getTimeInMs(value, "days");
+  if (unit === "h") return getTimeInMs(value, "hours");
+  if (unit === "hr") return getTimeInMs(value, "hours");
+  if (unit === "hour") return getTimeInMs(value, "hours");
+  if (unit === "hours") return getTimeInMs(value, "hours");
+  if (unit === "m") return getTimeInMs(value, "minutes");
+  if (unit === "min") return getTimeInMs(value, "minutes");
+  if (unit === "mins") return getTimeInMs(value, "minutes");
+  if (unit === "minute") return getTimeInMs(value, "minutes");
+  if (unit === "minutes") return getTimeInMs(value, "minutes");
+  if (unit === "s") return getTimeInMs(value, "seconds");
+  if (unit === "sec") return getTimeInMs(value, "seconds");
+  if (unit === "secs") return getTimeInMs(value, "seconds");
+  if (unit === "second") return getTimeInMs(value, "seconds");
+  if (unit === "seconds") return getTimeInMs(value, "seconds");
+  return value;
+}
+function getTimeInMs(value, unit = "ms") {
+  switch (unit) {
+    case "ms":
+      return value;
+    case "seconds":
+      return value * 1e3;
+    case "minutes":
+      return value * 1e3 * 60;
+    case "hours":
+      return value * 1e3 * 60 * 60;
+    case "days":
+      return value * 1e3 * 60 * 60 * 24;
+    case "weeks":
+      return value * 1e3 * 60 * 60 * 24 * 7;
+  }
+}
+function toWeeks(ms2) {
+  return ms2 / 1e3 / 60 / 60 / 24 / 7;
+}
+function toDays(ms2) {
+  return ms2 / 1e3 / 60 / 60 / 24;
+}
+function toHours(ms2) {
+  return ms2 / 1e3 / 60 / 60;
+}
+function toMinutes(ms2) {
+  return ms2 / 1e3 / 60;
+}
+function toSeconds(ms2) {
+  return ms2 / 1e3;
+}
+function toReadableTime(ms2) {
+  const weekMs = 1e3 * 60 * 60 * 24 * 7;
+  const dayMs = 1e3 * 60 * 60 * 24;
+  const hourMs = 1e3 * 60 * 60;
+  const minuteMs = 1e3 * 60;
+  const weeks = Math.floor(ms2 / weekMs);
+  const days = Math.floor(ms2 % weekMs / dayMs);
+  const hours = Math.floor(ms2 % dayMs / hourMs);
+  const minutes = Math.floor(ms2 % hourMs / minuteMs);
+  const seconds = Math.floor(ms2 % minuteMs / 1e3);
+  return { weeks, days, hours, minutes, seconds };
+}
+export {
+  getTimeInMs,
+  ms,
+  toDays,
+  toHours,
+  toMinutes,
+  toReadableTime,
+  toSeconds,
+  toWeeks
+};

package/dist/esm/lib/form/form-data.js

@@ -0,0 +1,58 @@
+// src/lib/form/form-data.js
+function formDataToObject(formData) {
+  const obj = {};
+  for (let [key, value] of formData) {
+    if (typeof value === "string") value = value.trim();
+    if (key.includes("[]")) {
+      const arrayKey = key.replace("[]", "");
+      if (!obj[arrayKey]) obj[arrayKey] = [];
+      obj[arrayKey].push(value);
+    } else {
+      obj[key] = value;
+    }
+  }
+  return obj;
+}
+function flattenArrayFields(inputObject) {
+  const result = {};
+  for (const [key, value] of Object.entries(inputObject)) {
+    const match = key.match(/^(\w+)(?:\[(\d+)\])?(?:\[(\w+)\])?$/);
+    if (match) {
+      const [, baseKey, index, property] = match;
+      if (index !== void 0) {
+        if (!result[baseKey]) result[baseKey] = [];
+        const arrayIndex = parseInt(index);
+        if (!result[baseKey][arrayIndex]) result[baseKey][arrayIndex] = {};
+        if (property) {
+          result[baseKey][arrayIndex][property] = value;
+        } else {
+          result[baseKey][arrayIndex] = value;
+        }
+      } else if (property) {
+        if (!result[baseKey]) result[baseKey] = {};
+        result[baseKey][property] = value;
+      } else {
+        result[key] = value;
+      }
+    } else {
+      result[key] = value;
+    }
+  }
+  for (const key in result) {
+    if (typeof result[key] === "object" && result[key] !== null) {
+      if (Object.keys(result[key]).every((k) => !isNaN(parseInt(k)))) {
+        result[key] = Object.values(result[key]).filter((item) => {
+          if (typeof item === "object") {
+            return Object.values(item).some((v) => v !== "");
+          }
+          return item !== "";
+        });
+      }
+    }
+  }
+  return result;
+}
+export {
+  flattenArrayFields,
+  formDataToObject
+};

package/dist/esm/lib/form/index.js

@@ -0,0 +1,92 @@
+// src/lib/form/form-data.js
+function formDataToObject(formData) {
+  const obj = {};
+  for (let [key, value] of formData) {
+    if (typeof value === "string") value = value.trim();
+    if (key.includes("[]")) {
+      const arrayKey = key.replace("[]", "");
+      if (!obj[arrayKey]) obj[arrayKey] = [];
+      obj[arrayKey].push(value);
+    } else {
+      obj[key] = value;
+    }
+  }
+  return obj;
+}
+function flattenArrayFields(inputObject) {
+  const result = {};
+  for (const [key, value] of Object.entries(inputObject)) {
+    const match = key.match(/^(\w+)(?:\[(\d+)\])?(?:\[(\w+)\])?$/);
+    if (match) {
+      const [, baseKey, index, property] = match;
+      if (index !== void 0) {
+        if (!result[baseKey]) result[baseKey] = [];
+        const arrayIndex = parseInt(index);
+        if (!result[baseKey][arrayIndex]) result[baseKey][arrayIndex] = {};
+        if (property) {
+          result[baseKey][arrayIndex][property] = value;
+        } else {
+          result[baseKey][arrayIndex] = value;
+        }
+      } else if (property) {
+        if (!result[baseKey]) result[baseKey] = {};
+        result[baseKey][property] = value;
+      } else {
+        result[key] = value;
+      }
+    } else {
+      result[key] = value;
+    }
+  }
+  for (const key in result) {
+    if (typeof result[key] === "object" && result[key] !== null) {
+      if (Object.keys(result[key]).every((k) => !isNaN(parseInt(k)))) {
+        result[key] = Object.values(result[key]).filter((item) => {
+          if (typeof item === "object") {
+            return Object.values(item).some((v) => v !== "");
+          }
+          return item !== "";
+        });
+      }
+    }
+  }
+  return result;
+}
+
+// src/lib/form/sanitize.js
+function sanitize(value, options = {}) {
+  const { sanitizer, ...rest } = options;
+  if (!sanitizer) throw new Error("sanitizer function is required");
+  if (typeof value === "string") return sanitizer(value, rest);
+  if (Array.isArray(value)) return sanitizeArray(value, { sanitizer, ...rest });
+  if (value && typeof value === "object") {
+    return Object.fromEntries(
+      Object.entries(value).map(([key, val]) => [
+        key,
+        sanitize(val, { sanitizer, ...rest })
+      ])
+    );
+  }
+  return value;
+}
+function sanitizeArray(arr, { sanitizer, ...rest }) {
+  if (!sanitizer) throw new Error("sanitizer function is required");
+  return arr.map((item) => sanitize(item, { sanitizer, ...rest }));
+}
+function sanitizeObject(obj, { sanitizer, ...options } = {}) {
+  if (!sanitizer) throw new Error("sanitizer function is required");
+  if (Array.isArray(obj)) return sanitizeArray(obj, { sanitizer, ...options });
+  return Object.fromEntries(
+    Object.entries(obj).map(([key, value]) => [
+      key,
+      sanitize(value, { sanitizer, ...options })
+    ])
+  );
+}
+export {
+  flattenArrayFields,
+  formDataToObject,
+  sanitize,
+  sanitizeArray,
+  sanitizeObject
+};

package/dist/esm/lib/form/sanitize.js

@@ -0,0 +1,35 @@
+// src/lib/form/sanitize.js
+function sanitize(value, options = {}) {
+  const { sanitizer, ...rest } = options;
+  if (!sanitizer) throw new Error("sanitizer function is required");
+  if (typeof value === "string") return sanitizer(value, rest);
+  if (Array.isArray(value)) return sanitizeArray(value, { sanitizer, ...rest });
+  if (value && typeof value === "object") {
+    return Object.fromEntries(
+      Object.entries(value).map(([key, val]) => [
+        key,
+        sanitize(val, { sanitizer, ...rest })
+      ])
+    );
+  }
+  return value;
+}
+function sanitizeArray(arr, { sanitizer, ...rest }) {
+  if (!sanitizer) throw new Error("sanitizer function is required");
+  return arr.map((item) => sanitize(item, { sanitizer, ...rest }));
+}
+function sanitizeObject(obj, { sanitizer, ...options } = {}) {
+  if (!sanitizer) throw new Error("sanitizer function is required");
+  if (Array.isArray(obj)) return sanitizeArray(obj, { sanitizer, ...options });
+  return Object.fromEntries(
+    Object.entries(obj).map(([key, value]) => [
+      key,
+      sanitize(value, { sanitizer, ...options })
+    ])
+  );
+}
+export {
+  sanitize,
+  sanitizeArray,
+  sanitizeObject
+};

package/dist/esm/lib/functions/debounce.js

@@ -0,0 +1,19 @@
+// src/lib/functions/debounce.js
+function debounce(callback, wait, immediate = false) {
+  let timeout;
+  return function() {
+    const context = this;
+    const args = arguments;
+    const callNow = immediate && !timeout;
+    clearTimeout(timeout);
+    timeout = setTimeout(later, wait);
+    if (callNow) callback.apply(context, args);
+    function later() {
+      timeout = null;
+      if (!immediate) callback.apply(context, args);
+    }
+  };
+}
+export {
+  debounce
+};

package/dist/esm/lib/functions/env.js

@@ -0,0 +1,8 @@
+// src/lib/functions/env.js
+function getEnv() {
+  if (typeof window === "object") return "browser";
+  if (typeof global === "object") return "node";
+}
+export {
+  getEnv
+};

package/dist/esm/lib/functions/functional.js

@@ -0,0 +1,35 @@
+// src/lib/functions/functional.js
+function curry(fn) {
+  return function curried(...args) {
+    if (args.length >= fn.length) {
+      return fn.apply(this, args);
+    } else {
+      return function(...moreArgs) {
+        return curried.apply(this, args.concat(moreArgs));
+      };
+    }
+  };
+}
+function compose(...fns) {
+  return function(value) {
+    return fns.reduceRight((acc, fn) => fn(acc), value);
+  };
+}
+function pipe(...fns) {
+  return function(value) {
+    return fns.reduce((acc, fn) => fn(acc), value);
+  };
+}
+function times(fn, n) {
+  const result = [];
+  for (let i = 0; i < n; i++) {
+    result.push(fn(i));
+  }
+  return result;
+}
+export {
+  compose,
+  curry,
+  pipe,
+  times
+};

package/dist/esm/lib/functions/index.js

@@ -0,0 +1,87 @@
+// src/lib/functions/debounce.js
+function debounce(callback, wait2, immediate = false) {
+  let timeout2;
+  return function() {
+    const context = this;
+    const args = arguments;
+    const callNow = immediate && !timeout2;
+    clearTimeout(timeout2);
+    timeout2 = setTimeout(later, wait2);
+    if (callNow) callback.apply(context, args);
+    function later() {
+      timeout2 = null;
+      if (!immediate) callback.apply(context, args);
+    }
+  };
+}
+
+// src/lib/functions/env.js
+function getEnv() {
+  if (typeof window === "object") return "browser";
+  if (typeof global === "object") return "node";
+}
+
+// src/lib/functions/functional.js
+function curry(fn) {
+  return function curried(...args) {
+    if (args.length >= fn.length) {
+      return fn.apply(this, args);
+    } else {
+      return function(...moreArgs) {
+        return curried.apply(this, args.concat(moreArgs));
+      };
+    }
+  };
+}
+function compose(...fns) {
+  return function(value) {
+    return fns.reduceRight((acc, fn) => fn(acc), value);
+  };
+}
+function pipe(...fns) {
+  return function(value) {
+    return fns.reduce((acc, fn) => fn(acc), value);
+  };
+}
+function times(fn, n) {
+  const result = [];
+  for (let i = 0; i < n; i++) {
+    result.push(fn(i));
+  }
+  return result;
+}
+
+// src/lib/functions/throttle.js
+function throttle(callback, wait2) {
+  let lastCall = 0;
+  return function(...args) {
+    const now = (/* @__PURE__ */ new Date()).getTime();
+    if (now - lastCall >= wait2) {
+      callback(...args);
+      lastCall = now;
+    }
+  };
+}
+
+// src/lib/functions/timeout.js
+function timeout(wait2, callback) {
+  setTimeout(callback, wait2);
+}
+function delay(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function wait(ms) {
+  return delay(ms);
+}
+export {
+  compose,
+  curry,
+  debounce,
+  delay,
+  getEnv,
+  pipe,
+  throttle,
+  timeout,
+  times,
+  wait
+};

package/dist/esm/lib/functions/throttle.js

@@ -0,0 +1,14 @@
+// src/lib/functions/throttle.js
+function throttle(callback, wait) {
+  let lastCall = 0;
+  return function(...args) {
+    const now = (/* @__PURE__ */ new Date()).getTime();
+    if (now - lastCall >= wait) {
+      callback(...args);
+      lastCall = now;
+    }
+  };
+}
+export {
+  throttle
+};

package/dist/esm/lib/functions/timeout.js

@@ -0,0 +1,15 @@
+// src/lib/functions/timeout.js
+function timeout(wait2, callback) {
+  setTimeout(callback, wait2);
+}
+function delay(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function wait(ms) {
+  return delay(ms);
+}
+export {
+  delay,
+  timeout,
+  wait
+};