@splendidlabz/utils 1.11.3 → 1.11.5

package/dist/esm/dom/ui/scroll-container.js

@@ -0,0 +1,22 @@
+function findScrollContainer(element, direction = "both") {
+  if (!element) return;
+  let parent = element.parentElement;
+  while (parent) {
+    const { overflow, overflowX, overflowY } = getComputedStyle(parent);
+    if (direction === "both") {
+      if (overflow.includes("auto") || overflow.includes("scroll"))
+        return parent;
+    }
+    if (direction === "horizontal") {
+      if (overflowX === "auto" || overflowX === "scroll") return parent;
+    }
+    if (direction === "vertical") {
+      if (overflowY === "auto" || overflowY === "scroll") return parent;
+    }
+    parent = parent.parentElement;
+  }
+  return document.documentElement;
+}
+export {
+  findScrollContainer
+};

package/dist/esm/dom/ui/traverse-and-scramble.js

@@ -0,0 +1,25 @@
+function traverseAndScramble(node, { excludes = [] } = {}) {
+  if (node instanceof Element && excludes.some((selector) => node.matches(selector))) {
+    return;
+  }
+  node.childNodes.forEach((child) => {
+    if (child.nodeType === 3) {
+      child.nodeValue = scrambleText(child.nodeValue);
+    } else if (child.nodeType === 1 && child instanceof Element) {
+      traverseAndScramble(child, { excludes });
+    }
+  });
+}
+function scrambleText(text) {
+  return text.split("").map((char) => {
+    if (/^[A-Za-z0-9]$/.test(char)) {
+      const randomCharCode = Math.random() < 26 / 36 ? Math.floor(Math.random() * 26) + (char === char.toUpperCase() ? 65 : 97) : Math.floor(Math.random() * 10) + 48;
+      return String.fromCharCode(randomCharCode);
+    } else {
+      return char;
+    }
+  }).join("");
+}
+export {
+  traverseAndScramble
+};

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

@@ -0,0 +1,6 @@
+export * from "./item-position.js";
+export * from "./join.js";
+export * from "./shuffle.js";
+export * from "./sort.js";
+export * from "./split-array.js";
+export * from "./unique.js";

package/dist/esm/lib/arrays/item-position.js

@@ -0,0 +1,15 @@
+function last(array, index) {
+  console.warn("last is deprecated. Use isLastItem instead.");
+  return index === array.length - 1;
+}
+function isLastItem(array, index) {
+  return index === array.length - 1;
+}
+function lastArrayItem(array) {
+  return array[array.length - 1];
+}
+export {
+  isLastItem,
+  last,
+  lastArrayItem
+};

package/dist/esm/lib/arrays/join.js

@@ -0,0 +1,12 @@
+import { lastArrayItem } from "./item-position.js";
+function joinWithConjunction(array, { conjunction = "and" } = {}) {
+  if (!array?.length) return "";
+  if (array.length === 1) return array[0];
+  if (array.length === 2) return `${array[0]} ${conjunction} ${array[1]}`;
+  const lastItem = lastArrayItem(array);
+  const rest = array.slice(0, -1);
+  return `${rest.join(", ")} ${conjunction} ${lastItem}`;
+}
+export {
+  joinWithConjunction
+};

package/dist/esm/lib/arrays/shuffle.js

@@ -0,0 +1,17 @@
+function shuffle(array) {
+  const clone = array.slice();
+  let currentIndex = array.length;
+  let temporaryValue;
+  let randomIndex;
+  while (currentIndex !== 0) {
+    randomIndex = Math.floor(Math.random() * currentIndex);
+    currentIndex -= 1;
+    temporaryValue = clone[currentIndex];
+    clone[currentIndex] = clone[randomIndex];
+    clone[randomIndex] = temporaryValue;
+  }
+  return clone;
+}
+export {
+  shuffle
+};

package/dist/esm/lib/arrays/sort.js

@@ -0,0 +1,36 @@
+import { getNestedValue } from "../objects/nested-property.js";
+function sort(array, { props = null, reverse = false } = {}) {
+  const clone = array.slice();
+  if (props === null) {
+    return clone.sort((a, b) => {
+      const comparison = compareValues(a, b);
+      return reverse ? -comparison : comparison;
+    });
+  }
+  const properties = Array.isArray(props) ? props : [props];
+  return clone.sort((a, b) => {
+    for (const property of properties) {
+      const aValue = getNestedValue(a, property);
+      const bValue = getNestedValue(b, property);
+      if (aValue === bValue) continue;
+      if (aValue == null) return 1;
+      if (bValue == null) return -1;
+      const comparison = compareValues(aValue, bValue);
+      return reverse ? -comparison : comparison;
+    }
+    return 0;
+  });
+}
+function compareValues(a, b) {
+  if (typeof a === "number" && typeof b === "number") return a - b;
+  if (typeof a === "string" && typeof b === "string") return a.localeCompare(b);
+  const aDate = new Date(a);
+  const bDate = new Date(b);
+  const aTime = aDate.getTime();
+  const bTime = bDate.getTime();
+  if (!isNaN(aTime) && !isNaN(bTime)) return aTime - bTime;
+  return String(a).localeCompare(String(b));
+}
+export {
+  sort
+};

package/dist/esm/lib/arrays/split-array.js

@@ -0,0 +1,16 @@
+function splitArray(array, predicate) {
+  const ret = {
+    picked: [],
+    omitted: []
+  };
+  array.forEach((item, index, arr) => {
+    if (predicate(item, index, arr)) ret.picked.push(item);
+    else ret.omitted.push(item);
+  });
+  ret.p = ret.picked;
+  ret.o = ret.omitted;
+  return ret;
+}
+export {
+  splitArray
+};

package/dist/esm/lib/arrays/unique.js

@@ -0,0 +1,6 @@
+function uniqueArray(array) {
+  return Array.from(new Set(array));
+}
+export {
+  uniqueArray
+};

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

@@ -0,0 +1 @@
+export * from "./route-manager.js";

package/dist/esm/lib/auth/route-manager.js

@@ -0,0 +1,25 @@
+function RouteManager(config) {
+  const { protectedRoutes, bypassRoutes } = config;
+  return {
+    isProtectedRoute(pathname) {
+      return isMatch(protectedRoutes, pathname);
+    },
+    isBypassRoute(pathname) {
+      return isMatch(bypassRoutes, pathname);
+    }
+  };
+}
+function AuthManager(config) {
+  return RouteManager(config);
+}
+function isMatch(routeConfig, pathname) {
+  const { is, startsWith, includes } = routeConfig;
+  const isExactMatch = is && is.some((u) => pathname === u);
+  const startsWithMatch = startsWith && startsWith.some((u) => pathname.startsWith(u));
+  const includesMatch = includes && includes.some((u) => pathname.includes(u));
+  return isExactMatch || startsWithMatch || includesMatch;
+}
+export {
+  AuthManager,
+  RouteManager
+};

package/dist/esm/lib/checks.js

@@ -0,0 +1,34 @@
+function isObject(x) {
+  return typeof x === "object" && !Array.isArray(x) && x !== null;
+}
+function isArray(x) {
+  return Array.isArray(x);
+}
+function notObject(x) {
+  return !isObject(x);
+}
+function getType(x) {
+  if (typeof x === "string") return "string";
+  if (typeof x === "number") {
+    if (Number.isInteger(x)) return "integer";
+    return "float";
+  }
+  if (typeof x === "boolean") return "boolean";
+  if (typeof x === "function") return "function";
+  if (typeof x === "undefined") return "undefined";
+  if (typeof x === "symbol") return "symbol";
+  if (typeof x === "bigint") return "bigint";
+  if (Array.isArray(x)) return "array";
+  if (typeof x === "object") return "object";
+  return "unknown";
+}
+function isFunction(x) {
+  return typeof x === "function";
+}
+export {
+  getType,
+  isArray,
+  isFunction,
+  isObject,
+  notObject
+};

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

@@ -0,0 +1,12 @@
+const 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 }
+];
+export {
+  DAYS
+};

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

@@ -0,0 +1,3 @@
+export * from "./days.js";
+export * from "./months.js";
+export * from "./time.js";

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

@@ -0,0 +1,77 @@
+const 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,75 @@
+import { splitUnit } from "../numbers/index.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,57 @@
+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,2 @@
+export * from "./form-data.js";
+export * from "./sanitize.js";

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

@@ -0,0 +1,34 @@
+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/callback.js

@@ -0,0 +1,6 @@
+function runCallback(fn, ...data) {
+  if (typeof fn === "function") fn(data);
+}
+export {
+  runCallback
+};

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

@@ -0,0 +1,18 @@
+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,7 @@
+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,52 @@
+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 composeAsync(...fns) {
+  return async function(value) {
+    return fns.reduceRight(async (acc, fn) => {
+      const result = await acc;
+      return await fn(result);
+    }, value);
+  };
+}
+function pipe(...fns) {
+  return function(value) {
+    return fns.reduce((acc, fn) => fn(acc), value);
+  };
+}
+function pipeAsync(...fns) {
+  return async function(value) {
+    return fns.reduce(async (acc, fn) => {
+      const result = await acc;
+      return await fn(result);
+    }, value);
+  };
+}
+function times(fn, n) {
+  const result = [];
+  for (let i = 0; i < n; i++) {
+    result.push(fn(i));
+  }
+  return result;
+}
+export {
+  compose,
+  composeAsync,
+  curry,
+  pipe,
+  pipeAsync,
+  times
+};

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

@@ -0,0 +1,5 @@
+export * from "./debounce.js";
+export * from "./env.js";
+export * from "./functional.js";
+export * from "./throttle.js";
+export * from "./timeout.js";

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

@@ -0,0 +1,13 @@
+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,14 @@
+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
+};

package/dist/esm/lib/hash.js

@@ -0,0 +1,18 @@
+function isHashedValue(value, type = "sha256") {
+  if (typeof value !== "string") return null;
+  value = value.trim();
+  type = type.toLowerCase();
+  if (type === "sha256") {
+    return value.length === 64 && /^[a-fA-F0-9]{64}$/.test(value);
+  }
+  if (type === "sha1") {
+    return value.length === 40 && /^[a-fA-F0-9]{40}$/.test(value);
+  }
+  if (type === "md5") {
+    return value.length === 32 && /^[a-fA-F0-9]{32}$/.test(value);
+  }
+  return null;
+}
+export {
+  isHashedValue
+};

package/dist/esm/lib/index.js

@@ -0,0 +1,14 @@
+export * from "./arrays/index.js";
+export * from "./auth/index.js";
+export * from "./checks.js";
+export * from "./date/index.js";
+export * from "./form/index.js";
+export * from "./functions/index.js";
+export * from "./hash.js";
+export * from "./numbers/index.js";
+export * from "./objects/index.js";
+export * from "./promises/index.js";
+export * from "./sse.js";
+export * from "./strings/index.js";
+export * from "./style/index.js";
+export * from "./symbols/index.js";

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

@@ -0,0 +1,11 @@
+export * from "./math.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];
+}
+export {
+  splitUnit
+};